GENERATE_FLOOD_TOPOLOGY

Generate the in-memory topology required by flooding commands. This topology accounts for islands or holes.

Parameters

Does not accept parameters.

Purpose

Flooding commands work on a closed enclosure without requiring you to select its boundary lines individually: click inside the enclosure, and the command locates its boundary lines.

Flooding commands require an enclosure topology calculated before the flooding command runs to identify the enclosure containing the cursor. This command calculates that topology: it forms enclosures from all visible lines in the active drawing file and stores the result in memory as a temporary topology. It is not saved in the drawing file or added to loaded topologies.

Flooding commands are:

Command Menu option Action on selected enclosures
PUT_ATR_E Flooding/Add active codes Add active codes to boundary lines.
ADD_ACTIVE_CODES_AND_CENTROID Flooding/Add active codes and centroid... Add active codes to boundary lines and, optionally, a centroid.
EDIT_CODES_E Flooding/Edit codes... Add and remove boundary line codes using a dialog box.
DELETE_COD_E Flooding/Delete code... Delete a code from boundary lines.
CHNG_COD_E Flooding/Change codes Replace boundary line codes with the active code.
PUT_COD_ENCLOSURE_CENTROID — Add a code to boundary lines and insert centroid text.
SHOW_COD_F — Display boundary line codes on screen.
DRAW_E_F Flooding/Generate polygon Create a polygon from enclosure boundaries.
SEARCH_CENTROID_F Flooding/Search for centroid Center the view on the enclosure centroid.
COPY_CENTROID_F Flooding/Copy Centroid Copy an enclosure's centroid to other enclosures.
ZOOME_E Zooms/Zoom to extension of site (due to flooding) Fit the view to the enclosure extents.
SELECT_FLOOD Immediate/Select by flooding Send boundary lines to the active command.

If you run a flooding command without generating the topology first, it displays "No temporary topology is created", sounds an error tone, and ends. Menu options running these commands are disabled while no topology exists.

How enclosures are formed

  • The command forms enclosures only from visible lines in the active drawing file: lines with visible codes and, if unknown codes are visible, lines with codes not in the code table. Lines with all codes hidden do not form enclosures.
  • Points, texts, and other entities that are not lines do not form enclosures. Visible texts inside an enclosure are associated as centroids with the smallest enclosure containing them.
  • Topology nodes are line endpoints. Crossing lines do not close enclosures at the intersection unless they end there, even if they share a vertex. Before generating the topology, split lines with SPLIT_VISIBLES_LINES.
  • A dangling line that closes no enclosure does not form an enclosure by itself. To locate unconnected ends, use DETECT_NO_CONNECTED_VISIBLE_LINES.
  • An island (an enclosure surrounded by another) is a hole in the surrounding enclosure. Click inside the island to select it; click between the island and the exterior boundary to select the outer enclosure. Flooding commands also act on lines bounding holes in the selected enclosure.

Errors

If the topology cannot be formed, the command displays an error balloon titled "Topology", sounds an error tone, and preserves any previous temporary topology:

Message Cause
Detected lines with double points The first two or last two vertices of a visible line coincide in plan coordinates (duplicate points).
Entities detected with a single point A visible line has only one vertex.
There is not enough data There are no visible lines from which to form enclosures.

A single visible line with duplicate points or only one vertex prevents the topology from being formed, even if its code is not in the code table.

Lines with duplicate points or a single point are also added to the Tasks pane, one task per entity. Click a line's task to center the view on that line. If the Tasks pane's Empty automatically option is enabled, the command clears the pane before adding tasks.

Result

When the topology is formed, the command draws nothing and displays no message. Enclosures become visible when you run a flooding command: the enclosure containing the cursor is filled with semitransparent dark red, and pressing the data button fills the selected enclosure with red.

When to regenerate it

The topology is calculated when you run the command and is not updated when you edit the drawing. If you add, delete, or modify lines, or change which codes are enabled, run the command again. Each run replaces the previous temporary topology.

Unload it

Difference from GENERATE_FLOOD_TOPOLOGY_WITHOUT_ISLANDS

GENERATE_FLOOD_TOPOLOGY_WITHOUT_ISLANDS forms the same enclosures but does not assign holes to them: an enclosure surrounding an island includes the island's area, and a point inside the island is inside both enclosures.

Command characteristics

Command type Immediate command
Repeats automatically No
Menu option Flooding/Generate topology for flooding
Toolbar This command has no associated toolbar button
Extension DigiNG.OrdenesTopologia.dll
Implementation Native
Related variables No related variables
Related commands UNLOAD_FLOOD_TOPOLOGY
GENERATE_FLOOD_TOPOLOGY_WITHOUT_ISLANDS
Internal name