OOF2: The Manual

Name

OOF.Graphics_n.Toolbox.Select_Element.Circle — Drag to select elements within a circle.

Synopsis

OOF.Graphics_n.Toolbox.Select_Element.Circle(skeleton,points,shift,ctrl)

Details

  • Parent Menu: OOF.Graphics_n.Toolbox.Select_Element
  • Callback: function SkelSelectToolbox.selectCB in module ooflib.common.IO.genericselecttoolbox
  • Parameters:

    skeleton
    Type: The path to an existing Skeleton object.
    points
    Type: A list of Point objects.
    shift
    True for addition. Type: Boolean, 0 (false) or 1 (true).
    ctrl
    True for toggle. Type: Boolean, 0 (false) or 1 (true).

Description

CircleElementSelect is a selection method that selects Elements in response to a mouse click in the graphics window when the Skeleton Selection toolbox is active and is set to Element mode. It selects all Elements lying within a circle swept out by dragging the mouse, as shown in Figure 6.18. Click the mouse in the center of the circle and drag out along a radius. Only those Elements that are completely within the circle will be selected.

skeleton is the Skeleton from which the Elements are to be selected.

points is a list of Point objects. The first point in the list is the center of the circle, and the second point is a point on the circumference. Any other points in the list will be ignored.

The shift and ctrl parameters govern how the current selection (i.e, the set of Elements defined by this operation) is merged with the previous selection (the Elements already selected) to form a new selection, as shown in Table 6.1. They indicate whether (1) or not (0) the shift and control keys were depressed during the mouse click that initiated this command.

Figure 6.18. Selecting a Circular Set of Elements

Selecting a Circular Set of Elements

A Skeleton while some Elements are being selected with CircleElementSelect.

Selecting a Circular Set of Elements

The Elements that were selected are marked in red.