eVision.Easy3D.EMeshToZMapConverter Class Reference

Computes an eVision.Easy3D.EZMap from an eVision.Easy3D.EMesh. More...

Public Member Functions
None	__init__ (self)
	Creates an eVision.Easy3D.EMeshToZMapConverter object.
None	__init__ (self, eVision.Easy3D.EMeshToZMapConverter other)
	Creates an eVision.Easy3D.EMeshToZMapConverter object.
None	Convert (self, eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap8 zmap)
	Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.
None	Convert (self, eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap16 zmap)
	Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.
None	Convert (self, eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap32f zmap)
	Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.
None	Convert (self, eVision.Easy3D.EMesh obj, eVision.Easy3D.EZMap|None zmap)
	Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.
None	UnsetWorldToZMapTransform (self)
	Disables the explicit world to ZMap transformation, set with eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform.
None	UnsetOrigin (self)
	Lets the conversion process decides for the eVision.Easy3D.EZMap origin position (based on projected point cloud on the reference plane).
bool	IsOriginSet (self)
	Gets whether the Origin of the ZMap is set or not.
None	EnableFillMode (self, bool state)
	Enables or disables fill mode.
None	EnableFillMode (self)
	Enables or disables fill mode.
bool	IsFillModeEnabled (self)
	Tells if the fill mode is enabled or not.
bool	IsFillModeMedian (self)
	Tells if the fill mode is in median mode or not, this value is not affected by eVision.Easy3D.EMeshToZMapConverter.EnableFillMode.
None	SetFillMode (self, eVision.Easy3D.EFillUndefinedPixelsDirection direction, eVision.Easy3D.EFillUndefinedPixelsMethod method)
	Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap.
None	SetFillModeMedian (self, int halfOfKernelWidth, int halfOfKernelHeight)
	Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.
None	SetFillModeMedian (self, int halfOfKernelWidth)
	Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.
None	SetFillModeMedian (self)
	Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.
None	SetMapSize (self, int width, int height)
	Sets the required size of the generated eVision.Easy3D.EZMap; expressed in number of pixels for width and height dimensions.
None	UnsetMapSize (self)
	Unsets the resolution.
None	SetMapXYResolution (self, float resolution)
	Sets the resolution (possibly anisotropic) of the eVision.Easy3D.EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).
None	SetMapXYResolution (self, float resolutionX, float resolutionY)
	Sets the resolution (possibly anisotropic) of the eVision.Easy3D.EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).
None	UnsetMapXYResolution (self)
	Unsets the X and Y resolutions.
None	UnsetMapZResolution (self)
	Unsets the eVision.Easy3D.EMeshToZMapConverter.MapZResolution (as well as the eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler).
None	Load (self, str path)
	Loads the converter configuration.
None	Load (self, eVision.ESerializer|None serializer)
	Loads the converter configuration.
None	Save (self, str path)
	Saves the converter configuration.
None	Save (self, eVision.ESerializer|None serializer)
	Saves the converter configuration.
eVision.Easy3D.E3DTransformMatrix	WorldToZMapTransform (self)
	Explicitly sets the world to ZMap transformation.
	WorldToZMapTransform (self, eVision.Easy3D.E3DTransformMatrix value)
	Explicitly sets the world to ZMap transformation.
eVision.Easy3D.E3DTransformMatrix	ZMaptoWorldTransform (self)
	Explicitly sets the ZMap to World transformation.
	ZMaptoWorldTransform (self, eVision.Easy3D.E3DTransformMatrix value)
	Explicitly sets the ZMap to World transformation.
eVision.Easy3D.E3DPlane	ReferencePlane (self)
	Gets the eVision.Easy3D.E3DPlane reference plane.
	ReferencePlane (self, eVision.Easy3D.E3DPlane value)
	Gets the eVision.Easy3D.E3DPlane reference plane.
eVision.Easy3D.EZMapReferencePlaneMode	ReferencePlaneMode (self)
	Sets an axis aligned reference plane.
	ReferencePlaneMode (self, eVision.Easy3D.EZMapReferencePlaneMode value)
	Sets an axis aligned reference plane.
eVision.Easy3D.E3DPoint	OrientationVector (self)
	Sets an explicit orientation for the eVision.Easy3D.EZMap.
	OrientationVector (self, eVision.Easy3D.E3DPoint value)
	Sets an explicit orientation for the eVision.Easy3D.EZMap.
