-------------------------------------------
funct: cut_line <1=closed> -- cut closed contour w/list
-------------------------------------------
keyboard equivalent: none

The "AREA" button (lower middle) performs a
closed-line cut of the surface using the current
ordered list of surface marks.

This can be used to generate an ROI label.

N.B.: First, be sure to clear all current marks
on the surface with a R-click in the surface
display window.

N.B.: if you want to make a large, elaborate AREA
cut, it is better to divide it into a series of
LINE cuts, so you can UNDO if you click a stray
vertex (also good to save snapshot patches as you
go along).

Then, select a series of surface vertices by
left-clicking each in turn.  A middle-click on
any already-selected vertex will remove it from
the ordered list before the cut.  Clicking "AREA"
then disconnects edges intersecting the closed
polygon defined by the identified vertices
(implied last-to-first cut).

Use "UNDO" button to undo previous cut (tcl
funct: restore_ripflags 1).

Use "INIT" button to go back to the initial
read-in state of the surface, which may have
already had some hidden vertices (tcl funct:
restore_ripflags 2).

Use "ALL" button to show all vertices (tcl funct:
clear_ripflags).

If only one vertex is selected, "AREA" removes a
single vertex.

See "PTS" to more generally edit (cut/restore)
lists of single vertices.
