OOF2: The Manual

Name

OOF.Graphics_n.Toolbox.Select_Element.Rectangle — Drag to select elements within a rectangle.

Synopsis

OOF.Graphics_n.Toolbox.Select_Element.Rectangle(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

RectangleElementSelect 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 rectangle swept out by dragging the mouse, as shown in Figure 6.20. Click the mouse on one corner of the rectangle and drag to the opposite corner. Only those Elements that are completely within the rectangle will be selected.

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

points is a list of Point objects. The first and second points in the list are diagonally opposite corners of the rectangle. 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.20. Selecting a Rectangular Set of Elements

Selecting a Rectangular Set of Elements

A Skeleton while some Elements are being selected with RectangleElementSelect.

Selecting a Rectangular Set of Elements

The Elements that were selected are marked in red.