eVision.Easy3D.EZMapOrientationVectorMode	OrientationVectorMode (self)
	Chooses the eVision.Easy3D.EZMap orientation from a list of predefined axis, automatic mode or user defined vector.
	OrientationVectorMode (self, eVision.Easy3D.EZMapOrientationVectorMode value)
	Chooses the eVision.Easy3D.EZMap orientation from a list of predefined axis, automatic mode or user defined vector.
eVision.Easy3D.E3DPoint	Origin (self)
	Chooses the eVision.Easy3D.EZMap origin.
	Origin (self, eVision.Easy3D.E3DPoint value)
	Chooses the eVision.Easy3D.EZMap origin.
int	FillModeMedianHalfKernelX (self)
	Returns the last halfKernelX set by eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.
int	FillModeMedianHalfKernelY (self)
	Returns the last halfKernelX set by eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.
eVision.Easy3D.EFillUndefinedPixelsDirection	FillUndefinedPixelsDirection (self)
	Gets the undefined pixel fill direction (see eVision.Easy3D.EFillUndefinedPixelsDirection).
eVision.Easy3D.EFillUndefinedPixelsMethod	FillUndefinedPixelsMethod (self)
	Gets the undefined pixel fill method (see eVision.Easy3D.EFillUndefinedPixelsMethod).
int	MapWidth (self)
	Gets the required width (number of pixels) of the generated eVision.Easy3D.EZMap.
int	MapHeight (self)
	Gets the required height (number of pixels) of the generated eVision.Easy3D.EZMap.
float	MapXResolution (self)
	Gets the resolution of the eVision.Easy3D.EZMap pixels along the X axis.
float	MapYResolution (self)
	Gets the resolution of the eVision.Easy3D.EZMap pixels along the Y axis.
float	MapZResolution (self)
	Gets/Sets the eVision.Easy3D.EZMap Z resolution, in world space units per gray value.
	MapZResolution (self, float value)
	Gets/Sets the eVision.Easy3D.EZMap Z resolution, in world space units per gray value.
eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler	MapZResolutionFailureHandler (self)
	Gets/Sets the method to handle failures in eVision.Easy3D.EMeshToZMapConverter.Convert when the eVision.Easy3D.EZMap Z resolution is set explicitly (eVision.Easy3D.EMeshToZMapConverter.MapZResolution).
	MapZResolutionFailureHandler (self, eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler value)
	Gets/Sets the method to handle failures in eVision.Easy3D.EMeshToZMapConverter.Convert when the eVision.Easy3D.EZMap Z resolution is set explicitly (eVision.Easy3D.EMeshToZMapConverter.MapZResolution).
float	Extension (self)
	Gets the 3D point cloud extension.
	Extension (self, float value)
	Gets the 3D point cloud extension.

Detailed Description

Computes an eVision.Easy3D.EZMap from an eVision.Easy3D.EMesh.

The value of the pixels of the ZMap are the distance between the 3D points and the reference plane. All 3D points under the reference plane are discarded. Various options can be set with methods eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.SetFillMode, eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution, eVision.Easy3D.EMeshToZMapConverter.MapZResolution, eVision.Easy3D.EMeshToZMapConverter.OrientationVector... When the conversion is called without defining specific parameters, the algorithm uses the following options:

• The reference plane is the horizontal plane.
• The orientation vector is selected automatically.
• The origin is set as the lowest left position of the projected point cloud on the reference plane.
• The resolution (the dimensions of the Z map) is estimated to have approximately one Point Cloud point per ZMap pixels.
• The scale is calculated from the point cloud ranges and the estimated resolution.
• The fill mode is enabled and the method is set to 'EFillUndefinedPixelsDirection_Local' (see method eVision.Easy3D.EDepthMap8.FillUndefinedPixels).

Remarks:

License(s): Easy3D

Constructor & Destructor Documentation

__init__() [1/2]

None eVision.Easy3D.EMeshToZMapConverter.__init__

(

self

)

Creates an eVision.Easy3D.EMeshToZMapConverter object.

__init__() [2/2]

None eVision.Easy3D.EMeshToZMapConverter.__init__	(		self,
		eVision.Easy3D.EMeshToZMapConverter	other )

