E3DObjectExtractor is used to extract 3D objects from a ZMap. More...

Inheritance diagram for eVision.Easy3D.E3DObjectExtractor:

Collaboration diagram for eVision.Easy3D.E3DObjectExtractor:

Public Member Functions
	E3DObjectExtractor ()
	Constructs an E3DObjectExtractor with default (invalid) values.
	E3DObjectExtractor (eVision.Easy3D.E3DObjectExtractor other)
	Copy constructor for E3DObjectExtractor.
void	Load (string path)
	Load the E3DObjectExtractor. The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Load the E3DObjectExtractor. The given ESerializer must have been created for reading.
void	Save (string path)
	Save the E3DObjectExtractor. The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Save the E3DObjectExtractor. The given ESerializer must have been created for writing.
void	SetComputeFeature (eVision.Easy3D.E3DObjectFeature feature, bool enable)
	Sets true if the feature should computed by the extractor, false otherwise.
void	UnsetAllComputeFeatures ()
	Disables all features to be computed by the extractor.
void	SetAllComputeFeatures ()
	Enables all features to be computed by the extractor.
bool	GetComputeFeature (eVision.Easy3D.E3DObjectFeature feature)
	Returns true or false depending if the feature should be computed by the extractor.
int	Extract (eVision.Easy3D.EZMap8 zMap)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap8 zMap, eVision.ERegion region)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap16 zMap)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap16 zMap, eVision.ERegion region)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap32f zMap)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap32f zMap, eVision.ERegion region)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap zMap)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
int	Extract (eVision.Easy3D.EZMap zMap, eVision.ERegion region)
	Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX, float panY)
	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.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX)
	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.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY)
	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.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX)
	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.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color)
	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.
void	Draw (eVision.EDrawAdapter graphicContext, eVision.Easy3D.E3DObjectFeature feature)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX, float panY)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color)
	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.
void	Draw (IntPtr graphicContext, eVision.Easy3D.E3DObjectFeature feature)
	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.
void	AddToMesh (eVision.Easy3D.E3DObjectFeature feature, eVision.Easy3D.EMesh mesh)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX, float panY)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY, float panX)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX, float zoomY)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color, float zoomX)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature, eVision.ERGBColor color)
	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.
void	Draw (System.Drawing.Graphics graphicContext, eVision.Easy3D.E3DObjectFeature feature)
	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.

Properties
eVision.EFloatRange	LengthRange `[get, set]`
	The extraction object length range in metric units. Length is the largest dimension of the object, expressed the ZMap coordinate system.
eVision.EFloatRange	WidthRange `[get, set]`
	The extraction object width range in metric units. Width is the smallest dimension of the object, expressed the ZMap coordinate system.
eVision.EFloatRange	LocalHeightRange `[get, set]`
	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.LocalHeightRange.
eVision.EFloatRange	ReferenceHeightRange `[get, set]`
	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.ReferenceHeightRange.
eVision.EFloatRange	AspectRatioRange `[get, set]`
	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).
eVision.EFloatRange	OrientationRange `[get, set]`
	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).
eVision.EFloatRange	LocalTiltRange `[get, set]`
	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/2 if angle unit is radians).
eVision.EFloatRange	ReferenceTiltRange `[get, set]`
	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/2 if angle unit is radians).
eVision.EFloatRange	AreaRange `[get, set]`
	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.
eVision.EFloatRange	VolumeRange `[get, set]`
	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.
bool	OverlappedObject `[get, set]`
	Enable or disable the extraction of overlapped objects.
float	OverlappedAreaRatio `[get, set]`
	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).
float	OverlappedHeightDifference `[get, set]`
	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.
float	ExtractionSensitivity `[get, set]`
	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.
bool	ContourReinforce `[get, set]`
	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).
eVision.Easy3D.E3DObject[]	Objects `[get]`
	Returns the list of extracted objects. The objects are sorted from smallest area to largest area.
eVision.ERegion	ObjectsMask `[get]`
	Gets the ERegion composed of all the objects ZMap pixels.
eVision.ERegion	BackgroundMask `[get]`
	Gets the ERegion composed of background ZMap pixels (where there is not object).

Detailed Description

E3DObjectExtractor is used to extract 3D objects from a ZMap.

License(s): Easy3DObject

Constructor & Destructor Documentation

◆ E3DObjectExtractor() [1/2]

eVision.Easy3D.E3DObjectExtractor.E3DObjectExtractor ( )

Constructs an E3DObjectExtractor with default (invalid) values.

◆ E3DObjectExtractor() [2/2]

eVision.Easy3D.E3DObjectExtractor.E3DObjectExtractor ( eVision.Easy3D.E3DObjectExtractor other )

Copy constructor for E3DObjectExtractor.

Parameters

other The other E3DObjectExtractor that we will copy into this one.

Member Function Documentation

