EZMap Class

Represents a generic ZMap type interface.

Derived Class(es):EZMap16EZMap32fEZMap8

Namespace: Euresys::Open_eVision::Easy3D

Methods

Adds a metadata key (name) and value.
If the metadata key already exists, its value will be overwritten.
Clears the ZMap: replaces all pixels with the undefined value.
Factory method to allocates and reads a ZMap from a file. Depending of the serialized EZMap type, it returns the corresponding EZMap8, EZMap16 or EZMap32f object. The allocated EZMap must be released after use.
Draws an EZMap in a device context.
Displays the internal image buffer
Retrieves the pointer to the internal pixel buffer.
Retrieves the pointer to the pixel buffer.
Access ZMap Height.
E3DTransformMatrix that transforms positions from the EZMap space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.
Returns the string value of the given metadata.
Throws an exception if it does not exist.
Gets the resolution of the EZMap along the X, Y and Z axis.
On the Z axis, the resolution is the number of metric units per grey value.
On the X and Y axis, the resolution is the number of metric units per pixel.
Returns the buffer row pitch.
Returns the dimensions of the EZMap in real world space (e.g metric unit).
Pixel accessor type.
Access ZMap Width.
Returns the 3D world position corresponding to a EZMap 2D coordinate. The world position is in the original point cloud space. (x,y) is the ZMap position (which has the same scale as the world space). The value at position (x, y) must not be undefined in the EZMap, otherwise an exception will be thrown.
Returns the 3D world position corresponding to a EZMap pixel position. The world position is in the original point cloud space. The pixel space origin is at the upper left corner of the image and ranges to (width-1, height-1). The transformation to the world position is calculated using the center of the pixel. The pixel value at position (u,v) must not be undefined, otherwise an exception will be thrown.
Returns the EWorldShape for conversion between 2D image and 2D world space coordinates. This EWorldShape can be used by EasyGauge to do measurements on a EZMap in real space coordinates (e.g mm).
Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.
Resolution of the EZMap along the X axis
The resolution is the number of metric units per pixel.
Resolution of the EZMap along the Y axis
The resolution is the number of metric units per pixel.
Returns the corresponding EZMap 3D position of a ZMap pixel. The ZMap position is in the original point ZMap space. The pixel position origin is the upper left corner of the image and ranges to (width-1, height-1). The center of the pixel is used for the transformation to the ZMap position. Pixel at position (u,v) must be defined, otherwise an exception will be thrown.
Resolution of the EZMap along the Z axis
The resolution is the number of metric units per grey value.
Transforms a floating point (sub)pixel image position to a 3D world position.
The image space origin is at the upper left corner of the image and the X/Y unit size is one pixel.
The pixel Z value is in grey scale values (its range depends on the ZMap type).
Converts a 2D image (sub)pixel coordinate to the EZMap space.
(u,v) is the pixel position (with its origin in the upper left corner of the image).
(x,y) is the corresponding ZMap position (which has the same scale as the world space).
All values are expressed in floating point numbers.
Tests if the EZMap object size is zero.
Restores the EZMap stored in the given Open eVision file.
Restores the EZMap image stored in the given image file.
Loads image format and Metadata in JSON format.
Loads Metadata in JSON format.
Reset the world transformation, Map to World and World to Map matrices become identity matrix.
Saves the EZMap object to the given Open eVision file.
Saves the EZMap image to the given image file.
Saves image format and Metadata JSON format.
Saves Metadata in JSON format.
Sets the pointer to an externally allocated image buffer.
Access ZMap Height.
E3DTransformMatrix that transforms positions from the EZMap space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.
Sets the resolution of the EZMap along the X, Y and Z axis.
On the Z axis, the resolution is the number of metric units per grey value.
On the X and Y axis, the resolution is the number of metric units per pixel.
Sets the width and height of the EZMap.
Access ZMap Width.
Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.
Resolution of the EZMap along the X axis
The resolution is the number of metric units per pixel.
Resolution of the EZMap along the Y axis
The resolution is the number of metric units per pixel.
Resolution of the EZMap along the Z axis
The resolution is the number of metric units per grey value.
Transforms a 3D world position to a floating point (sub)pixel image position.
The image space origin is at the upper left corner of the image and the X/Y unit size is one pixel.
The Z value is given in grey scale value.
Returns true if the pixel position is inside the image limits and the Z value is positive.
The parameter pixelPt is filled even if the point is outside the image.
Transforms a 3D world position to a 3D EZMap position.
The ZMap space origin is at the lower left corner of the image.
The scales of the world space and ZMap space are the same.
Converts a 2D coordinate in the EZMap space to image (sub)pixel space.
(x,y) is the ZMap position (which has the same scale as the world space).
(u,v) is the corresponding pixel position (with its origin in the upper left corner of the image).
All values are expressed in floating point numbers.
Returns true if the pixel position is inside the image limits.
Transforms a 3D EZMap position to a 3D world space position.
The ZMap space origin is at the lower left corner of the image.

