EditMaskedRegion

Inserts a region control into the spreadsheet. When the control is clicked, the display switches to Interactive Graphics Mode, where the composite region can be modified through the EditMaskedRegion Interactive Graphics Mode. A masked region within the ROI is used to indicate an area of the image that should not be processed.

Note:

To access the Property Sheet for EditMaskedRegion, right-click the EditMaskedRegion control and select Edit Function.
A right-click menu is available in the Interactive Graphics Mode, which allows you to add or delete a region.

Inputs

Parameter

Description

Image

This parameter must reference a spreadsheet cell that contains an Image data structure. By default, this parameter references cell A0, the cell containing the Image data structure returned by the AcquireImage function. This parameter can also reference other Image data structures, such as those returned by the Vision Tool Image Functions or Coordinate Transforms Functions.

Fixture

Specifies the image coordinate system in which the input composite region is defined.

X	The X-offset of the origin, in fixture coordinates.
Y	The Y-offset of the origin, in fixture coordinates.
Theta	The rotation from the image X-axis, in the image coordinate system. (+/-360 degrees clockwise)

Add Masks

If checked, additional masks can be added in the Interactive Graphics Mode.

Remove Masks

If checked (default), masks can be removed in the Interactive Graphics Mode.

Edit Masks

If checked (default), masks can be modified in the Interactive Graphics Mode.

Move

If checked (default), the entire composite region can be moved in the Interactive Graphics Mode.

Size

If checked (default), the region can be re-sized in the Interactive Graphics Mode.

Rotate

If checked (default), the region can be rotated in the Interactive Graphics Mode.

Bend

If checked (default), the region can be bent in the Interactive Graphics Mode.

Name

Specifies a text label for the EditMaskedRegion control element in the spreadsheet.

Show

Specifies the display mode for the EditMaskedRegion graphics overlay on the image.

0 = hide all	The region is hidden, except when the cell containing the EditMaskedRegion function is highlighted in the spreadsheet.
2 = input graphics only	The region is displayed at all times.