◆ AddToMesh()

void eVision.Easy3D.E3DObjectExtractor.AddToMesh	(	eVision.Easy3D.E3DObjectFeature	feature,
		eVision.Easy3D.EMesh	mesh )

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.

Parameters

feature	The feature to draw, only 3D features are supported.
mesh	The mesh to add the graphics for.

◆ Draw() [1/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.

Drawing is done in the device context associated to the desired window.

◆ Draw() [2/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).

Drawing is done in the device context associated to the desired window.

◆ Draw() [3/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window.

◆ Draw() [4/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window.

◆ Draw() [5/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

◆ Draw() [6/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	eVision.EDrawAdapter	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

◆ Draw() [7/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [8/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [9/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [10/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [11/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [12/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	IntPtr	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [13/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [14/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [15/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [16/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [17/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Draw() [18/18]

void eVision.Easy3D.E3DObjectExtractor.Draw	(	System.Drawing.Graphics	graphicContext,
		eVision.Easy3D.E3DObjectFeature	feature,
		eVision.ERGBColor	color,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

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.

Parameters

graphicContext	Graphic context on which to draw.
feature	The feature to draw.
color	The color in which to draw the feature (optional).
zoomX	Horizontal zooming factor. By default, true scale is used.
zoomY	Vertical zooming factor. If set to 0 (default), the horizontal zooming factor is used instead, so as to provide isotropic zooming.
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

Drawing is done in the device context associated to the desired window.

Deprecated

Use the overload taking an EDrawAdapter by using an instance of EWindowsDrawAdapter.

Deprecated in version 23.12. Scheduled to be removed in version 27.6.

◆ Extract() [1/8]

int eVision.Easy3D.E3DObjectExtractor.Extract ( eVision.Easy3D.EZMap zMap )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.

◆ Extract() [2/8]

int eVision.Easy3D.E3DObjectExtractor.Extract	(	eVision.Easy3D.EZMap	zMap,
		eVision.ERegion	region )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.
region	The region of interest, only pixels inside the given region are considered for object extraction.

◆ Extract() [3/8]

int eVision.Easy3D.E3DObjectExtractor.Extract ( eVision.Easy3D.EZMap16 zMap )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.

◆ Extract() [4/8]

int eVision.Easy3D.E3DObjectExtractor.Extract	(	eVision.Easy3D.EZMap16	zMap,
		eVision.ERegion	region )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.
region	The region of interest, only pixels inside the given region are considered for object extraction.

◆ Extract() [5/8]

int eVision.Easy3D.E3DObjectExtractor.Extract ( eVision.Easy3D.EZMap32f zMap )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.

◆ Extract() [6/8]

int eVision.Easy3D.E3DObjectExtractor.Extract	(	eVision.Easy3D.EZMap32f	zMap,
		eVision.ERegion	region )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.
region	The region of interest, only pixels inside the given region are considered for object extraction.

◆ Extract() [7/8]

int eVision.Easy3D.E3DObjectExtractor.Extract ( eVision.Easy3D.EZMap8 zMap )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.

◆ Extract() [8/8]

int eVision.Easy3D.E3DObjectExtractor.Extract	(	eVision.Easy3D.EZMap8	zMap,
		eVision.ERegion	region )

Processes the ZMap and extracts a list of 3D objects matching the criteria. Returns the number of extracted objects.

Parameters

zMap	The source ZMap.
region	The region of interest, only pixels inside the given region are considered for object extraction.

◆ GetComputeFeature()

bool eVision.Easy3D.E3DObjectExtractor.GetComputeFeature ( eVision.Easy3D.E3DObjectFeature feature )

Returns true or false depending if the feature should be computed by the extractor.

Parameters

feature The feature that is computed or not.

◆ Load() [1/2]

void eVision.Easy3D.E3DObjectExtractor.Load ( eVision.ESerializer serializer )

Load the E3DObjectExtractor. The given ESerializer must have been created for reading.

Parameters

serializer The serializer.

◆ Load() [2/2]

void eVision.Easy3D.E3DObjectExtractor.Load ( string path )

Load the E3DObjectExtractor. The given ESerializer must have been created for reading.

Parameters

path	The file path.

◆ Save() [1/2]

void eVision.Easy3D.E3DObjectExtractor.Save ( eVision.ESerializer serializer )

Save the E3DObjectExtractor. The given ESerializer must have been created for writing.

Parameters

serializer The ESerializer object that is written to.

◆ Save() [2/2]

void eVision.Easy3D.E3DObjectExtractor.Save ( string path )

Save the E3DObjectExtractor. The given ESerializer must have been created for writing.

Parameters

path	The file path.

◆ SetAllComputeFeatures()

void eVision.Easy3D.E3DObjectExtractor.SetAllComputeFeatures ( )

Enables all features to be computed by the extractor.

◆ SetComputeFeature()

void eVision.Easy3D.E3DObjectExtractor.SetComputeFeature	(	eVision.Easy3D.E3DObjectFeature	feature,
		bool	enable )

Sets true if the feature should computed by the extractor, false otherwise.

Parameters

feature	A feature from E3DObjectFeature.
enable	A bool to choose whether to enable or disable a feature.

◆ UnsetAllComputeFeatures()

void eVision.Easy3D.E3DObjectExtractor.UnsetAllComputeFeatures ( )

Disables all features to be computed by the extractor.

Property Documentation

◆ AreaRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.AreaRange

getset

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.

◆ AspectRatioRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.AspectRatioRange

getset

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).

◆ BackgroundMask

eVision.ERegion eVision.Easy3D.E3DObjectExtractor.BackgroundMask

get

Gets the ERegion composed of background ZMap pixels (where there is not object).

◆ ContourReinforce

bool eVision.Easy3D.E3DObjectExtractor.ContourReinforce

getset

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).

◆ ExtractionSensitivity

float eVision.Easy3D.E3DObjectExtractor.ExtractionSensitivity

getset

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.

◆ LengthRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.LengthRange

getset

The extraction object length range in metric units. Length is the largest dimension of the object, expressed the ZMap coordinate system.

◆ LocalHeightRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.LocalHeightRange

getset

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.LocalHeightRange.

◆ LocalTiltRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.LocalTiltRange

getset

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/2 if angle unit is radians).

◆ Objects

eVision.Easy3D.E3DObject [] eVision.Easy3D.E3DObjectExtractor.Objects

get

Returns the list of extracted objects. The objects are sorted from smallest area to largest area.

◆ ObjectsMask

eVision.ERegion eVision.Easy3D.E3DObjectExtractor.ObjectsMask

get

Gets the ERegion composed of all the objects ZMap pixels.

◆ OrientationRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.OrientationRange

getset

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).

◆ OverlappedAreaRatio

float eVision.Easy3D.E3DObjectExtractor.OverlappedAreaRatio

getset

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).

See E3DObjectExtractor.OverlappedObject

◆ OverlappedHeightDifference

float eVision.Easy3D.E3DObjectExtractor.OverlappedHeightDifference

getset

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.

See E3DObjectExtractor.OverlappedObject

◆ OverlappedObject

bool eVision.Easy3D.E3DObjectExtractor.OverlappedObject

getset

Enable or disable the extraction of overlapped objects.

See E3DObjectExtractor.OverlappedAreaRatio and E3DObjectExtractor.OverlappedHeightDifference

◆ ReferenceHeightRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.ReferenceHeightRange

getset

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.ReferenceHeightRange.

◆ ReferenceTiltRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.ReferenceTiltRange

getset

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/2 if angle unit is radians).

◆ VolumeRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.VolumeRange

getset

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.

◆ WidthRange

eVision.EFloatRange eVision.Easy3D.E3DObjectExtractor.WidthRange

getset

The extraction object width range in metric units. Width is the smallest dimension of the object, expressed the ZMap coordinate system.

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ E3DObjectExtractor() [1/2]

◆ E3DObjectExtractor() [2/2]

Member Function Documentation

◆ AddToMesh()

◆ Draw() [1/18]

◆ Draw() [2/18]

◆ Draw() [3/18]

◆ Draw() [4/18]

◆ Draw() [5/18]

◆ Draw() [6/18]

◆ Draw() [7/18]

◆ Draw() [8/18]

◆ Draw() [9/18]

◆ Draw() [10/18]

◆ Draw() [11/18]

◆ Draw() [12/18]

◆ Draw() [13/18]

◆ Draw() [14/18]

◆ Draw() [15/18]

◆ Draw() [16/18]

◆ Draw() [17/18]

◆ Draw() [18/18]

◆ Extract() [1/8]

◆ Extract() [2/8]

◆ Extract() [3/8]

◆ Extract() [4/8]

◆ Extract() [5/8]

◆ Extract() [6/8]

◆ Extract() [7/8]

◆ Extract() [8/8]

◆ GetComputeFeature()

◆ Load() [1/2]

◆ Load() [2/2]

◆ Save() [1/2]

◆ Save() [2/2]

◆ SetAllComputeFeatures()

◆ SetComputeFeature()

◆ UnsetAllComputeFeatures()

Property Documentation

◆ AreaRange

◆ AspectRatioRange

◆ BackgroundMask

◆ ContourReinforce

◆ ExtractionSensitivity

◆ LengthRange

◆ LocalHeightRange

◆ LocalTiltRange

◆ Objects

◆ ObjectsMask

◆ OrientationRange

◆ OverlappedAreaRatio

◆ OverlappedHeightDifference

◆ OverlappedObject

◆ ReferenceHeightRange

◆ ReferenceTiltRange

◆ VolumeRange

◆ WidthRange