EZMap Class

Represents a generic ZMap type interface.

Derived Class(es):EZMap16EZMap32fEZMap8

Namespace: Euresys.Open_eVision.Easy3D

Properties

Access ZMap Height.
E3DTransformMatrix that transforms positions from the EZMap space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.
Returns the buffer row pitch.
Pixel accessor type.
Access ZMap Width.
Returns the EWorldShape for conversion between 2D image and 2D world space coordinates. This EWorldShape can be used by EasyGauge to do measurements on a EZMap in real space coordinates (e.g mm).
Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.
Resolution of the EZMap along the X axis
The resolution is the number of metric units per pixel.
Resolution of the EZMap along the Y axis
The resolution is the number of metric units per pixel.
Resolution of the EZMap along the Z axis
The resolution is the number of metric units per grey value.

Methods

Adds a metadata key (name) and value.
If the metadata key already exists, its value will be overwritten.
Clears the ZMap: replaces all pixels with the undefined value.
Factory method to allocates and reads a ZMap from a file. Depending of the serialized EZMap type, it returns the corresponding EZMap8, EZMap16 or EZMap32f object. The allocated EZMap must be released after use.
Draws an EZMap in a device context.
Displays the internal image buffer
Retrieves the pointer to the internal pixel buffer.
Retrieves the pointer to the pixel buffer.
Returns the string value of the given metadata.
Throws an exception if it does not exist.
Gets the resolution of the EZMap along the X, Y and Z axis.
On the Z axis, the resolution is the number of metric units per grey value.
On the X and Y axis, the resolution is the number of metric units per pixel.
Returns the dimensions of the EZMap in real world space (e.g metric unit).
Returns the 3D world position corresponding to a EZMap 2D coordinate. The world position is in the original point cloud space. (x,y) is the ZMap position (which has the same scale as the world space). The value at position (x, y) must not be undefined in the EZMap, otherwise an exception will be thrown.
Returns the 3D world position corresponding to a EZMap pixel position. The world position is in the original point cloud space. The pixel space origin is at the upper left corner of the image and ranges to (width-1, height-1). The transformation to the world position is calculated using the center of the pixel. The pixel value at position (u,v) must not be undefined, otherwise an exception will be thrown.
Returns the corresponding EZMap 3D position of a ZMap pixel. The ZMap position is in the original point ZMap space. The pixel position origin is the upper left corner of the image and ranges to (width-1, height-1). The center of the pixel is used for the transformation to the ZMap position. Pixel at position (u,v) must be defined, otherwise an exception will be thrown.
Transforms a floating point (sub)pixel image position to a 3D world position.
The image space origin is at the upper left corner of the image and the X/Y unit size is one pixel.
The pixel Z value is in grey scale values (its range depends on the ZMap type).
Converts a 2D image (sub)pixel coordinate to the EZMap space.
(u,v) is the pixel position (with its origin in the upper left corner of the image).
(x,y) is the corresponding ZMap position (which has the same scale as the world space).
All values are expressed in floating point numbers.
Tests if the EZMap object size is zero.
Restores the EZMap stored in the given Open eVision file.
Restores the EZMap image stored in the given image file.
Loads image format and Metadata in JSON format.
Loads Metadata in JSON format.
Reset the world transformation, Map to World and World to Map matrices become identity matrix.
Saves the EZMap object to the given Open eVision file.
Saves the EZMap image to the given image file.
Saves image format and Metadata JSON format.
Saves Metadata in JSON format.
Sets the pointer to an externally allocated image buffer.
Sets the resolution of the EZMap along the X, Y and Z axis.
On the Z axis, the resolution is the number of metric units per grey value.
On the X and Y axis, the resolution is the number of metric units per pixel.
Sets the width and height of the EZMap.
Transforms a 3D world position to a floating point (sub)pixel image position.
The image space origin is at the upper left corner of the image and the X/Y unit size is one pixel.
The Z value is given in grey scale value.
Returns true if the pixel position is inside the image limits and the Z value is positive.
The parameter pixelPt is filled even if the point is outside the image.
Transforms a 3D world position to a 3D EZMap position.
The ZMap space origin is at the lower left corner of the image.
The scales of the world space and ZMap space are the same.
Converts a 2D coordinate in the EZMap space to image (sub)pixel space.
(x,y) is the ZMap position (which has the same scale as the world space).
(u,v) is the corresponding pixel position (with its origin in the upper left corner of the image).
All values are expressed in floating point numbers.
Returns true if the pixel position is inside the image limits.
Transforms a 3D EZMap position to a 3D world space position.
The ZMap space origin is at the lower left corner of the image.