Classify Holes

Classify Holes runs RED's own Check for holes and explains the result. It separates real openings from seams you cannot fall through, groups the open edges into places, and names the brushes around each place with their position in the build order. Use it when Check for holes reports holes and you need to know which ones matter.

Where to find it

• Level›, Classify Holes (RF+), under RED's own hole commands
• RED+›, Classify Holes (RF+)

How to use it

1. Rebuild the geometry (Space). Classify Holes checks the compiled geometry. See Rebuild Geometry.
2. Open Classify Holes. It checks the level straight away.
3. Read the summary at the top of the window.
4. Select a place in the list. The line under the list names the brushes around it.
5. Click Go To, or double-click the place, to move the views to it.
6. Fix the brushes, rebuild the geometry, then click Refresh.

Leaks, weld gaps and T-junctions

RED's Check for holes marks every edge that no other face in the same room shares vertex for vertex. Classify Holes sorts those hole edges into three kinds:

The summary calls weld gap edges solid in space. Only leaks are listed. Weld gaps and T-junctions are counted in the summary. If every hole edge is a weld gap or a T-junction, the list is empty and the line under it says No leaks.

Places

Leak edges are grouped into places, because one gap usually has several open edges. Edges that share an end point are one place, and so are edges whose midpoints are within 4 units of each other.

Each row shows:

• the place number
• OPENING if the place is at least 1 unit across, or hairline if it is smaller
• the centre of the place, as x, y, z
• how far it spans, in units (its largest dimension)
• how many edges it has

The biggest places, by total edge length, come first.

The summary

If RED finds no holes, the summary says so and gives the number of room faces checked.

Otherwise it starts with RED's own result: the number of holes Check for holes reports (Found N holes) and the number of hole edges. It then splits the edges into weld gaps, T-junctions and leak edges, and says how many places the leaks make.

RED counts one hole for each chain of connected open edges, whatever their kind. The list only shows places made of leak edges, so the two numbers can differ. When they do, the summary says why:

• Fewer places than holes: seams and cracks are not listed, and holes within 4 units of each other are one place.
• More places than holes: a hole has edges that touch only through geometry the classifier does not follow.

If the level has no compiled geometry, the summary says No compiled geometry. Build Geometry first, then Refresh.

The detail line

The line under the list describes the selected place. It first names up to 12 brushes around it, nearest first, as uid N (build position M). The build position is the brush's place in the order RED builds brushes, counted from 0.

It then gives one of these verdicts:

• brushes have vertices ON this edge: two or more brushes meet here, so the hole comes from how they combine. The tool suggests moving one of these brushes earlier or later in the build order.
• NEAR MISS: one brush reaches the edge and the next nearest stops within a quarter of a unit of it. Snap Fix is available.
• GAP: only one brush reaches the edge and the next nearest stops further short. The brushes do not meet, and changing the build order will not close it.
• No brush vertex lies on this edge: RED+ could not match the place to a pair of brushes.

When no brush is near the place at all, the line instead reads No brush shares a vertex with this leak: and says the place is bounded by compiled geometry whose brush no longer has a matching vertex.

Snap Fix

Snap Fix is available only for a NEAR MISS place. For any other place it is greyed.

1. Select the place and click Snap Fix.
2. Confirm. The question names the brush. The message after the snap says how many vertices moved.
3. RED+ takes an undo snapshot. It then moves every vertex of that brush that lies within a quarter of a unit of an end of the leak onto that end point.
4. Rebuild the geometry and click Refresh. The hole closes only after the rebuild.

Edit›, Undo (Ctrl+Z) reverses the snap. Snap Fix moves vertices onto the neighbouring geometry, not onto the grid, and it never changes the build order. Apart from Snap Fix, Classify Holes does not change the level.

Go To, Refresh and Copy Report

• Go To moves all four views to the selected place. The Free Look view keeps its direction and stands back from the place, by 6 to 24 units depending on its size. The other views centre on it.
• Refresh runs RED's check again on the compiled geometry. After editing brushes, rebuild the geometry first, then click Refresh.
• Copy Report copies the summary and every place, with its detail line, to the clipboard as text.

The log

Every check also writes its result to the log, logs\RedPlusEditor.log in the RED+ folder:

• a line containing [RF+ Holes] RED: Found with RED's hole and edge counts and how the edges split into weld gaps, T-junctions and leak edges
• one line containing [RF+ Holes] place at for each place, biggest first, with its centre, its number of edges, their total length, its span and its verdict

The log keeps the positions after the window is closed or the list is cleared.

Working with the window open

• The window stays open while you work. You can step through the places with Go To, edit brushes, rebuild and click Refresh without closing it.
• Choosing the command again brings the open window to the front.
• The title bar shows the time of the last check.
• When you open another level or start a new one, the list is cleared and the summary reads A different level is open now. Press Refresh to check it.

RED's hole lines

Classify Holes runs RED's own Check for holes, so RED's hole lines appear in the views as they do after Level›, Check for holes. Use Level›, Remove hole check lines to clear them. To see the lines after every rebuild, see Rebuild Geometry.