Creates an eVision.Easy3D.EMeshToZMapConverter object.

Parameters

other

Reference to the eVision.Easy3D.EMeshToZMapConverter object used for the initialization.

Member Function Documentation

Convert() [1/4]

None eVision.Easy3D.EMeshToZMapConverter.Convert	(		self,
		eVision.Easy3D.EMesh	obj,
		eVision.Easy3D.EZMap16	zmap )

Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.

The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector, eVision.Easy3D.EMeshToZMapConverter.SetMapSize, ...

Parameters

obj	The input 3D mesh.
zmap	The generated ZMap in 8, 16 or 32 bits format.

Convert() [2/4]

None eVision.Easy3D.EMeshToZMapConverter.Convert	(		self,
		eVision.Easy3D.EMesh	obj,
		eVision.Easy3D.EZMap32f	zmap )

Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.

The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector, eVision.Easy3D.EMeshToZMapConverter.SetMapSize, ...

Parameters

obj	The input 3D mesh.
zmap	The generated ZMap in 8, 16 or 32 bits format.

Convert() [3/4]

None eVision.Easy3D.EMeshToZMapConverter.Convert	(		self,
		eVision.Easy3D.EMesh	obj,
		eVision.Easy3D.EZMap8	zmap )

Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.

The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector, eVision.Easy3D.EMeshToZMapConverter.SetMapSize, ...

Parameters

obj	The input 3D mesh.
zmap	The generated ZMap in 8, 16 or 32 bits format.

Convert() [4/4]

None eVision.Easy3D.EMeshToZMapConverter.Convert	(		self,
		eVision.Easy3D.EMesh	obj,
		eVision.Easy3D.EZMap | None	zmap )

Computes an eVision.Easy3D.EZMap from a world space eVision.Easy3D.EMesh.

The value of the pixels of the ZMap are the distance between the 3D triangles and the reference plane. Various options can be set with methods eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector, eVision.Easy3D.EMeshToZMapConverter.SetMapSize, ...

Parameters

obj	The input 3D mesh.
zmap	The generated ZMap in 8, 16 or 32 bits format.

EnableFillMode() [1/2]

None eVision.Easy3D.EMeshToZMapConverter.EnableFillMode

(

self

)

Enables or disables fill mode.

Fill mode parameters are defined by method eVision.Easy3D.EMeshToZMapConverter.SetFillMode or eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.

Fill mode is enabled by default. If fill mode is disabled, undefined pixels may remain in the eVision.Easy3D.EZMap.

EnableFillMode() [2/2]

None eVision.Easy3D.EMeshToZMapConverter.EnableFillMode	(		self,
		bool	state )

Enables or disables fill mode.

Fill mode parameters are defined by method eVision.Easy3D.EMeshToZMapConverter.SetFillMode or eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.

Fill mode is enabled by default. If fill mode is disabled, undefined pixels may remain in the eVision.Easy3D.EZMap.

Parameters

state

Set to true to enable fill mode.

Extension() [1/2]

float eVision.Easy3D.EMeshToZMapConverter.Extension

(

self

)

Gets the 3D point cloud extension.

Extension() [2/2]

eVision.Easy3D.EMeshToZMapConverter.Extension	(		self,
		float	value )

Gets the 3D point cloud extension.

FillModeMedianHalfKernelX()

int eVision.Easy3D.EMeshToZMapConverter.FillModeMedianHalfKernelX

(

self

)

Returns the last halfKernelX set by eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.

FillModeMedianHalfKernelY()

int eVision.Easy3D.EMeshToZMapConverter.FillModeMedianHalfKernelY

(

self

)

Returns the last halfKernelX set by eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian.

FillUndefinedPixelsDirection()

eVision.Easy3D.EFillUndefinedPixelsDirection eVision.Easy3D.EMeshToZMapConverter.FillUndefinedPixelsDirection

(

self

)

Gets the undefined pixel fill direction (see eVision.Easy3D.EFillUndefinedPixelsDirection).

FillUndefinedPixelsMethod()

eVision.Easy3D.EFillUndefinedPixelsMethod eVision.Easy3D.EMeshToZMapConverter.FillUndefinedPixelsMethod

(

self

)

Gets the undefined pixel fill method (see eVision.Easy3D.EFillUndefinedPixelsMethod).

