OOF2: The Manual

Name

OOF.Graphics_n.Toolbox.Select_Element.Ellipse — Drag to select elements within an ellipse.

Synopsis

OOF.Graphics_n.Toolbox.Select_Element.Ellipse(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: True or False.
    ctrl
    True for toggle. Type: Boolean: True or False.

Description

EllipseElementSelect 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 ellipse swept out by dragging the mouse, as shown in Figure 6.23. The ellipse is defined by the rectangle that bounds it. Click the mouse on one corner of the rectangle and drag to the diagonally opposite corner.

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 one corner of the rectangle bounding the ellipse, and the last point is the diagonally opposite corner. 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 (True) or not (False) the shift and control keys were depressed during the mouse click that initiated this command.

Figure 6.23. Selecting a Elliptical Set of Elements

Selecting a Elliptical Set of Elements

(a) Select an elliptical region by clicking on one corner of a rectangle and dragging to the diagonally opposite corner, as shown by the yellow arrow. The ellipse is drawn within the rectangle.

(b) The bright red selected Elements are the ones that are completely within the ellipse.