Class performing the leveling of an eVision.Easy3D.EZMap. More...

Public Member Functions
None	__init__ (self)
	Constructor of an eVision.Easy3D.EZMapLeveler object.
None	__init__ (self, eVision.Easy3D.EZMapLeveler other)
	Constructor of an eVision.Easy3D.EZMapLeveler object.
None	Load (self, str path)
	Loads the eVision.Easy3D.EZMapLeveler object.
None	Load (self, eVision.ESerializer\|None serializer)
	Loads the eVision.Easy3D.EZMapLeveler object.
None	Save (self, str path)
	Saves the eVision.Easy3D.EZMapLeveler object.
None	Save (self, eVision.ESerializer\|None serializer)
	Saves the eVision.Easy3D.EZMapLeveler object.
None	Level (self, eVision.Easy3D.EZMap8 source, eVision.ERegion region, eVision.Easy3D.EZMap8 destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap8 source, eVision.ERegion region, eVision.Easy3D.EZMap8 destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap16 source, eVision.ERegion region, eVision.Easy3D.EZMap16 destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap16 source, eVision.ERegion region, eVision.Easy3D.EZMap16 destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap32f source, eVision.ERegion region, eVision.Easy3D.EZMap32f destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap32f source, eVision.ERegion region, eVision.Easy3D.EZMap32f destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap\|None source, eVision.ERegion region, eVision.Easy3D.EZMap\|None destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap\|None source, eVision.ERegion region, eVision.Easy3D.EZMap\|None destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap8 source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap8 destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap8 source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap8 destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap16 source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap16 destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap16 source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap16 destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap32f source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap32f destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap32f source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap32f destination)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap\|None source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap\|None destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap.
None	Level (self, eVision.Easy3D.EZMap\|None source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap\|None destination)
	Levels the given source ZMap in the destination ZMap.
int	PreservationModes (self)
	Sets/Gets what settings are preserved between the source and destination ZMaps.
	PreservationModes (self, int value)
	Sets/Gets what settings are preserved between the source and destination ZMaps.
eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler	PreserveZResolutionFailureHandler (self)
	Gets/Sets the method to handle failures in eVision.Easy3D.EZMapLeveler.Level when preserving the source eVision.Easy3D.EZMap Z resolution (eVision.Easy3D.EZMapLeveler.PreservationModes set to eVision.Easy3D.EPreservationMode.ZResolution).
	PreserveZResolutionFailureHandler (self, eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler value)
	Gets/Sets the method to handle failures in eVision.Easy3D.EZMapLeveler.Level when preserving the source eVision.Easy3D.EZMap Z resolution (eVision.Easy3D.EZMapLeveler.PreservationModes set to eVision.Easy3D.EPreservationMode.ZResolution).
bool	Preserve3DPosition (self)
	Sets/Gets whether the position of the 3D data is to be preserved when performing leveling.
	Preserve3DPosition (self, bool value)
	Sets/Gets whether the position of the 3D data is to be preserved when performing leveling.

Detailed Description

Class performing the leveling of an eVision.Easy3D.EZMap.

The ZMap is re-projected along a new direction and with a specific orientation. The direction is either given by the user or found on the initial ZMap. The orientation is given as an angle (0° is the x-axis of the initial ZMap).

Remarks:

License(s): Easy3D

Constructor & Destructor Documentation

◆ init() [1/2]

None eVision.Easy3D.EZMapLeveler.__init__ ( self )

Constructor of an eVision.Easy3D.EZMapLeveler object.

◆ init() [2/2]

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

Constructor of an eVision.Easy3D.EZMapLeveler object.

Parameters

other Reference to the eVision.Easy3D.EZMapLeveler used for the initialization.

Member Function Documentation

