eVision.Easy3D.EZMapLeveler Class Reference

Class performing the leveling of an 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). More...

Inheritance diagram for eVision.Easy3D.EZMapLeveler:

Collaboration diagram for eVision.Easy3D.EZMapLeveler:

Public Member Functions
	EZMapLeveler ()
	Constructor of an EZMapLeveler object.
	EZMapLeveler (eVision.Easy3D.EZMapLeveler other)
	Constructor of an EZMapLeveler object.
void	Load (string path)
	Loads the EZMapLeveler object. The given ESerializer must have been created for reading.
void	Load (eVision.ESerializer serializer)
	Loads the EZMapLeveler object. The given ESerializer must have been created for reading.
void	Save (string path)
	Saves the EZMapLeveler object. The given ESerializer must have been created for writing.
void	Save (eVision.ESerializer serializer)
	Saves the EZMapLeveler object. The given ESerializer must have been created for writing.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (eVision.Easy3D.EZMap source, eVision.ERegion region, eVision.Easy3D.EZMap destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (eVision.Easy3D.EZMap source, eVision.ERegion region, eVision.Easy3D.EZMap destination)
	Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (eVision.Easy3D.EZMap source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap destination, float rotationAngle)
	Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.
void	Level (eVision.Easy3D.EZMap source, eVision.Easy3D.E3DPoint projectionDirection, eVision.Easy3D.EZMap destination)
	Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

Properties
int	PreservationModes [get, set]
	Sets/Gets what settings are preserved between the source and destination ZMaps. See EPreservationMode for more information. Defaults to EPreservationMode.EPreservationMode_XYResolution.
eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler	PreserveZResolutionFailureHandler [get, set]
	Gets/Sets the method to handle failures in EZMapLeveler.Level when preserving the source EZMap Z resolution (EZMapLeveler.PreservationModes set to EPreservationMode.EPreservationMode_ZResolution).
bool	Preserve3DPosition [get, set]
	Sets/Gets whether the position of the 3D data is to be preserved when performing leveling.

Detailed Description

Class performing the leveling of an 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).

License(s): Easy3D

Constructor & Destructor Documentation

EZMapLeveler() [1/2]

eVision.Easy3D.EZMapLeveler.EZMapLeveler

(

)

Constructor of an EZMapLeveler object.

EZMapLeveler() [2/2]

eVision.Easy3D.EZMapLeveler.EZMapLeveler

(

eVision.Easy3D.EZMapLeveler

other

)

Constructor of an EZMapLeveler object.

Parameters

other

Reference to the EZMapLeveler used for the initialization.

Member Function Documentation

Level() [1/16]

void eVision.Easy3D.EZMapLeveler.Level	(	eVision.Easy3D.EZMap	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap	destination )

Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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.

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

Level() [2/16]

void eVision.Easy3D.EZMapLeveler.Level	(	eVision.Easy3D.EZMap	source,
		eVision.Easy3D.E3DPoint	projectionDirection,
		eVision.Easy3D.EZMap	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 Easy.AngleUnit.

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

Level() [3/16]

void eVision.Easy3D.EZMapLeveler.Level	(	eVision.Easy3D.EZMap	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap	destination )

Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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

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

Level() [4/16]

void eVision.Easy3D.EZMapLeveler.Level	(	eVision.Easy3D.EZMap	source,
		eVision.ERegion	region,
		eVision.Easy3D.EZMap	destination,
		float	rotationAngle )

Levels the given source ZMap in the destination ZMap. Given a ZMap and an ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 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 Easy.AngleUnit.

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

Level() [5/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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.

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

Level() [6/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 Easy.AngleUnit.

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

Level() [7/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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

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

Level() [8/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 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 Easy.AngleUnit.

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

Level() [9/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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.

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

Level() [10/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 Easy.AngleUnit.

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

Level() [11/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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

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

Level() [12/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 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 Easy.AngleUnit.

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

Level() [13/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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.

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

Level() [14/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 Easy.AngleUnit.

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

Level() [15/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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

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

Level() [16/16]

void eVision.Easy3D.EZMapLeveler.Level	(	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 ERegion, the E3DPlane contained in the ERegion is extracted and the ZMap is re-projected along that plane's normal. If an E3DPoint is given instead of the 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.

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 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 Easy.AngleUnit.

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

Load() [1/2]

void eVision.Easy3D.EZMapLeveler.Load

(

eVision.ESerializer

serializer

)

Loads the EZMapLeveler object. The given ESerializer must have been created for reading.

Parameters

serializer

The serializer.

Load() [2/2]

void eVision.Easy3D.EZMapLeveler.Load

(

string

path

)

Loads the EZMapLeveler object. The given ESerializer must have been created for reading.

Parameters

path	The file path.

Save() [1/2]

void eVision.Easy3D.EZMapLeveler.Save

(

eVision.ESerializer

serializer

)

Saves the EZMapLeveler object. The given ESerializer must have been created for writing.

Parameters

serializer

The ESerializer object that is written to.

Save() [2/2]

void eVision.Easy3D.EZMapLeveler.Save

(

string

path

)

Saves the EZMapLeveler object. The given ESerializer must have been created for writing.

Parameters

path	The file path.

Property Documentation

PreservationModes

int eVision.Easy3D.EZMapLeveler.PreservationModes

getset

Sets/Gets what settings are preserved between the source and destination ZMaps. See EPreservationMode for more information. Defaults to EPreservationMode.EPreservationMode_XYResolution.

Preserve3DPosition

bool eVision.Easy3D.EZMapLeveler.Preserve3DPosition

getset

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 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 EZMapLeveler.Level is specified.

Default: true.

PreserveZResolutionFailureHandler

eVision.Easy3D.EZMapGeneratorZResolutionFailureHandler eVision.Easy3D.EZMapLeveler.PreserveZResolutionFailureHandler

getset

Gets/Sets the method to handle failures in EZMapLeveler.Level when preserving the source EZMap Z resolution (EZMapLeveler.PreservationModes set to EPreservationMode.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.