11.7. ITK Binary Contour Image Filter
Extracts the one-pixel-wide outlines of the foreground objects in a binary image.
Group (Subgroup)
ITKImageLabel (ImageLabel)
Description
This filter keeps only the border pixels of the foreground objects in a binary image. A foreground pixel (one whose value equals the Foreground Value) is retained as a contour pixel if it is adjacent to a background pixel; all interior and background pixels are set to the Background Value. The result is the outline of each object.
Parameter Guidance
Foreground Value — the pixel value that marks objects in the input. Contour pixels keep this value in the output. Default 1.
Background Value — the value written for non-contour pixels (interior and background). Default 0.
Fully Connected — controls neighbor connectivity. With it off, only face-sharing neighbors count (thinner contours); with it on, edge- and corner-sharing neighbors also count, producing thicker contours.
Required Input Sources
Operates on a binary/segmented image — typically the output of a thresholding filter such as ITK Binary Threshold Image Filter or Multi-Threshold Objects. For outlines of a multi-region label image, see ITK Label Contour Image Filter.
Reference
Insight Journal: https://www.insight-journal.org/browse/publication/217
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Fully Connected |
Bool |
Set/Get whether the connected components are defined strictly by face connectivity or by face+edge+vertex connectivity. Default is FullyConnectedOff. For objects that are 1 pixel wide, use FullyConnectedOn. |
|
Background Value |
Scalar Value |
Float64 |
Set/Get the background value used to mark the pixels not on the border of the objects. |
Foreground Value |
Scalar Value |
Float64 |
Set/Get the foreground value used to identify the objects in the input and output images. |
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Image Geometry |
Geometry Selection |
Image |
Select the Image Geometry Group from the DataStructure. |
Input Cell Data |
Array Selection |
Allowed Types: int8, uint8, int16, uint16, int32, uint32, int64, uint64 |
The image data that will be processed by this filter. |
Output Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Output Cell Data |
DataObjectName |
The result of the processing will be stored in this Data Array inside the same group as the input data. |
Example Pipelines
License & Copyright
Please see the description file distributed with this Plugin
DREAM3D-NX Help
If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.