E3DObjectExtractor Class
E3DObjectExtractor is used to extract 3D objects from a ZMap.
Namespace: Euresys::Open_eVision::Easy3D
Methods
For all extracted objects, adds a 3D representation (in the form of a list of triangles) of the given feature to the given mesh. If the feature is not defined for the E3DObject, this method has no effect.
Draws the specified feature of all extracted objects in the given graphic context. If the feature is not defined for the E3DObject, this method has no effect.
Constructs an E3DObjectExtractor with default (invalid) values
Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
The allowed area range for the objects. Area is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the area is in mm2.
The extraction 2D aspect ratio range. The aspect ratio is the smallest dimension divided by the largest dimension, its value is always between 0 and 1. The smaller the ratio, the more elongated the object is. A value of 1 means a perfectly square object (length=width).
Gets the ERegion composed of background ZMap pixels (where there is not object).
Returns true or false depending if the feature should be computed by the extractor.
When contour reinforcement is enable, a filter is applied to the input image to detect and enhance the frontiers between objects. That option is interesting when objects to extract are in contact. The default state is false (OFF).
Set or Get the extraction sensitivity. The sensitivity ranges from 0 (minimum sensitivity) to 1 (maximum sensitivity). With high sensitivity, the library tries to extract object that are mixed with their surrounding. Low sensitivity values tend to ignore faint objects. The default sensitivity value is 0.6.
The extraction object length range in metric units. Length is the largest dimension of the object, expressed the ZMap coordinate system.
The extraction object local height range in metric units. Local height is the dimension of the object along the normal of the base plane. For a height based on the ZMap origin, use E3DObjectExtractor.
The allowed angle range of the object local tilt. This is the angle between the base plane and the object plane. A value of 0 means that the object top surface is parallel to its base. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
Returns the list of extracted objects. The objects are sorted from smallest area to largest area.
Gets the ERegion composed of all the objects ZMap pixels.
The allowed angle range of the oriented 2D rectangle region. This is the angle of the longest axis (the length of the object), in counter clockwise direction, from the horizontal axis. Valid values are between -90 and +90 degrees (or -Pi/2 and Pi/2 if angle unit is radians).
Set or Get the object area ratio applicable when the overlapped mode is enabled. The area ratio defines the minimum area difference between 2 extracted objects that overlap. E.g with a value of 4, the top object must have an area at least 4 times smaller than the bottom object (or the bottom object must have an area at least 4 times bigger than the top object).
Set or Get the object height difference applicable when the overlapped mode is enabled. That value defines the minimum height difference between 2 overlapped objects.
Enable or disable the extraction of overlapped objects.
The extraction object reference height range in metric units. Reference height is the dimension of the object along the ZMap Z axis from ZMap origin. For a height based on the object base plane, use E3DObjectExtractor.
The allowed angle range of the object reference tilt. This is the angle between the object plane and the ZMap Z Axis. A value of 0 means that the object top surface is parallel to the ZMap XY plane. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
The allowed volume range for the objects. Volume is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the volume is in mm3.
The extraction object width range in metric units. Width is the smallest dimension of the object, expressed the ZMap coordinate system.
Load the E3DObjectExtractor. The given ESerializer must have been created for reading.
Assignment operator
Comparison operator
Save the E3DObjectExtractor. The given ESerializer must have been created for writing.
Enables all features to be computed by the extractor.
The allowed area range for the objects. Area is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the area is in mm2.
The extraction 2D aspect ratio range. The aspect ratio is the smallest dimension divided by the largest dimension, its value is always between 0 and 1. The smaller the ratio, the more elongated the object is. A value of 1 means a perfectly square object (length=width).
Sets true if the feature should computed by the extractor, false otherwise.
When contour reinforcement is enable, a filter is applied to the input image to detect and enhance the frontiers between objects. That option is interesting when objects to extract are in contact. The default state is false (OFF).
Set or Get the extraction sensitivity. The sensitivity ranges from 0 (minimum sensitivity) to 1 (maximum sensitivity). With high sensitivity, the library tries to extract object that are mixed with their surrounding. Low sensitivity values tend to ignore faint objects. The default sensitivity value is 0.6.
The extraction object length range in metric units. Length is the largest dimension of the object, expressed the ZMap coordinate system.
The extraction object local height range in metric units. Local height is the dimension of the object along the normal of the base plane. For a height based on the ZMap origin, use E3DObjectExtractor.
The allowed angle range of the object local tilt. This is the angle between the base plane and the object plane. A value of 0 means that the object top surface is parallel to its base. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
The allowed angle range of the oriented 2D rectangle region. This is the angle of the longest axis (the length of the object), in counter clockwise direction, from the horizontal axis. Valid values are between -90 and +90 degrees (or -Pi/2 and Pi/2 if angle unit is radians).
Set or Get the object area ratio applicable when the overlapped mode is enabled. The area ratio defines the minimum area difference between 2 extracted objects that overlap. E.g with a value of 4, the top object must have an area at least 4 times smaller than the bottom object (or the bottom object must have an area at least 4 times bigger than the top object).
Set or Get the object height difference applicable when the overlapped mode is enabled. That value defines the minimum height difference between 2 overlapped objects.
Enable or disable the extraction of overlapped objects.
The extraction object reference height range in metric units. Reference height is the dimension of the object along the ZMap Z axis from ZMap origin. For a height based on the object base plane, use E3DObjectExtractor.
The allowed angle range of the object reference tilt. This is the angle between the object plane and the ZMap Z Axis. A value of 0 means that the object top surface is parallel to the ZMap XY plane. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
The allowed volume range for the objects. Volume is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the volume is in mm3.
The extraction object width range in metric units. Width is the smallest dimension of the object, expressed the ZMap coordinate system.
Disables all features to be computed by the extractor.
E3DObjectExtractor Class
E3DObjectExtractor is used to extract 3D objects from a ZMap.
Namespace: Euresys.Open_eVision.Easy3D
Properties
The allowed area range for the objects. Area is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the area is in mm2.
The extraction 2D aspect ratio range. The aspect ratio is the smallest dimension divided by the largest dimension, its value is always between 0 and 1. The smaller the ratio, the more elongated the object is. A value of 1 means a perfectly square object (length=width).
Gets the ERegion composed of background ZMap pixels (where there is not object).
When contour reinforcement is enable, a filter is applied to the input image to detect and enhance the frontiers between objects. That option is interesting when objects to extract are in contact. The default state is false (OFF).
Set or Get the extraction sensitivity. The sensitivity ranges from 0 (minimum sensitivity) to 1 (maximum sensitivity). With high sensitivity, the library tries to extract object that are mixed with their surrounding. Low sensitivity values tend to ignore faint objects. The default sensitivity value is 0.6.
The extraction object length range in metric units. Length is the largest dimension of the object, expressed the ZMap coordinate system.
The extraction object local height range in metric units. Local height is the dimension of the object along the normal of the base plane. For a height based on the ZMap origin, use E3DObjectExtractor.
The allowed angle range of the object local tilt. This is the angle between the base plane and the object plane. A value of 0 means that the object top surface is parallel to its base. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
Returns the list of extracted objects. The objects are sorted from smallest area to largest area.
Gets the ERegion composed of all the objects ZMap pixels.
The allowed angle range of the oriented 2D rectangle region. This is the angle of the longest axis (the length of the object), in counter clockwise direction, from the horizontal axis. Valid values are between -90 and +90 degrees (or -Pi/2 and Pi/2 if angle unit is radians).
Set or Get the object area ratio applicable when the overlapped mode is enabled. The area ratio defines the minimum area difference between 2 extracted objects that overlap. E.g with a value of 4, the top object must have an area at least 4 times smaller than the bottom object (or the bottom object must have an area at least 4 times bigger than the top object).
Set or Get the object height difference applicable when the overlapped mode is enabled. That value defines the minimum height difference between 2 overlapped objects.
Enable or disable the extraction of overlapped objects.
The extraction object reference height range in metric units. Reference height is the dimension of the object along the ZMap Z axis from ZMap origin. For a height based on the object base plane, use E3DObjectExtractor.
The allowed angle range of the object reference tilt. This is the angle between the object plane and the ZMap Z Axis. A value of 0 means that the object top surface is parallel to the ZMap XY plane. Valid values are between 0 and +90 degrees (or 0 and Pi if angle unit is radians).
The allowed volume range for the objects. Volume is expressed in the metric coordinate system. E.g, if the ZMap space is in mm, the volume is in mm3.
The extraction object width range in metric units. Width is the smallest dimension of the object, expressed the ZMap coordinate system.
Methods
For all extracted objects, adds a 3D representation (in the form of a list of triangles) of the given feature to the given mesh. If the feature is not defined for the E3DObject, this method has no effect.
Draws the specified feature of all extracted objects in the given graphic context. If the feature is not defined for the E3DObject, this method has no effect.
Constructs an E3DObjectExtractor with default (invalid) values
Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
Returns true or false depending if the feature should be computed by the extractor.
Load the E3DObjectExtractor. The given ESerializer must have been created for reading.
Assignment operator
Comparison operator
Save the E3DObjectExtractor. The given ESerializer must have been created for writing.
Enables all features to be computed by the extractor.
Sets true if the feature should computed by the extractor, false otherwise.
Disables all features to be computed by the extractor.