OOF2: The Manual

6.2.1. OOF.ActiveArea

Create and manipulate Active Areas.

Active Areas provide a mechanism for restricting the scope of OOF2 operations to a portion of a Microstructure. The Active Area is defined in terms of a set of pixels, called the active pixels. Pixel operations will be restricted to active pixels. Operations on Skeleton Nodes will be restricted to Nodes with positions inside active pixels. Active Skeleton Elements are defined as Elements with at least one active Node, and active Skeleton Segments are those with an active Node at either end. Thus active Elements and Nodes can extend outside the Active Area.

This menu contains commands for manipulating Active Areas. OOF2 maintains a list of previously used Active Areas, so it's possible to go back and reuse old areas. It's also possible to assign names to Active Areas to make it easier to store and recall them.

The GUI tools for manipulating Active Areas are on the Active Area Page.

[Caution] Caution

Not all OOF2 operations respect the Active Area. Most Skeleton and Microstructure operations do (such as element refinement or pixel selection), but most Image and Mesh operations do not.[15] In particular, none of the Undo or Redo commands pay any attention to Active Areas — they can change Microstructures or Skeletons in inactive regions.

Like pixel selections, Active Areas all belong to a particular Microstructure. Activating pixels in one Microstructure has no effect on pixels in another Microstructure. It's possible to Copy an Active Area from one Microstructure to another, though.

Figure 6.1 shows how the Active Area is used for pixels, Elements, Nodes, and Segments. When an Active Area is in use, the inactive pixels are dimmed in Image and Microstructure displays. The amount of dimming can be adjusted by editing the BitmapOverlayDisplayMethod in the graphics window.[16]

Figure 6.1. Active Area Examples

Active Area Examples

(a) A rectangular pixel selection is being made with the Pixel Selection toolbox on a circular active area. The inactive pixels are dimmed.

(b) Only the pixels within the active area have been selected, although the selection rectangle extended further in (a).

Active Area Examples

A Skeleton has been created, and its (c) Nodes, (d) Elements, and (e) Segments were selected using the Invert button in the Skeleton Selection toolbox. Note that the active Elements and Segments extend beyond the active area because they are active if they have at least one active Node.


Parent Menu: The Main OOF Menu

OOF.ActiveArea Commands

See Also



[15] Image modifications do not use the Active Area because they are mostly implemented by external libraries which don't know about OOF2 internal structures.

[16] If you want the dimming to apply to all Layers in the Canvas, move the Active Area layer to the top of the layer list with OOF.Graphics_n.Layer.Raise.To_Top. This will produce funny effects, such as partially dimming Elements that have both active and inactive Nodes.