IsFillModeEnabled()

bool eVision.Easy3D.EMeshToZMapConverter.IsFillModeEnabled

(

self

)

Tells if the fill mode is enabled or not.

Use eVision.Easy3D.EMeshToZMapConverter.EnableFillMode to toggle the fill mode and eVision.Easy3D.EMeshToZMapConverter.SetFillMode or eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian to set the filling parameters.

IsFillModeMedian()

bool eVision.Easy3D.EMeshToZMapConverter.IsFillModeMedian

(

self

)

Tells if the fill mode is in median mode or not, this value is not affected by eVision.Easy3D.EMeshToZMapConverter.EnableFillMode.

Use eVision.Easy3D.EMeshToZMapConverter.EnableFillMode to toggle the fill mode and eVision.Easy3D.EMeshToZMapConverter.SetFillMode or eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian to set the filling parameters.

IsOriginSet()

bool eVision.Easy3D.EMeshToZMapConverter.IsOriginSet

(

self

)

Gets whether the Origin of the ZMap is set or not.

Use eVision.Easy3D.EMeshToZMapConverter.Origin to enable and choose the ZMap origin.

Load() [1/2]

None eVision.Easy3D.EMeshToZMapConverter.Load	(		self,
		eVision.ESerializer | None	serializer )

Loads the converter configuration.

The given eVision.ESerializer must have been created for reading.

Parameters

serializer

The serializer.

Load() [2/2]

None eVision.Easy3D.EMeshToZMapConverter.Load	(		self,
		str	path )

Loads the converter configuration.

The given eVision.ESerializer must have been created for reading.

Parameters

path	The file path.

MapHeight()

int eVision.Easy3D.EMeshToZMapConverter.MapHeight

(

self

)

Gets the required height (number of pixels) of the generated eVision.Easy3D.EZMap.

By default, the required size is not set.

MapWidth()

int eVision.Easy3D.EMeshToZMapConverter.MapWidth

(

self

)

Gets the required width (number of pixels) of the generated eVision.Easy3D.EZMap.

By default, the required size is not set.

MapXResolution()

float eVision.Easy3D.EMeshToZMapConverter.MapXResolution

(

self

)

Gets the resolution of the eVision.Easy3D.EZMap pixels along the X axis.

MapYResolution()

float eVision.Easy3D.EMeshToZMapConverter.MapYResolution

(

self

)

Gets the resolution of the eVision.Easy3D.EZMap pixels along the Y axis.

MapZResolution() [1/2]

float eVision.Easy3D.EMeshToZMapConverter.MapZResolution

(

self

)

Gets/Sets the eVision.Easy3D.EZMap Z resolution, in world space units per gray value.

The resolution is used to compute the transformation of the world Z position to an integer 8, 16 or 32 bits pixel value.

If the resolution set is too small to represent the whole 3D data, it will have to be cropped, saturated or an exception will be thrown. By default, the data is cropped. To specify another behavior, use eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler.

MapZResolution() [2/2]

eVision.Easy3D.EMeshToZMapConverter.MapZResolution	(		self,
		float	value )

Gets/Sets the eVision.Easy3D.EZMap Z resolution, in world space units per gray value.

The resolution is used to compute the transformation of the world Z position to an integer 8, 16 or 32 bits pixel value.

If the resolution set is too small to represent the whole 3D data, it will have to be cropped, saturated or an exception will be thrown. By default, the data is cropped. To specify another behavior, use eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler.

MapZResolutionFailureHandler() [1/2]

eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler

(

self

)

Gets/Sets the method to handle failures in eVision.Easy3D.EMeshToZMapConverter.Convert when the eVision.Easy3D.EZMap Z resolution is set explicitly (eVision.Easy3D.EMeshToZMapConverter.MapZResolution).

If the resolution set by eVision.Easy3D.EMeshToZMapConverter.MapZResolution is too small to represent the whole 3D data, it may be cropped, saturated or an exception may be thrown. By default, data is cropped.

MapZResolutionFailureHandler() [2/2]

eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler	(		self,
		eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler	value )

Gets/Sets the method to handle failures in eVision.Easy3D.EMeshToZMapConverter.Convert when the eVision.Easy3D.EZMap Z resolution is set explicitly (eVision.Easy3D.EMeshToZMapConverter.MapZResolution).

