OOF2: The Manual

Name

OOF.Graphics_n.Toolbox.Select_Element.ByDominantPixel — Click on a pixel to select all elements with that type of dominant pixel.

Synopsis

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

PixelElementSelect 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 with the same dominant pixel type as the pixel that was selected with the mouse. See Figure 6.21 for some examples.

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

points is a list of Point objects. PixelElementSelect will select those Elements whose dominant pixel category is the same as that of the pixel containing the first point in the list.

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.21. Selecting Elements by Pixel Type

Selecting Elements by Pixel Type

A Skeleton for a Microstructure with four pixel types. Clicking on the point shown in (a) selects all Elements whose dominant pixel is blue, shown by the bright red Elements in (b).

(c) and (d) illustrate how this process might be confusing. In (c) the clicked point is not the dominant pixel for the clicked Element. A white pixel has been selected, so in (d) the white Elements are selected, which does not include the clicked Element.