Overview
An information node that outputs each region's area, center, bounding rectangle, edge contact, and neighboring IDs as Map data. It supplies numeric region data for wiring tasks such as placing decorations at region centers or changing processing based on area.
- Category: Generate / Region / Info
- Uses: inspecting regions numerically, driving downstream controls and conditions, and building placement or extraction logic from area and center positions
Usage tips
- Pass the
region_entriesoutput throughlist_maporlist_filterto use keys such asareaandcentroid_xdirectly in expressions—for example,area > 50to list only large regions. - If you need only a filtered result rather than numeric data,
region_filteris shorter. Use this node when you need the values themselves, such as center coordinates. - It is also useful for debugging: inspect the area distribution while tuning generation parameters.
Related nodes
list_map/list_filter— process the output listregion_filter— selects without exposing numeric dataregion_adjacency— information specialized for adjacencyregion_debug_preview— visual inspection
Output Map
Top level:
| Key | Type | Description |
|---|---|---|
width |
Int | Width of the RegionMap |
height |
Int | Height of the RegionMap |
region_count |
Int | Number of regions |
wrap_x |
Bool | Whether it wraps horizontally |
wrap_y |
Bool | Whether it wraps vertically |
regions |
List | Information for every region |
The main fields are also available as direct outputs for wiring.
| Output | Type | Contents |
|---|---|---|
region_entries |
List | Same entries as regions, directly connectable to List Map / List Filter |
region_count |
Int | Number of regions |
width / height |
Int | Pixel dimensions of the RegionMap |
Each Map in regions:
| Key | Type | Description |
|---|---|---|
id |
Int | Region ID |
area |
Int | Pixel area of the region |
centroid_x / centroid_y |
Float | Center of the region |
bbox_x / bbox_y |
Int | Top-left coordinate of the bounding rectangle |
bbox_width / bbox_height |
Int | Size of the bounding rectangle |
touches_left / touches_right |
Bool | Whether it touches the visible left/right edge |
touches_top / touches_bottom |
Bool | Whether it touches the visible top/bottom edge |
edge_touch |
Bool | Whether it touches any visible edge |
neighbor_count |
Int | Number of adjacent region IDs |
neighbors |
List | Adjacent region IDs |
Notes
Neighboring IDs account for wrap_x / wrap_y on the input RegionMap.
Edge-contact fields indicate contact with the visible canvas edge, not the tile's
wrapped connection.
How to use
Connect it after Region Cells, Region Merge Small, Region Split Islands, or another RegionMap producer to inspect the current region count, areas, and center positions.
This node does not generate an image. It extracts region attributes for downstream conditions and debugging.
Use it for the area and center of each region. Use Region Adjacency for detailed shared-edge counts between pairs, or Region Debug Preview to inspect IDs visually.