If the resolution set by eVision.Easy3D.EMeshToZMapConverter.MapZResolution is too small to represent the whole 3D data, it may be cropped, saturated or an exception may be thrown. By default, data is cropped.

OrientationVector() [1/2]

eVision.Easy3D.E3DPoint eVision.Easy3D.EMeshToZMapConverter.OrientationVector

(

self

)

Sets an explicit orientation for the eVision.Easy3D.EZMap.

Overrides the orientation mode given by the method eVision.Easy3D.EMeshToZMapConverter.OrientationVectorMode.

Remarks:

The direction should be an eVision.Easy3D.E3DPoint representing the expected direction of the X (width) axis of the ZMap. That direction will be used after projection on the reference plane normal. That direction must NOT be aligned with the reference plane normal.

OrientationVector() [2/2]

eVision.Easy3D.EMeshToZMapConverter.OrientationVector	(		self,
		eVision.Easy3D.E3DPoint	value )

Sets an explicit orientation for the eVision.Easy3D.EZMap.

Overrides the orientation mode given by the method eVision.Easy3D.EMeshToZMapConverter.OrientationVectorMode.

Remarks:

The direction should be an eVision.Easy3D.E3DPoint representing the expected direction of the X (width) axis of the ZMap. That direction will be used after projection on the reference plane normal. That direction must NOT be aligned with the reference plane normal.

OrientationVectorMode() [1/2]

eVision.Easy3D.EZMapOrientationVectorMode eVision.Easy3D.EMeshToZMapConverter.OrientationVectorMode

(

self

)

Chooses the eVision.Easy3D.EZMap orientation from a list of predefined axis, automatic mode or user defined vector.

Use eVision.Easy3D.EMeshToZMapConverter.OrientationVector to set an explicit orientation vector for the ZMap.

Remarks:

Choose between Automatic mode (default), world space axis or explicit user defined vector (see eVision.Easy3D.EZMapOrientationVectorMode).

OrientationVectorMode() [2/2]

eVision.Easy3D.EMeshToZMapConverter.OrientationVectorMode	(		self,
		eVision.Easy3D.EZMapOrientationVectorMode	value )

Chooses the eVision.Easy3D.EZMap orientation from a list of predefined axis, automatic mode or user defined vector.

Use eVision.Easy3D.EMeshToZMapConverter.OrientationVector to set an explicit orientation vector for the ZMap.

Remarks:

Choose between Automatic mode (default), world space axis or explicit user defined vector (see eVision.Easy3D.EZMapOrientationVectorMode).

Origin() [1/2]

eVision.Easy3D.E3DPoint eVision.Easy3D.EMeshToZMapConverter.Origin

(

self

)

Chooses the eVision.Easy3D.EZMap origin.

It is the 3D world position used as origin of the ZMap upper left pixel (0,0).

Remarks:

That position will be projected on the reference plane.

To let the conversion choose for the origin, call eVision.Easy3D.EMeshToZMapConverter.UnsetOrigin.

Origin() [2/2]

eVision.Easy3D.EMeshToZMapConverter.Origin	(		self,
		eVision.Easy3D.E3DPoint	value )

Chooses the eVision.Easy3D.EZMap origin.

It is the 3D world position used as origin of the ZMap upper left pixel (0,0).

Remarks:

That position will be projected on the reference plane.

To let the conversion choose for the origin, call eVision.Easy3D.EMeshToZMapConverter.UnsetOrigin.

ReferencePlane() [1/2]

eVision.Easy3D.E3DPlane eVision.Easy3D.EMeshToZMapConverter.ReferencePlane

(

self

)

Gets the eVision.Easy3D.E3DPlane reference plane.

Use eVision.Easy3D.EMeshToZMapConverter.ReferencePlane to set an explicit reference plane.

ReferencePlane() [2/2]

eVision.Easy3D.EMeshToZMapConverter.ReferencePlane	(		self,
		eVision.Easy3D.E3DPlane	value )

Gets the eVision.Easy3D.E3DPlane reference plane.

Use eVision.Easy3D.EMeshToZMapConverter.ReferencePlane to set an explicit reference plane.

ReferencePlaneMode() [1/2]

eVision.Easy3D.EZMapReferencePlaneMode eVision.Easy3D.EMeshToZMapConverter.ReferencePlaneMode

