Image Mask

NI Vision Assistant

Image Mask

Builds a mask from an entire image or a region of interest (ROI). An image mask is an image containing values of 1 and 0. Vision Assistant processes only those pixels in the image source that have a corresponding mask image value of 1.

Main Tab

The following controls are available on the Main tab.

  • Step Name—Name to give the step.
  • Reposition Region of Interest—When enabled, the step dynamically repositions the region of interest based on a coordinate system you built in a previous step.
  • Reference Coordinate System—Coordinate system to which you want to link the region of interest.

Mask Tab

The following controls are available on the Mask tab.

  • Image Mask
    Create from ROI Creates an image mask from an ROI selected on the image.
    Create from Image File Creates an image mask from an image file.
  • Mask Options (Create from ROI)
    Outside the ROI Sets all pixels outside the selected region to 0.
    Inside the ROI Sets all pixels inside the selected region to 0.
    Extract Masked Region Casts the resulting image to the bounding rectangle of the ROI. You can use this option with ROIs such as circles, ellipses, and freehand regions. When this option is not selected, the entire image is returned.
  • Mask Options (Create from Image File)
    Black in Image File Masks all pixels with a corresponding mask image value equal to 0 (black).
    Not Black in Image File Masks all pixels not equal to 0 (non-black).
    Extract Masked Region Casts the resulting image to the bounding rectangle of the ROI. You can use this option with ROIs such as circles, ellipses, and freehand regions. When this option is not selected, the entire image is returned.