◆ Level() [1/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap16	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap16	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [2/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap16	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap16	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [3/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap16	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap16	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [4/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap16	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap16	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [5/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap32f	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap32f	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [6/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap32f	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap32f	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [7/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap32f	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap32f	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [8/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap32f	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap32f	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [9/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap8	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap8	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [10/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap8	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap8	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [11/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap8	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap8	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [12/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap8	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap8	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [13/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap \| None	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap \| None	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [14/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap \| None	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap \| None	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
projectionDirection	The direction of projection of the leveled ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Level() [15/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap \| None	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap \| None	destination )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.

◆ Level() [16/16]

None eVision.Easy3D.EZMapLeveler.Level	(		self,
		eVision.Easy3D.EZMap \| None	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap \| None	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap.

Given a ZMap and an eVision.ERegion, the eVision.Easy3D.E3DPlane contained in the eVision.ERegion is extracted and the ZMap is re-projected along that plane's normal. If an eVision.Easy3D.E3DPoint is given instead of the eVision.ERegion, it is used directly as direction to project the leveled ZMap along. In both cases, the projection plane lays slightly below the whole object represented by the input ZMap (so as not to loose any data when projecting). The given rotation angle specifies the x-axis to be used in the new ZMap. An angle of 0° re-uses the x-axis of the source ZMap, one of 90° its y-axis.

Remarks:

If the projectionDirection given or computed from region is orthogonal to the source's Z axis, an exception is thrown.

Parameters

source	The ZMap that will be leveled.
region	The region of the source ZMap containing the reference plane for the leveling. You can use an eVision.ERectangleRegion with the ZMap's size to use the whole ZMap.
destination	The leveled ZMap, must be a ZMap of the same type as source.
rotationAngle	The rotation angle between the x-axes of the source and destination ZMap, in eVision.Easy.SetAngleUnit.

◆ Load() [1/2]

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

Loads the eVision.Easy3D.EZMapLeveler object.

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

Parameters

serializer The serializer.

◆ Load() [2/2]

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

Loads the eVision.Easy3D.EZMapLeveler object.

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

Parameters

path	The file path.

◆ PreservationModes() [1/2]

int eVision.Easy3D.EZMapLeveler.PreservationModes ( self )

Sets/Gets what settings are preserved between the source and destination ZMaps.

See eVision.Easy3D.EPreservationMode for more information. Defaults to eVision.Easy3D.EPreservationMode.XYResolution

◆ PreservationModes() [2/2]

eVision.Easy3D.EZMapLeveler.PreservationModes	(		self,
		int	value )

Sets/Gets what settings are preserved between the source and destination ZMaps.

See eVision.Easy3D.EPreservationMode for more information. Defaults to eVision.Easy3D.EPreservationMode.XYResolution

◆ Preserve3DPosition() [1/2]

bool eVision.Easy3D.EZMapLeveler.Preserve3DPosition ( self )

Sets/Gets whether the position of the 3D data is to be preserved when performing leveling.

If this is true, the image corresponding to the data will be transformed but the ZMap's metadata will compensate the transformation. This means the point clouds corresponding from the input and leveled ZMap are the same.

If this is false, the z = 0 plane in the leveled ZMap represents:

the plane defined by the region argument of eVision.Easy3D.EZMapLeveler.Level when it is specified.
the plane used for leveling (i.e. the plane lying slightly below the object) when the projection direction argument of eVision.Easy3D.EZMapLeveler.Level is specified.

Default: true.

◆ Preserve3DPosition() [2/2]

eVision.Easy3D.EZMapLeveler.Preserve3DPosition	(		self,
		bool	value )

Sets/Gets whether the position of the 3D data is to be preserved when performing leveling.

If this is true, the image corresponding to the data will be transformed but the ZMap's metadata will compensate the transformation. This means the point clouds corresponding from the input and leveled ZMap are the same.

If this is false, the z = 0 plane in the leveled ZMap represents:

the plane defined by the region argument of eVision.Easy3D.EZMapLeveler.Level when it is specified.
the plane used for leveling (i.e. the plane lying slightly below the object) when the projection direction argument of eVision.Easy3D.EZMapLeveler.Level is specified.

Default: true.

◆ PreserveZResolutionFailureHandler() [1/2]

eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler eVision.Easy3D.EZMapLeveler.PreserveZResolutionFailureHandler ( self )

Gets/Sets the method to handle failures in eVision.Easy3D.EZMapLeveler.Level when preserving the source eVision.Easy3D.EZMap Z resolution (eVision.Easy3D.EZMapLeveler.PreservationModes set to eVision.Easy3D.EPreservationMode.ZResolution).

If the source resolution is too small to represent the whole 3D data, the data may be cropped, saturated or an exception may be thrown. By default, data is cropped.

◆ PreserveZResolutionFailureHandler() [2/2]

eVision.Easy3D.EZMapLeveler.PreserveZResolutionFailureHandler	(		self,
		eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler	value )

Gets/Sets the method to handle failures in eVision.Easy3D.EZMapLeveler.Level when preserving the source eVision.Easy3D.EZMap Z resolution (eVision.Easy3D.EZMapLeveler.PreservationModes set to eVision.Easy3D.EPreservationMode.ZResolution).

If the source resolution is too small to represent the whole 3D data, the data may be cropped, saturated or an exception may be thrown. By default, data is cropped.

◆ Save() [1/2]

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

Saves the eVision.Easy3D.EZMapLeveler object.

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

Parameters

serializer The eVision.ESerializer object that is written to.

◆ Save() [2/2]

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

Saves the eVision.Easy3D.EZMapLeveler object.

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

Parameters

path	The file path.

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/2]

◆ __init__() [2/2]

Member Function Documentation

◆ Level() [1/16]

◆ Level() [2/16]

◆ Level() [3/16]

◆ Level() [4/16]

◆ Level() [5/16]

◆ Level() [6/16]

◆ Level() [7/16]

◆ Level() [8/16]

◆ Level() [9/16]

◆ Level() [10/16]

◆ Level() [11/16]

◆ Level() [12/16]

◆ Level() [13/16]

◆ Level() [14/16]

◆ Level() [15/16]

◆ Level() [16/16]

◆ Load() [1/2]

◆ Load() [2/2]

◆ PreservationModes() [1/2]

◆ PreservationModes() [2/2]

◆ Preserve3DPosition() [1/2]

◆ Preserve3DPosition() [2/2]

◆ PreserveZResolutionFailureHandler() [1/2]

◆ PreserveZResolutionFailureHandler() [2/2]

◆ Save() [1/2]

◆ Save() [2/2]

◆ init() [1/2]

◆ init() [2/2]