(

self

)

Sets an axis aligned reference plane.

Overrides the explicit reference plane given by the method eVision.Easy3D.EMeshToZMapConverter.ReferencePlane.

Remarks:

Choose between X, Y or Z reference plane (see eVision.Easy3D.EZMapReferencePlaneMode).

The plane offset is set automatically on the point cloud lowest 3D point.

ReferencePlaneMode() [2/2]

eVision.Easy3D.EMeshToZMapConverter.ReferencePlaneMode	(		self,
		eVision.Easy3D.EZMapReferencePlaneMode	value )

Sets an axis aligned reference plane.

Overrides the explicit reference plane given by the method eVision.Easy3D.EMeshToZMapConverter.ReferencePlane.

Remarks:

Choose between X, Y or Z reference plane (see eVision.Easy3D.EZMapReferencePlaneMode).

The plane offset is set automatically on the point cloud lowest 3D point.

Save() [1/2]

None eVision.Easy3D.EMeshToZMapConverter.Save	(		self,
		eVision.ESerializer | None	serializer )

Saves the converter configuration.

The given eVision.ESerializer must have been created for writing.

Parameters

serializer

Pointer to the eVision.ESerializer created for writing.

Save() [2/2]

None eVision.Easy3D.EMeshToZMapConverter.Save	(		self,
		str	path )

Saves the converter configuration.

The given eVision.ESerializer must have been created for writing.

Parameters

path	The file path.

SetFillMode()

None eVision.Easy3D.EMeshToZMapConverter.SetFillMode	(		self,
		eVision.Easy3D.EFillUndefinedPixelsDirection	direction,
		eVision.Easy3D.EFillUndefinedPixelsMethod	method )

Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap.

A hole exists when no 3D point is projected at that pixel position in the ZMap.

Parameters

direction	Direction in which the undefined pixels are filled in a depthmap from eVision.Easy3D.EFillUndefinedPixelsDirection
method	Which values used to fill the undefined pixels in a depthmap from eVision.Easy3D.EFillUndefinedPixelsMethod

SetFillModeMedian() [1/3]

None eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian

(

self

)

Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.

A hole exists when no 3D point is projected at that pixel position in the ZMap.

SetFillModeMedian() [2/3]

None eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian	(		self,
		int	halfOfKernelWidth )

Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.

A hole exists when no 3D point is projected at that pixel position in the ZMap.

Parameters

halfOfKernelWidth

Half of the box width minus one (by default, halfOfKernelWidth = 2).

SetFillModeMedian() [3/3]

None eVision.Easy3D.EMeshToZMapConverter.SetFillModeMedian	(		self,
		int	halfOfKernelWidth,
		int	halfOfKernelHeight )

Inpainting options used to fill the "holes" in the eVision.Easy3D.EZMap using a median rectangular kernel of odd size.

A hole exists when no 3D point is projected at that pixel position in the ZMap.

Parameters

halfOfKernelWidth	Half of the box width minus one (by default, halfOfKernelWidth = 2).
halfOfKernelHeight	Half of the box height minus one (by default, same as halfOfKernelWidth).

SetMapSize()

None eVision.Easy3D.EMeshToZMapConverter.SetMapSize	(		self,
		int	width,
		int	height )

Sets the required size of the generated eVision.Easy3D.EZMap; expressed in number of pixels for width and height dimensions.

By default, the required size is not set.

Parameters

width	The required width for the Generated ZMap.
height	The required height for the Generated ZMap.

SetMapXYResolution() [1/2]

None eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution	(		self,
		float	resolution )

Sets the resolution (possibly anisotropic) of the eVision.Easy3D.EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).

The resolution is used to compute the ZMap size (width and height), depending on the projected point cloud on the reference plane.

Remarks:

The isotropic scale, for X and Y axis is in metric world units.

Parameters

resolution

The resolution for the isotropic case.

SetMapXYResolution() [2/2]

None eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution	(		self,
		float	resolutionX,
		float	resolutionY )

Sets the resolution (possibly anisotropic) of the eVision.Easy3D.EZMap pixels along the X and Y axes, in world space units per pixel (e.g mm/pixel).

The resolution is used to compute the ZMap size (width and height), depending on the projected point cloud on the reference plane.

Remarks:

The isotropic scale, for X and Y axis is in metric world units.

