OOF2: The Manual

Name

OOF.Graphics_n.Toolbox.Pixel_Select.Ellipse — Drag to select an elliptical region.

Synopsis

OOF.Graphics_n.Toolbox.Pixel_Select.Ellipse(source,points,shift,ctrl)

Details

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

    source
    Microstructure or Image Type: The path to an OOF2 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

Select a contiguous set of pixels by dragging out an ellipse with the mouse.

The source parameter is the path to a Microstructure or Image. If it's an Image, the selection is made in the Microstructure in which the Image resides.

The points parameter is a Python list of Points in the Microstructure, indicating the mouse motion. The first and last points in the list are the diagonally opposite corners of the rectangle that encloses the ellipse. Any other points in the list are ignored.

The shift and ctrl parameters govern how the current selection (i.e, the set of objects defined by this operation) is merged with the previous selection (the objects 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.15. Selecting a Elliptical Region of Pixels

Selecting a Elliptical Region of Pixels

Pixels selected with the Ellipse selector.