Mask Image hides certain portions of an image (based on previously identified objects or a binary image) so they are ignored by subsequent mask-respecting modules in the pipeline.
This module masks an image and saves it in the handles structure for future use. The masked image is based on the original image and the masking object or image that is selected. If using a masking image, the mask is composed of the foreground (white portions); if using a masking object, the mask is composed of the area within the object.
Note that the image created by this module for further processing downstream is grayscale. If a binary mask is desired in subsequent modules, use the ApplyThreshold module instead of MaskImage.
See also ApplyThreshold, IdentifyPrimaryObjects, IdentifyObjectsManually.
Settings:
Select the input image
Select the image that you want to mask.
Name the output image
Enter the name for the output masked image.
Use objects or an image as a mask?
You can mask an image in two ways:
- Objects: Using objects created by another
module (for instance IdentifyPrimaryObjects). The module
will mask out all parts of the image that are not within one
of the objects (unless you invert the mask).
- 5(IO_IMAGE)s: Using a binary image as the mask, where black
portions of the image (false or zero-value pixels) will be masked out.
If the image is not binary, the module will use
all pixels whose intensity is greater than 0.5 as the mask's
foreground (white area). You can use ApplyThreshold instead to create a binary
image and have finer control over the intensity choice.
Select object for mask
(Used only if mask is to be made from objects)
Select the objects you would like to use to mask the input image.
Select image for mask
(Used only if mask is to be made from an image)
Select the image that you like to use to mask the input image.
Invert the mask?
This option reverses the foreground/background relationship of
the mask.
- Select No to produce the mask from the foregound
(white portion) of the masking image or the area within the masking
objects.
- Select Yesto instead produce the mask from the
background (black portions) of the masking image or the area
outside the masking objects.