SoReconstructionFromMarkersProcessing engine More...
Public Member Functions | |
SoReconstructionFromMarkersProcessing () | |
Public Attributes | |
SoSFEnum | computeMode |
SoSFEnum | neighborhood3d |
SoSFImageDataAdapter | inMaskImage |
SoSFImageDataAdapter | inMarkerImage |
SoImageVizEngineOutput < SoSFImageDataAdapter, SoImageDataAdapter * > | outImage |
The SoReconstructionFromMarkersProcessing engine rebuilds an image starting from markers.
For an introduction, see section Morphology.
This engine rebuilds a set of objects identified by markers and retrieves only the objects containing (at least) a marker.
Successive dilations are performed on the markers, each dilation being followed by an intersection with the original image until convergence (idempotence). This iterative process is called a geodesic dilation. It guarantees that a dilated marker will not merge into a particle other than the it marks.
Geodesic dilation is different from a large dilation of a given size followed by an intersection with the original image because a dilated marker may hit close particles which are not marked for reconstruction.
For example, given an erosion which eliminated the small particles of an image, this engine can rebuild the original shapes of the remaining particles if the eroded set is used as the markers.
Comparison between reconstruction from markers and dilation/intersection
SoBorderKillProcessing, SoObjectBoundariesProcessing.
computeMode | MODE_AUTO |
neighborhood3d | CONNECTIVITY_26 |
inMaskImage | NULL |
inMarkerImage | NULL |
SoReconstructionFromMarkersProcessing::SoReconstructionFromMarkersProcessing | ( | ) |
Constructor.
Select the compute Mode (2D or 3D or AUTO) Use enum ComputeMode.
Default is MODE_AUTO
The binary marker image containing seeds for reconstruction.
Default value is NULL. Supported types include: binary color image.
The binary mask image constraining reconstruction.
Default value is NULL. Supported types include: binary color image.
In 3D configuration (see computeMode), the neighborhood connectivity defines the connectivity considered for processing adjacent voxels.
Use enum Neighborhood3d. Default is CONNECTIVITY_26.
SoImageVizEngineOutput<SoSFImageDataAdapter,SoImageDataAdapter*> SoReconstructionFromMarkersProcessing::outImage |
The output image.
Default value is NULL. Supported types include: grayscale binary label color image.