Parameters

resolutionX	The resolution for the X axis.
resolutionY	The resolution for the Y axis.

UnsetMapSize()

None eVision.Easy3D.EMeshToZMapConverter.UnsetMapSize

(

self

)

Unsets the resolution.

Lets the conversion decides for the optimum resolution, depending on the projected point cloud and pixel scale.

UnsetMapXYResolution()

None eVision.Easy3D.EMeshToZMapConverter.UnsetMapXYResolution

(

self

)

Unsets the X and Y resolutions.

Lets the conversion decide the optimal resolution, depending on the projected point cloud and eVision.Easy3D.EZMap size.

UnsetMapZResolution()

None eVision.Easy3D.EMeshToZMapConverter.UnsetMapZResolution

(

self

)

Unsets the eVision.Easy3D.EMeshToZMapConverter.MapZResolution (as well as the eVision.Easy3D.EMeshToZMapConverter.MapZResolutionFailureHandler).

Lets the conversion decide the optimal Z resolution.

UnsetOrigin()

None eVision.Easy3D.EMeshToZMapConverter.UnsetOrigin

(

self

)

Lets the conversion process decides for the eVision.Easy3D.EZMap origin position (based on projected point cloud on the reference plane).

Use eVision.Easy3D.EMeshToZMapConverter.Origin to enable and choose the ZMap origin.

UnsetWorldToZMapTransform()

None eVision.Easy3D.EMeshToZMapConverter.UnsetWorldToZMapTransform

(

self

)

Disables the explicit world to ZMap transformation, set with eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform.

WorldToZMapTransform() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform

(

self

)

Explicitly sets the world to ZMap transformation.

eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform overrides the settings done by eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector and eVision.Easy3D.EMeshToZMapConverter.Origin. That eVision.Easy3D.E3DTransformMatrix transform expresses how the world positions are transformed to the eVision.Easy3D.EZMap space. The matrix must be a rigid transformation (translation and rotation only). The resolution of the ZMap are defined by the eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution and eVision.Easy3D.EMeshToZMapConverter.MapZResolution methods.

WorldToZMapTransform() [2/2]

eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform	(		self,
		eVision.Easy3D.E3DTransformMatrix	value )

Explicitly sets the world to ZMap transformation.

eVision.Easy3D.EMeshToZMapConverter.WorldToZMapTransform overrides the settings done by eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector and eVision.Easy3D.EMeshToZMapConverter.Origin. That eVision.Easy3D.E3DTransformMatrix transform expresses how the world positions are transformed to the eVision.Easy3D.EZMap space. The matrix must be a rigid transformation (translation and rotation only). The resolution of the ZMap are defined by the eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution and eVision.Easy3D.EMeshToZMapConverter.MapZResolution methods.

ZMaptoWorldTransform() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EMeshToZMapConverter.ZMaptoWorldTransform

(

self

)

Explicitly sets the ZMap to World transformation.

"SetZMaptoWorldTransform" overrides the settings done by eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector and eVision.Easy3D.EMeshToZMapConverter.Origin. That eVision.Easy3D.E3DTransformMatrix transform expresses how the eVision.Easy3D.EZMap positions are transformed to the World space. The matrix must be a rigid transformation (translation and rotation only).

The resolutions of the World are defined by the eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution and eVision.Easy3D.EMeshToZMapConverter.MapZResolution methods.

ZMaptoWorldTransform() [2/2]

eVision.Easy3D.EMeshToZMapConverter.ZMaptoWorldTransform	(		self,
		eVision.Easy3D.E3DTransformMatrix	value )

Explicitly sets the ZMap to World transformation.

"SetZMaptoWorldTransform" overrides the settings done by eVision.Easy3D.EMeshToZMapConverter.ReferencePlane, eVision.Easy3D.EMeshToZMapConverter.OrientationVector and eVision.Easy3D.EMeshToZMapConverter.Origin. That eVision.Easy3D.E3DTransformMatrix transform expresses how the eVision.Easy3D.EZMap positions are transformed to the World space. The matrix must be a rigid transformation (translation and rotation only).

The resolutions of the World are defined by the eVision.Easy3D.EMeshToZMapConverter.SetMapXYResolution and eVision.Easy3D.EMeshToZMapConverter.MapZResolution methods.