eVision::Easy3D::EZMap16 Class Reference

A ZMap16 is a 16bits corrected 2.5D image. More...

#include <eVision/Easy3D/EZMap16.h>

Inheritance diagram for eVision::Easy3D::EZMap16:

Collaboration diagram for eVision::Easy3D::EZMap16:

Public Member Functions
	EZMap16 ()
	Creates a 16 bits EZMap.
	EZMap16 (int32_t width, int32_t height)
	Creates a 16 bits EZMap.
	EZMap16 (const eVision::Easy3D::EZMap16 &other)
	Creates a 16 bits EZMap.
virtual	~EZMap16 () throw ()
eVision::Easy3D::EZMap16 &	operator= (const eVision::Easy3D::EZMap16 &other)
	Assignment operator.
virtual void	Clear ()
	Clears the ZMap: replaces all pixels with the undefined value.
eVision::EDepth16	GetUndefinedValue () const
	Returns the Undefined value. That value is used to set to mark pixels with no valid depth value.
void	FillUndefinedPixelsWithMedian (eVision::Easy3D::EZMap16 &outMap, uint32_t halfOfKernelWidth, uint32_t halfOfKernelHeight) const
	Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.
void	FillUndefinedPixelsWithMedian (eVision::Easy3D::EZMap16 &outMap, uint32_t halfOfKernelWidth) const
	Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.
void	FillUndefinedPixelsWithMedian (eVision::Easy3D::EZMap16 &outMap) const
	Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.
void	FillUndefinedPixels (eVision::Easy3D::EZMap16 &outMap, eVision::Easy3D::EFillUndefinedPixelsDirection direction, eVision::Easy3D::EFillUndefinedPixelsMethod method) const
	Fills undefined pixels, used to fill the "holes" in the ZMap.
void	FillUndefinedPixels (eVision::Easy3D::EZMap16 &outMap, eVision::Easy3D::EFillUndefinedPixelsDirection direction) const
	Fills undefined pixels, used to fill the "holes" in the ZMap.
void	FillUndefinedPixels (eVision::Easy3D::EZMap16 &outMap) const
	Fills undefined pixels, used to fill the "holes" in the ZMap.
virtual const eVision::Legacy::EWorldShape &	GetWorldShape () const
	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 EZMap16 in real space coordinates (e.g mm).
virtual const eVision::Easy3D::E3DTransformMatrix &	GetMapToWorldMatrix () const
	E3DTransformMatrix that transforms positions from the EZMap16 space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.
virtual const eVision::Easy3D::E3DTransformMatrix &	GetWorldToMapMatrix () const
	Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap16 space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.
virtual void	ResetWorldTransformation ()
	Reset the world transformation, Map to World and World to Map matrices become identity matrix.
virtual void	SetMapToWorldMatrix (const eVision::Easy3D::E3DTransformMatrix &matrix)
	E3DTransformMatrix that transforms positions from the EZMap16 space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.
virtual void	SetWorldToMapMatrix (const eVision::Easy3D::E3DTransformMatrix &matrix)
	Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap16 space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.
virtual eVision::Easy3D::E3DPoint	GetWorldPositionFromPixelPosition (int32_t u, int32_t v) const
	Returns the 3D world position corresponding to a EZMap16 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.
virtual eVision::Easy3D::E3DPoint	GetWorldPositionFromMapPosition (float x, float y) const
	Returns the 3D world position corresponding to a EZMap16 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 EZMap16, otherwise an exception will be thrown.
virtual eVision::Easy3D::E3DPoint	GetZMapPositionFromPixelPosition (int32_t u, int32_t v) const
	Returns the corresponding EZMap16 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.
virtual eVision::EFrame	GetZMapPositionFrame () const
	Returns the EFrame from which the EZMap16 position of a pixel can be retrieved. The ZMap position is in the original point ZMap space.
bool	GetPixelPositionFromWorldPosition (const eVision::Easy3D::E3DPoint &world_position, eVision::EIntPoint &zmapPosition, eVision::EDepth16 &value) const
	Returns the EZMap16 values corresponding to a 3D world position.
bool	GetPixelPositionFromWorldPosition (const eVision::Easy3D::E3DPoint &world_position, int32_t &u, int32_t &v, eVision::EDepth16 &value) const
	Returns the EZMap16 values corresponding to a 3D world position.
virtual eVision::EPoint	GetSizeInWorld () const
	Returns the dimensions of the EZMap16 in real world space (e.g metric unit).
virtual void	GetSizeInWorld (float &worldWidth, float &worldHeight) const
	Returns the dimensions of the EZMap16 in real world space (e.g metric unit).
virtual void	SetResolution (eVision::Easy3D::E3DPoint resolution)
	Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.
virtual eVision::Easy3D::E3DPoint	GetResolution () const
	Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.
virtual void	SetResolution (float rx, float ry, float rz)
	Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.
virtual void	GetResolution (float &sx, float &sy, float &sz) const
	Gets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.
virtual void	SetXResolution (float resolution)
	Resolution of the EZMap16 along the X axis.
virtual float	GetXResolution () const
	Resolution of the EZMap16 along the X axis.
virtual void	SetYResolution (float resolution)
	Resolution of the EZMap16 along the Y axis.
virtual float	GetYResolution () const
	Resolution of the EZMap16 along the Y axis.
virtual void	SetZResolution (float resolution)
	Resolution of the EZMap16 along the Z axis.
virtual float	GetZResolution () const
	Resolution of the EZMap16 along the Z axis.
void	GetZRange (eVision::EBW16 &min, eVision::EBW16 &max) const
	Compute the minimum and maximum pixel values, excluding the undefined pixels.
virtual void	ImageToZMap (const eVision::EPoint &uv, eVision::EPoint &xy) const
	Converts a 2D image (sub)pixel coordinate to the EZMap16 space.
virtual void	ImageToZMap (float u, float v, float &x, float &y) const
	Converts a 2D image (sub)pixel coordinate to the EZMap16 space.
virtual bool	ZMapToImage (const eVision::EPoint &xy, eVision::EPoint &uv) const
	Converts a 2D coordinate in the EZMap16 space to image (sub)pixel space.
virtual bool	ZMapToImage (float x, float y, float &u, float &v) const
	Converts a 2D coordinate in the EZMap16 space to image (sub)pixel space.
virtual void	WorldToZMap (const eVision::Easy3D::E3DPoint &worldPt, eVision::Easy3D::E3DPoint &zmapPt) const
	Transforms a 3D world position to a 3D EZMap16 position.
virtual void	ZMapToWorld (const eVision::Easy3D::E3DPoint &zmapPt, eVision::Easy3D::E3DPoint &worldPt) const
	Transforms a 3D EZMap16 position to a 3D world space position.
virtual bool	WorldToImage (const eVision::Easy3D::E3DPoint &worldPt, eVision::Easy3D::E3DPoint &pixelPt) const
	Transforms a 3D world position to a floating point (sub)pixel image position.
virtual void	ImageToWorld (const eVision::Easy3D::E3DPoint &pixelPoint, eVision::Easy3D::E3DPoint &worldPoint) const
	Transforms a floating point (sub)pixel image position to a 3D world position.
virtual void	ImageToWorld (const eVision::EPoint &pixel2DPoint, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint &worldPoint) const
	Transforms a floating point (sub)pixel image position to a 3D world position.
virtual void	ImageToWorld (const eVision::EPoint &pixel2DPoint, const eVision::EFrame &frame, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint &worldPoint) const
	Transforms a floating point (sub)pixel image position to a 3D world position.
virtual void	ImageToWorld (const eVision::EPoint &pixel2DPoint, eVision::Easy3D::EZMapImageToWorldKernel kernel, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint &worldPoint) const
	Transforms a floating point (sub)pixel image position to a 3D world position.
virtual void	ImageToWorld (const eVision::EPoint &pixel2DPoint, const eVision::EFrame &frame, eVision::Easy3D::EZMapImageToWorldKernel kernel, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint &worldPoint) const
	Transforms a floating point (sub)pixel image position to a 3D world position.
virtual void	Load (const std::string &path)
	Restores the EZMap16 stored in the given eVision file.
virtual void	Load (eVision::ESerializer *serializer)
	Restores the EZMap16 stored in the given eVision file.
virtual void	LoadImage (const std::string &path, bool withMetadata)
	Restores the EZMap16 image stored in the given image file.
virtual void	LoadImage (const std::string &path)
	Restores the EZMap16 image stored in the given image file.
virtual void	Save (const std::string &path) const
	Saves the EZMap16 object to the given eVision file.
virtual void	Save (eVision::ESerializer *serializer) const
	Saves the EZMap16 object to the given eVision file.
virtual void	SaveImage (const std::string &path, eVision::EImageFileType type, bool withMetadata) const
	Saves the EZMap16 image to the given image file.
virtual void	SaveImage (const std::string &path, eVision::EImageFileType type) const
	Saves the EZMap16 image to the given image file.
virtual void	SaveImage (const std::string &path) const
	Saves the EZMap16 image to the given image file.
virtual void	LoadMetadata (const std::string &path)
	Loads Metadata in JSON format.
virtual void	SaveMetadata (const std::string &path)
	Saves Metadata in JSON format.
virtual void	LoadImageAndMetadata (const std::string &pathImage, const std::string &pathMetadata)
	Loads image format and Metadata in JSON format.
virtual void	SaveImageAndMetadata (const std::string &pathImage, const std::string &pathMetadata, eVision::EImageFileType type) const
	Saves image format and Metadata JSON format.
virtual void	SaveImageAndMetadata (const std::string &pathImage, const std::string &pathMetadata) const
	Saves image format and Metadata JSON format.
virtual void	AddMetadata (const std::string &Key, const std::string &value)
	Adds a metadata key (name) and value.
virtual void	ModifyMetadata (const std::string &Key, const std::string &value)
	Changes an existing metadata key and value. Throws an exception if it does not exist.
virtual std::string	GetMetadata (const std::string &Key) const
	Returns the string value of the given metadata.
virtual void	DeleteMetadata (const std::string &Key)
	Deletes value of this existing metadata key . Throws an exception if it does not exist.
virtual void	ClearMetadata ()
	Deletes all metadata.
void	CopyMetadataTo (eVision::Easy3D::EZMap16 &other) const
	Copies all metadata.
virtual int32_t	GetWidth () const
	Access ZMap Width.
virtual void	SetWidth (int32_t width)
	Access ZMap Width.
virtual int32_t	GetHeight () const
	Access ZMap Height.
virtual void	SetHeight (int32_t height)
	Access ZMap Height.
virtual bool	IsVoid () const
	Tests if the EZMap16 object size is zero.
eVision::EImageBW16 &	AsEImage ()
	Returns the EZMap16 as an EImageBW16 (16 bits gray scale) to use with existing eVision 2D tools.
const eVision::EImageBW16 &	AsEImage () const
	Returns the EZMap16 as an EImageBW16 (16 bits gray scale) to use with existing eVision 2D tools.
virtual int32_t	GetRowPitch () const
	Returns the buffer row pitch.
virtual void *	GetBufferPtr ()
	Retrieves the pointer to the internal pixel buffer.
virtual void *	GetBufferPtr (int32_t x, int32_t y)
	Retrieves the pointer to the internal pixel buffer.
virtual const void *	GetBufferPtr () const
	Retrieves the pointer to the internal pixel buffer.
virtual const void *	GetBufferPtr (int32_t x, int32_t y) const
	Retrieves the pointer to the internal pixel buffer.
virtual void *	GetCheckedBufferPtr (int32_t x, int32_t y)
	Retrieves the pointer to the pixel buffer.
virtual const void *	GetCheckedBufferPtr (int32_t x, int32_t y) const
	Retrieves the pointer to the pixel buffer.
virtual eVision::EImageType	GetType () const
	Pixel accessor type.
eVision::EDepth16	GetPixel (int32_t x, int32_t y) const
	Gets the value of a pixel .
float	GetZValue (const int32_t x, const int32_t y) const
	Gets Z value (in metric coordinate) at pixel coordinates.
void	SetZValue (const float value, const int32_t x, const int32_t y)
	Sets Z value (in metric coordinate) at pixel coordinates.
void	SetPixel (eVision::EDepth16 value, int32_t x, int32_t y)
	Sets the value of a pixel .
virtual void	SetBufferPtr (int32_t width, int32_t height, void *imagePointer, int32_t bitsPerRow)
	Sets the pointer to an externally allocated image buffer.
virtual void	SetBufferPtr (int32_t width, int32_t height, void *imagePointer)
	Sets the pointer to an externally allocated image buffer.
virtual void	UseExternalBuffer (int32_t width, int32_t height, void *buffer, int32_t rowPitch)
	Sets the pointer to an externally allocated buffer.
virtual void	SetSize (int32_t width, int32_t height)
	Sets the width and height of the EZMap16.
virtual void	SetSize (const eVision::Easy3D::EZMap &other)
	Sets the width and height of the EZMap16.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector) const
	Draws an EZMap16 in a device context.
virtual void	Draw (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector) const
	Draws an EZMap16 in a device context.
virtual void	Draw (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Draws an EZMap16 in a device context.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EC24Vector *c24Vector) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (eVision::EDrawAdapter *graphicContext, eVision::EBW8Vector *bw8Vector) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EC24Vector *c24Vector) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX, float panY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY, float panX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX, float zoomY) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector, float zoomX) const
	Displays the internal image buffer.
virtual void	DrawImage (HDC graphicContext, eVision::EBW8Vector *bw8Vector) const
	Displays the internal image buffer.
virtual eVision::EPoint	ConvertCoordinatesPixelToMap (eVision::EIntPoint pixelCoordinates) const
	Converts Pixel coordinates to 3D Map coordinates.
virtual void	ConvertCoordinatesPixelToMap (int xBuffer, int yBuffer, float &x3D, float &y3D) const
	Converts Pixel coordinates to 3D Map coordinates.
virtual bool	ConvertCoordinatesMapToPixel (float x3D, float y3D, int &xBuffer, int &yBuffer) const
	Converts 3D Map coordinates to Pixel coordinates.
virtual bool	ConvertCoordinatesMapToPixel (const eVision::EPoint &mapCoordinates, eVision::EIntPoint &pixelCoordinates) const
	Converts 3D Map coordinates to Pixel coordinates.
	EZMap16 (CppWrapperInternal::InternalConstructor)
Public Member Functions inherited from eVision::Easy3D::EZMap
virtual	~EZMap () throw ()
eVision::Easy3D::E3DPlane	GetProjectionPlane () const
	Retrieves the E3DPlane on which the ZMap was projected.
	EZMap (CppWrapperInternal::InternalConstructor)

Additional Inherited Members
Static Public Member Functions inherited from eVision::Easy3D::EZMap
static std::unique_ptr< eVision::Easy3D::EZMap >	Create (const std::string &path)
	Factory method to allocate and read a ZMap from a file. Depending on the serialized EZMap type, it returns the corresponding EZMap8, EZMap16 or EZMap32f object. The allocated EZMap must be released after use.
Public Attributes inherited from eVision::Easy3D::EZMap
CppWrapperInternal::WrappedClass	wrappedClass_

Detailed Description

A ZMap16 is a 16bits corrected 2.5D image.

ZMap Pixel values (16 bits integers) represent distances from a 3D reference plane. Distances are positive, during the ZMap generation all points below the reference plane are discarded. The EZMap class also stores the transformation from the pixel coordinates to the real world coordinate system. There could be undefined pixels in the ZMap.

License(s): Easy3D

Constructor & Destructor Documentation

EZMap16() [1/4]

eVision::Easy3D::EZMap16::EZMap16

(

)

Creates a 16 bits EZMap.

EZMap16() [2/4]

eVision::Easy3D::EZMap16::EZMap16	(	int32_t	width,
		int32_t	height )

Creates a 16 bits EZMap.

Parameters

width	The width of the new ZMap.
height	The height of the new ZMap.

EZMap16() [3/4]

eVision::Easy3D::EZMap16::EZMap16

(

const eVision::Easy3D::EZMap16 &

other

)

Creates a 16 bits EZMap.

Parameters

other

Another ZMap.

~EZMap16()

eVision::Easy3D::EZMap16::~EZMap16 ( ) throw (  )

virtual

EZMap16() [4/4]

eVision::Easy3D::EZMap16::EZMap16

(

CppWrapperInternal::InternalConstructor

)

Member Function Documentation

AddMetadata()

void eVision::Easy3D::EZMap16::AddMetadata ( const std::string & Key, const std::string & value )

virtual

Adds a metadata key (name) and value.

If the metadata key already exists, its value will be overwritten.

Parameters

Key	The name of the metadata. Names are unique.
value	The value for the given metadata.

Implements eVision::Easy3D::EZMap.

AsEImage() [1/2]

eVision::EImageBW16 & eVision::Easy3D::EZMap16::AsEImage

(

)

Returns the EZMap16 as an EImageBW16 (16 bits gray scale) to use with existing eVision 2D tools.

AsEImage() [2/2]

const eVision::EImageBW16 & eVision::Easy3D::EZMap16::AsEImage

(

)

const

Returns the EZMap16 as an EImageBW16 (16 bits gray scale) to use with existing eVision 2D tools.

Clear()

void eVision::Easy3D::EZMap16::Clear ( )

virtual

Clears the ZMap: replaces all pixels with the undefined value.

Implements eVision::Easy3D::EZMap.

ClearMetadata()

void eVision::Easy3D::EZMap16::ClearMetadata ( )

virtual

Deletes all metadata.

ConvertCoordinatesMapToPixel() [1/2]

bool eVision::Easy3D::EZMap16::ConvertCoordinatesMapToPixel ( const eVision::EPoint & mapCoordinates, eVision::EIntPoint & pixelCoordinates ) const

virtual

Converts 3D Map coordinates to Pixel coordinates.

Parameters

mapCoordinates	The map coordinates to convert from.
pixelCoordinates	The pixel coordinates to convert to.

Implements eVision::Easy3D::EZMap.

ConvertCoordinatesMapToPixel() [2/2]

bool eVision::Easy3D::EZMap16::ConvertCoordinatesMapToPixel ( float x3D, float y3D, int & xBuffer, int & yBuffer ) const

virtual

Converts 3D Map coordinates to Pixel coordinates.

Parameters

x3D	The Map X coordinate.
y3D	The Map Y coordinate.
xBuffer	The returned Pixel X coordinate.
yBuffer	The returned Pixel Y coordinate.

Deprecated

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

Implements eVision::Easy3D::EZMap.

ConvertCoordinatesPixelToMap() [1/2]

eVision::EPoint eVision::Easy3D::EZMap16::ConvertCoordinatesPixelToMap ( eVision::EIntPoint pixelCoordinates ) const

virtual

Converts Pixel coordinates to 3D Map coordinates.

Parameters

pixelCoordinates

The pixel coordinates to convert.

Implements eVision::Easy3D::EZMap.

ConvertCoordinatesPixelToMap() [2/2]

void eVision::Easy3D::EZMap16::ConvertCoordinatesPixelToMap ( int xBuffer, int yBuffer, float & x3D, float & y3D ) const

virtual

Converts Pixel coordinates to 3D Map coordinates.

Parameters

xBuffer	The pixel X coordinate.
yBuffer	The pixel Y coordinate.
x3D	The returned Map X coordinate.
y3D	The returned Map Y coordinate.

Deprecated

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

Implements eVision::Easy3D::EZMap.

CopyMetadataTo()

void eVision::Easy3D::EZMap16::CopyMetadataTo

(

eVision::Easy3D::EZMap16 &

other

)

const

Copies all metadata.

Parameters

other

An other EZMap16.

DeleteMetadata()

void eVision::Easy3D::EZMap16::DeleteMetadata ( const std::string & Key )

virtual

Deletes value of this existing metadata key . Throws an exception if it does not exist.

Parameters

Key	The name of an existing metadata.

Draw() [1/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext

Handle to the device context of the destination window.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [2/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [3/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [4/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [5/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [6/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [7/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [8/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [9/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [10/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [11/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [12/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [13/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [14/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [15/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [16/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [17/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [18/36]

void eVision::Easy3D::EZMap16::Draw ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

Draw() [19/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext

Handle to the device context of the destination window.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [20/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [21/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [22/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [23/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [24/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [25/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [26/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [27/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [28/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [29/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [30/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [31/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [32/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, float zoomX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [33/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, float zoomX, float zoomY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [34/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, float zoomX, float zoomY, float panX ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [35/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, float zoomX, float zoomY, float panX, float panY ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

Draw() [36/36]

void eVision::Easy3D::EZMap16::Draw ( HDC graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Draws an EZMap16 in a device context.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the ZMap is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

A ZMap can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [1/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext

Handle to the device context of the destination window.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [2/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [3/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [4/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [5/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [6/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [7/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [8/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [9/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [10/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [11/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [12/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [13/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [14/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [15/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [16/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [17/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [18/36]

void eVision::Easy3D::EZMap16::DrawImage ( eVision::EDrawAdapter * graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Implements eVision::Easy3D::EZMap.

DrawImage() [19/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext

Handle to the device context of the destination window.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [20/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [21/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [22/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [23/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [24/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [25/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EBW8Vector * bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
bw8Vector	When supplied, this parameter allows using a LUT that maps from Depth to BW8 when drawing.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [26/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [27/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [28/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [29/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [30/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [31/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, eVision::EC24Vector * c24Vector, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
c24Vector	When supplied, this parameter allows using a LUT that maps from Depth to C24 when drawing (false colors).
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [32/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, float zoomX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [33/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, float zoomX, float zoomY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [34/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, float zoomX, float zoomY, float panX ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [35/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, float zoomX, float zoomY, float panX, float panY ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

DrawImage() [36/36]

void eVision::Easy3D::EZMap16::DrawImage ( HDC graphicContext, float zoomX, float zoomY, float panX, float panY, eVision::EC24 colorUndefinedPixel ) const

virtual

Displays the internal image buffer.

Parameters

graphicContext	Handle to the device context of the destination window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in 1:1 scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning value expressed in pixels. By default, no panning occurs.
panY	Vertical panning value expressed in pixels. By default, no panning occurs.
colorUndefinedPixel	An optional parameter to choose the drawing color of undefined pixels.

An image can be drawn (its pixels rendered) using a device context. EZMap16::Draw and EZMap16::DrawImage produce the same output.

The horizontal and vertical zooming factors can be different but must be in the 1/16..16 range.

(MFC users can use the CDC::GetSafeHdc() method to obtain a suitable device context handle from a CDC instance.)

Deprecated

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

Implements eVision::Easy3D::EZMap.

FillUndefinedPixels() [1/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixels

(

eVision::Easy3D::EZMap16 &

outMap

)

const

Fills undefined pixels, used to fill the "holes" in the ZMap.

Parameters

outMap

The destination ZMap.

FillUndefinedPixels() [2/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixels	(	eVision::Easy3D::EZMap16 &	outMap,
		eVision::Easy3D::EFillUndefinedPixelsDirection	direction ) const

Fills undefined pixels, used to fill the "holes" in the ZMap.

Parameters

outMap	The destination ZMap.
direction	Direction in which the undefined pixels are filled in a ZMap from EFillUndefinedPixelsDirection.

FillUndefinedPixels() [3/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixels	(	eVision::Easy3D::EZMap16 &	outMap,
		eVision::Easy3D::EFillUndefinedPixelsDirection	direction,
		eVision::Easy3D::EFillUndefinedPixelsMethod	method ) const

Fills undefined pixels, used to fill the "holes" in the ZMap.

Parameters

outMap	The destination ZMap.
direction	Direction in which the undefined pixels are filled in a ZMap from EFillUndefinedPixelsDirection.
method	Which values used to fill the undefined pixels in a ZMap from EFillUndefinedPixelsMethod.

FillUndefinedPixelsWithMedian() [1/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixelsWithMedian

(

eVision::Easy3D::EZMap16 &

outMap

)

const

Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.

Parameters

outMap

The destination ZMap.

FillUndefinedPixelsWithMedian() [2/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixelsWithMedian	(	eVision::Easy3D::EZMap16 &	outMap,
		uint32_t	halfOfKernelWidth ) const

Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.

Parameters

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

FillUndefinedPixelsWithMedian() [3/3]

void eVision::Easy3D::EZMap16::FillUndefinedPixelsWithMedian	(	eVision::Easy3D::EZMap16 &	outMap,
		uint32_t	halfOfKernelWidth,
		uint32_t	halfOfKernelHeight ) const

Fills undefined pixels, used to fill the "holes" in the ZMap using a median rectangular kernel of odd size.

Parameters

outMap	The destination ZMap.
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).

GetBufferPtr() [1/4]

void * eVision::Easy3D::EZMap16::GetBufferPtr ( )

virtual

Retrieves the pointer to the internal pixel buffer.

This function does not check the value of the parameters. Use carefully.

Implements eVision::Easy3D::EZMap.

GetBufferPtr() [2/4]

const void * eVision::Easy3D::EZMap16::GetBufferPtr ( ) const

virtual

Retrieves the pointer to the internal pixel buffer.

This function does not check the value of the parameters. Use carefully.

Implements eVision::Easy3D::EZMap.

GetBufferPtr() [3/4]

void * eVision::Easy3D::EZMap16::GetBufferPtr ( int32_t x, int32_t y )

virtual

Retrieves the pointer to the internal pixel buffer.

Parameters

x	Column of the pixel which we want the address.
y	Row of the pixel which we want the address.

This function does not check the value of the parameters. Use carefully.

Implements eVision::Easy3D::EZMap.

GetBufferPtr() [4/4]

const void * eVision::Easy3D::EZMap16::GetBufferPtr ( int32_t x, int32_t y ) const

virtual

Retrieves the pointer to the internal pixel buffer.

Parameters

x	Column of the pixel which we want the address.
y	Row of the pixel which we want the address.

This function does not check the value of the parameters. Use carefully.

Implements eVision::Easy3D::EZMap.

GetCheckedBufferPtr() [1/2]

void * eVision::Easy3D::EZMap16::GetCheckedBufferPtr ( int32_t x, int32_t y )

virtual

Retrieves the pointer to the pixel buffer.

Parameters

x	Column of the pixel of which we want the address.
y	Row of the pixel of which we want the address.

Implements eVision::Easy3D::EZMap.

GetCheckedBufferPtr() [2/2]

const void * eVision::Easy3D::EZMap16::GetCheckedBufferPtr ( int32_t x, int32_t y ) const

virtual

Retrieves the pointer to the pixel buffer.

Parameters

x	Column of the pixel of which we want the address.
y	Row of the pixel of which we want the address.

Implements eVision::Easy3D::EZMap.

GetHeight()

int32_t eVision::Easy3D::EZMap16::GetHeight ( ) const

virtual

Access ZMap Height.

Implements eVision::Easy3D::EZMap.

GetMapToWorldMatrix()

const eVision::Easy3D::E3DTransformMatrix & eVision::Easy3D::EZMap16::GetMapToWorldMatrix ( ) const

virtual

E3DTransformMatrix that transforms positions from the EZMap16 space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.

Implements eVision::Easy3D::EZMap.

GetMetadata()

std::string eVision::Easy3D::EZMap16::GetMetadata ( const std::string & Key ) const

virtual

Returns the string value of the given metadata.

Throws an exception if it does not exist.

Parameters

Key	The name of an existing metadata.

Implements eVision::Easy3D::EZMap.

GetPixel()

eVision::EDepth16 eVision::Easy3D::EZMap16::GetPixel	(	int32_t	x,
		int32_t	y ) const

Gets the value of a pixel .

Parameters

x	Column of the pixel.
y	Row of the pixel.

GetPixelPositionFromWorldPosition() [1/2]

bool eVision::Easy3D::EZMap16::GetPixelPositionFromWorldPosition	(	const eVision::Easy3D::E3DPoint &	world_position,
		eVision::EIntPoint &	zmapPosition,
		eVision::EDepth16 &	value ) const

Returns the EZMap16 values corresponding to a 3D world position.

The world position is projected on the ZMap reference plane to get a position in the ZMap. If the projected position is outside the ZMap, the method returns false.

Parameters

world_position	The 3D coordinates of a world position.
zmapPosition	X and Y coordinates of the point in the ZMap.
value	Value of the pixel.

GetPixelPositionFromWorldPosition() [2/2]

bool eVision::Easy3D::EZMap16::GetPixelPositionFromWorldPosition	(	const eVision::Easy3D::E3DPoint &	world_position,
		int32_t &	u,
		int32_t &	v,
		eVision::EDepth16 &	value ) const

Returns the EZMap16 values corresponding to a 3D world position.

The world position is projected on the ZMap reference plane to get a position in the ZMap. If the projected position is outside the ZMap, the method returns false.

Parameters

world_position	The 3D coordinates of a world position.
u	Column of the ZMap pixel in [0,width[.
v	Row of the ZMap pixel in [0,height[.
value	Value of the pixel.

Deprecated

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

GetResolution() [1/2]

eVision::Easy3D::E3DPoint eVision::Easy3D::EZMap16::GetResolution ( ) const

virtual

Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.

For the Z axis it is expressed in metric units per grey scale value.

Implements eVision::Easy3D::EZMap.

GetResolution() [2/2]

void eVision::Easy3D::EZMap16::GetResolution ( float & sx, float & sy, float & sz ) const

virtual

Gets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.

For the Z axis it is expressed in metric units per grey scale value.

Parameters

sx	Resolution along the X axis.
sy	Resolution along the Y axis.
sz	Resolution along the Z axis.

Deprecated

Use EZMap16::SetResolution instead.

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

Implements eVision::Easy3D::EZMap.

GetRowPitch()

int32_t eVision::Easy3D::EZMap16::GetRowPitch ( ) const

virtual

Returns the buffer row pitch.

Implements eVision::Easy3D::EZMap.

GetSizeInWorld() [1/2]

eVision::EPoint eVision::Easy3D::EZMap16::GetSizeInWorld ( ) const

virtual

Returns the dimensions of the EZMap16 in real world space (e.g metric unit).

Implements eVision::Easy3D::EZMap.

GetSizeInWorld() [2/2]

void eVision::Easy3D::EZMap16::GetSizeInWorld ( float & worldWidth, float & worldHeight ) const

virtual

Returns the dimensions of the EZMap16 in real world space (e.g metric unit).

Parameters

worldWidth	Contains the size of the ZMap along the X axis (column).
worldHeight	Contains the size of the ZMap along the Y axis (row).

Deprecated

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

Implements eVision::Easy3D::EZMap.

GetType()

eVision::EImageType eVision::Easy3D::EZMap16::GetType ( ) const

virtual

Pixel accessor type.

Implements eVision::Easy3D::EZMap.

GetUndefinedValue()

eVision::EDepth16 eVision::Easy3D::EZMap16::GetUndefinedValue

(

)

const

Returns the Undefined value. That value is used to set to mark pixels with no valid depth value.

GetWidth()

int32_t eVision::Easy3D::EZMap16::GetWidth ( ) const

virtual

Access ZMap Width.

Implements eVision::Easy3D::EZMap.

GetWorldPositionFromMapPosition()

eVision::Easy3D::E3DPoint eVision::Easy3D::EZMap16::GetWorldPositionFromMapPosition ( float x, float y ) const

virtual

Returns the 3D world position corresponding to a EZMap16 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 EZMap16, otherwise an exception will be thrown.

Parameters

x	The X coordinate.
y	The Y coordinate.

Implements eVision::Easy3D::EZMap.

GetWorldPositionFromPixelPosition()

eVision::Easy3D::E3DPoint eVision::Easy3D::EZMap16::GetWorldPositionFromPixelPosition ( int32_t u, int32_t v ) const

virtual

Returns the 3D world position corresponding to a EZMap16 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.

Parameters

u	Column of the pixel (bounds: [0,width[).
v	Row of the pixel (bounds: [0,height[).

Implements eVision::Easy3D::EZMap.

GetWorldShape()

const eVision::Legacy::EWorldShape & eVision::Easy3D::EZMap16::GetWorldShape ( ) const

virtual

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 EZMap16 in real space coordinates (e.g mm).

Implements eVision::Easy3D::EZMap.

GetWorldToMapMatrix()

const eVision::Easy3D::E3DTransformMatrix & eVision::Easy3D::EZMap16::GetWorldToMapMatrix ( ) const

virtual

Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap16 space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.

Implements eVision::Easy3D::EZMap.

GetXResolution()

float eVision::Easy3D::EZMap16::GetXResolution ( ) const

virtual

Resolution of the EZMap16 along the X axis.

The resolution is the number of metric units per pixel.

Implements eVision::Easy3D::EZMap.

GetYResolution()

float eVision::Easy3D::EZMap16::GetYResolution ( ) const

virtual

Resolution of the EZMap16 along the Y axis.

The resolution is the number of metric units per pixel.

Implements eVision::Easy3D::EZMap.

GetZMapPositionFrame()

eVision::EFrame eVision::Easy3D::EZMap16::GetZMapPositionFrame ( ) const

virtual

Returns the EFrame from which the EZMap16 position of a pixel can be retrieved. The ZMap position is in the original point ZMap space.

The returned EFrame may be used to perform 2D analysis in metric space, for example EasyGauge.

Implements eVision::Easy3D::EZMap.

GetZMapPositionFromPixelPosition()

eVision::Easy3D::E3DPoint eVision::Easy3D::EZMap16::GetZMapPositionFromPixelPosition ( int32_t u, int32_t v ) const

virtual

Returns the corresponding EZMap16 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.

Parameters

u	Column of the pixel (bounds: [0,width[).
v	Row of the pixel (bounds: [0,height[).

Implements eVision::Easy3D::EZMap.

GetZRange()

void eVision::Easy3D::EZMap16::GetZRange	(	eVision::EBW16 &	min,
		eVision::EBW16 &	max ) const

Compute the minimum and maximum pixel values, excluding the undefined pixels.

Parameters

min	The lowest pixel value.
max	The highest pixel value.

GetZResolution()

float eVision::Easy3D::EZMap16::GetZResolution ( ) const

virtual

Resolution of the EZMap16 along the Z axis.

The resolution is the number of metric units per grey value.

Implements eVision::Easy3D::EZMap.

GetZValue()

float eVision::Easy3D::EZMap16::GetZValue	(	const int32_t	x,
		const int32_t	y ) const

Gets Z value (in metric coordinate) at pixel coordinates.

Parameters

x	X Coordinate.
y	Y Coordinate.

ImageToWorld() [1/5]

void eVision::Easy3D::EZMap16::ImageToWorld ( const eVision::Easy3D::E3DPoint & pixelPoint, eVision::Easy3D::E3DPoint & worldPoint ) const

virtual

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

Parameters

pixelPoint	Position in the image space.
worldPoint	Position in the 3D world space.

Implements eVision::Easy3D::EZMap.

ImageToWorld() [2/5]

void eVision::Easy3D::EZMap16::ImageToWorld ( const eVision::EPoint & pixel2DPoint, const eVision::EFrame & frame, eVision::Easy3D::EZMapImageToWorldKernel kernel, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint & worldPoint ) const

virtual

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

Parameters

pixel2DPoint	X and Y position in the image space.
frame	frame associated with the image space.
kernel	Kernel to use to compute the Z coordinate of the world point. Defaults to EZMapImageToWorldKernel::EZMapImageToWorldKernel_Median.
halfKernelSize	Half of the size (in pixels) of the square around the pixel2DPoint inside which we compute the average grayscale value.
worldPoint	Position in the 3D world space.

Implements eVision::Easy3D::EZMap.

ImageToWorld() [3/5]

void eVision::Easy3D::EZMap16::ImageToWorld ( const eVision::EPoint & pixel2DPoint, const eVision::EFrame & frame, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint & worldPoint ) const

virtual

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

Parameters

pixel2DPoint	X and Y position in the image space.
frame	frame associated with the image space.
halfKernelSize	Half of the size (in pixels) of the square around the pixel2DPoint inside which we compute the average grayscale value.
worldPoint	Position in the 3D world space.

Implements eVision::Easy3D::EZMap.

ImageToWorld() [4/5]

void eVision::Easy3D::EZMap16::ImageToWorld ( const eVision::EPoint & pixel2DPoint, eVision::Easy3D::EZMapImageToWorldKernel kernel, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint & worldPoint ) const

virtual

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

Parameters

pixel2DPoint	X and Y position in the image space.
kernel	Kernel to use to compute the Z coordinate of the world point. Defaults to EZMapImageToWorldKernel::EZMapImageToWorldKernel_Median.
halfKernelSize	Half of the size (in pixels) of the square around the pixel2DPoint inside which we compute the average grayscale value.
worldPoint	Position in the 3D world space.

Implements eVision::Easy3D::EZMap.

ImageToWorld() [5/5]

void eVision::Easy3D::EZMap16::ImageToWorld ( const eVision::EPoint & pixel2DPoint, uint32_t halfKernelSize, eVision::Easy3D::E3DPoint & worldPoint ) const

virtual

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

Parameters

pixel2DPoint	X and Y position in the image space.
halfKernelSize	Half of the size (in pixels) of the square around the pixel2DPoint inside which we compute the average grayscale value.
worldPoint	Position in the 3D world space.

Implements eVision::Easy3D::EZMap.

ImageToZMap() [1/2]

void eVision::Easy3D::EZMap16::ImageToZMap ( const eVision::EPoint & uv, eVision::EPoint & xy ) const

virtual

Converts a 2D image (sub)pixel coordinate to the EZMap16 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.

Parameters

uv	horizontal and vertical coordinates of the pixel as an EPoint.
xy	X and Y coordinates of the pixel as an EPoint.

Implements eVision::Easy3D::EZMap.

ImageToZMap() [2/2]

void eVision::Easy3D::EZMap16::ImageToZMap ( float u, float v, float & x, float & y ) const

virtual

Converts a 2D image (sub)pixel coordinate to the EZMap16 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.

Parameters

u	X Coordinate of the pixel as a floating point value.
v	Y Coordinate of the pixel as a floating point value.
x	Position along horizontal axis in the ZMap space.
y	Position along vertical axis in the ZMap space.

Deprecated

Use the overload taking EPoint as arguments instead.

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

Implements eVision::Easy3D::EZMap.

IsVoid()

bool eVision::Easy3D::EZMap16::IsVoid ( ) const

virtual

Tests if the EZMap16 object size is zero.

Returns true if the ZMap size is zero.

Implements eVision::Easy3D::EZMap.

Load() [1/2]

void eVision::Easy3D::EZMap16::Load ( const std::string & path )

virtual

Restores the EZMap16 stored in the given eVision file.

Parameters

path	Full path to the file.

When loading, the ZMap is resized if needed. This function restores all the ZMap attributes.

Implements eVision::Easy3D::EZMap.

Load() [2/2]

void eVision::Easy3D::EZMap16::Load ( eVision::ESerializer * serializer )

virtual

Restores the EZMap16 stored in the given eVision file.

Parameters

serializer

ESerializer in read mode.

When loading, the ZMap is resized if needed. This function restores all the ZMap attributes.

Implements eVision::Easy3D::EZMap.

LoadImage() [1/2]

void eVision::Easy3D::EZMap16::LoadImage ( const std::string & path )

virtual

Restores the EZMap16 image stored in the given image file.

Parameters

path	Full path to the file.

When loading, the ZMap is resized if needed. This function does not restore the ZMap attributes, only the image associated with the EZMap16 is updated.

Implements eVision::Easy3D::EZMap.

LoadImage() [2/2]

void eVision::Easy3D::EZMap16::LoadImage ( const std::string & path, bool withMetadata )

virtual

Restores the EZMap16 image stored in the given image file.

Parameters

path	Full path to the file.
withMetadata	Parameter to load or not the metadata that has the same filename. False by default.

When loading, the ZMap is resized if needed. This function does not restore the ZMap attributes, only the image associated with the EZMap16 is updated.

Implements eVision::Easy3D::EZMap.

LoadImageAndMetadata()

void eVision::Easy3D::EZMap16::LoadImageAndMetadata ( const std::string & pathImage, const std::string & pathMetadata )

virtual

Loads image format and Metadata in JSON format.

Parameters

pathImage	Full path to the file.
pathMetadata	Full path to the file.

Implements eVision::Easy3D::EZMap.

LoadMetadata()

void eVision::Easy3D::EZMap16::LoadMetadata ( const std::string & path )

virtual

Loads Metadata in JSON format.

Parameters

path	Full path to the file.

Implements eVision::Easy3D::EZMap.

ModifyMetadata()

void eVision::Easy3D::EZMap16::ModifyMetadata ( const std::string & Key, const std::string & value )

virtual

Changes an existing metadata key and value. Throws an exception if it does not exist.

Parameters

Key	The name of an existing metadata.
value	The new value to give to the metadata.

operator=()

eVision::Easy3D::EZMap16 & eVision::Easy3D::EZMap16::operator=

(

const eVision::Easy3D::EZMap16 &

other

)

Assignment operator.

Parameters

other

The source EZMap16.

ResetWorldTransformation()

void eVision::Easy3D::EZMap16::ResetWorldTransformation ( )

virtual

Reset the world transformation, Map to World and World to Map matrices become identity matrix.

Implements eVision::Easy3D::EZMap.

Save() [1/2]

void eVision::Easy3D::EZMap16::Save ( const std::string & path ) const

virtual

Saves the EZMap16 object to the given eVision file.

Parameters

path	The full path to the destination file.

This format save the EZMap16 in a eVision file. This function stores all the ZMap attributes.

Implements eVision::Easy3D::EZMap.

Save() [2/2]

void eVision::Easy3D::EZMap16::Save ( eVision::ESerializer * serializer ) const

virtual

Saves the EZMap16 object to the given eVision file.

Parameters

serializer

ESerializer in write mode.

This format save the EZMap16 in a eVision file. This function stores all the ZMap attributes.

Implements eVision::Easy3D::EZMap.

SaveImage() [1/3]

void eVision::Easy3D::EZMap16::SaveImage ( const std::string & path ) const

virtual

Saves the EZMap16 image to the given image file.

Parameters

path	The full path to the destination file.

This format save the image associated to EZMap16 in a standard image file and thus does not store ZMap attributes.

Implements eVision::Easy3D::EZMap.

SaveImage() [2/3]

void eVision::Easy3D::EZMap16::SaveImage ( const std::string & path, eVision::EImageFileType type ) const

virtual

Saves the EZMap16 image to the given image file.

Parameters

path	The full path to the destination file.
type	File format, as defined by EImageFileType. If not specified, the file format is determined from the file extension.

This format save the image associated to EZMap16 in a standard image file and thus does not store ZMap attributes.

Implements eVision::Easy3D::EZMap.

SaveImage() [3/3]

void eVision::Easy3D::EZMap16::SaveImage ( const std::string & path, eVision::EImageFileType type, bool withMetadata ) const

virtual

Saves the EZMap16 image to the given image file.

Parameters

path	The full path to the destination file.
type	File format, as defined by EImageFileType. If not specified, the file format is determined from the file extension.
withMetadata	Parameter to save or not the metadata that with the same filename next. False by default.

This format save the image associated to EZMap16 in a standard image file and thus does not store ZMap attributes.

Implements eVision::Easy3D::EZMap.

SaveImageAndMetadata() [1/2]

void eVision::Easy3D::EZMap16::SaveImageAndMetadata ( const std::string & pathImage, const std::string & pathMetadata ) const

virtual

Saves image format and Metadata JSON format.

Parameters

pathImage	The full path to the destination file.
pathMetadata	The full path to the destination file.

Implements eVision::Easy3D::EZMap.

SaveImageAndMetadata() [2/2]

void eVision::Easy3D::EZMap16::SaveImageAndMetadata ( const std::string & pathImage, const std::string & pathMetadata, eVision::EImageFileType type ) const

virtual

Saves image format and Metadata JSON format.

Parameters

pathImage	The full path to the destination file.
pathMetadata	The full path to the destination file.
type	File format, as defined by EImageFileType. If not specified, the file format is determined from the file extension.

Implements eVision::Easy3D::EZMap.

SaveMetadata()

void eVision::Easy3D::EZMap16::SaveMetadata ( const std::string & path )

virtual

Saves Metadata in JSON format.

Parameters

path	The full path to the destination file.

Implements eVision::Easy3D::EZMap.

SetBufferPtr() [1/2]

void eVision::Easy3D::EZMap16::SetBufferPtr ( int32_t width, int32_t height, void * imagePointer )

virtual

Sets the pointer to an externally allocated image buffer.

Parameters

width	The width of the supplied buffer, in pixels.
height	The height of the supplied buffer, in pixels.
imagePointer	The pointer (aligned on 4 bytes) to the buffer, which must be large enough to hold the data.

Implements eVision::Easy3D::EZMap.

SetBufferPtr() [2/2]

void eVision::Easy3D::EZMap16::SetBufferPtr ( int32_t width, int32_t height, void * imagePointer, int32_t bitsPerRow )

virtual

Sets the pointer to an externally allocated image buffer.

Parameters

width	The width of the supplied buffer, in pixels.
height	The height of the supplied buffer, in pixels.
imagePointer	The pointer (aligned on 4 bytes) to the buffer, which must be large enough to hold the data.
bitsPerRow	The total number of bits contained in a row, padding included.

Using the value 0 (default) means that this size is computed from the buffer width and the pixel size plus a padding with the smallest possible value that leads to a multiple of 4 bytes (32 bits), which is the minimum padding accepted by EZMap16::SetBufferPtr.

Implements eVision::Easy3D::EZMap.

SetHeight()

void eVision::Easy3D::EZMap16::SetHeight ( int32_t height )

virtual

Access ZMap Height.

Implements eVision::Easy3D::EZMap.

SetMapToWorldMatrix()

void eVision::Easy3D::EZMap16::SetMapToWorldMatrix ( const eVision::Easy3D::E3DTransformMatrix & matrix )

virtual

E3DTransformMatrix that transforms positions from the EZMap16 space to the world space. This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.

Parameters

matrix

The rigid transformation matrix

Implements eVision::Easy3D::EZMap.

SetPixel()

void eVision::Easy3D::EZMap16::SetPixel	(	eVision::EDepth16	value,
		int32_t	x,
		int32_t	y )

Sets the value of a pixel .

Parameters

value	Value of the pixel.
x	Column of the pixel.
y	Row of the pixel.

SetResolution() [1/2]

void eVision::Easy3D::EZMap16::SetResolution ( eVision::Easy3D::E3DPoint resolution )

virtual

Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.

For the Z axis it is expressed in metric units per grey scale value.

Parameters

resolution

Resolution for X,Y and Z axis.

Implements eVision::Easy3D::EZMap.

SetResolution() [2/2]

void eVision::Easy3D::EZMap16::SetResolution ( float rx, float ry, float rz )

virtual

Sets the resolution. For the X and Y axes, the resolution is expressed in metric units per pixel.

For the Z axis it is expressed in metric units per grey scale value.

Parameters

rx	Resolution along the X axis.
ry	Resolution along the Y axis.
rz	Resolution along the Z axis.

Implements eVision::Easy3D::EZMap.

SetSize() [1/2]

void eVision::Easy3D::EZMap16::SetSize ( const eVision::Easy3D::EZMap & other )

virtual

Sets the width and height of the EZMap16.

Parameters

other

The other ZMap whose dimensions have to be used for the current object.

eVision will allocate a new image buffer (deallocate the old image buffer) if the supplied width and height are different from the existing ones.

If an external buffer has been specified by means of UseExternalBuffer, it will be kept only if the size does not change.

Creating a new eVision image buffer and setting its size creates a 4-byte aligned buffer, by default. The size of an ZMap is specified as a number of columns (width) and rows (height).

The maximum image dimensions are 2^30 by 2^30. Furthermore, it must fit into the available memory, that depends upon the physical memory, the operating system and the memory already allocated by the process in other modules or libraries.

Implements eVision::Easy3D::EZMap.

SetSize() [2/2]

void eVision::Easy3D::EZMap16::SetSize ( int32_t width, int32_t height )

virtual

Sets the width and height of the EZMap16.

Parameters

width	The new requested width.
height	The new requested height.

eVision will allocate a new image buffer (deallocate the old image buffer) if the supplied width and height are different from the existing ones.

If an external buffer has been specified by means of UseExternalBuffer, it will be kept only if the size does not change.

Creating a new eVision image buffer and setting its size creates a 4-byte aligned buffer, by default. The size of an ZMap is specified as a number of columns (width) and rows (height).

The maximum image dimensions are 2^30 by 2^30. Furthermore, it must fit into the available memory, that depends upon the physical memory, the operating system and the memory already allocated by the process in other modules or libraries.

Implements eVision::Easy3D::EZMap.

SetWidth()

void eVision::Easy3D::EZMap16::SetWidth ( int32_t width )

virtual

Access ZMap Width.

Implements eVision::Easy3D::EZMap.

SetWorldToMapMatrix()

void eVision::Easy3D::EZMap16::SetWorldToMapMatrix ( const eVision::Easy3D::E3DTransformMatrix & matrix )

virtual

Sets/Gets the E3DTransformMatrix that transforms positions from the world space to the EZMap16 space. This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.

Parameters

matrix

The rigid transformation matrix

Implements eVision::Easy3D::EZMap.

SetXResolution()

void eVision::Easy3D::EZMap16::SetXResolution ( float resolution )

virtual

Resolution of the EZMap16 along the X axis.

The resolution is the number of metric units per pixel.

Parameters

resolution

Contains the resolution along the X axis.

Implements eVision::Easy3D::EZMap.

SetYResolution()

void eVision::Easy3D::EZMap16::SetYResolution ( float resolution )

virtual

Resolution of the EZMap16 along the Y axis.

The resolution is the number of metric units per pixel.

Parameters

resolution

Contains the resolution along the Y axis.

Implements eVision::Easy3D::EZMap.

SetZResolution()

void eVision::Easy3D::EZMap16::SetZResolution ( float resolution )

virtual

Resolution of the EZMap16 along the Z axis.

The resolution is the number of metric units per grey value.

Parameters

resolution

Contains the resolution along the X axis.

Implements eVision::Easy3D::EZMap.

SetZValue()

void eVision::Easy3D::EZMap16::SetZValue	(	const float	value,
		const int32_t	x,
		const int32_t	y )

Sets Z value (in metric coordinate) at pixel coordinates.

Parameters

value	Value of the pixel in metric space.
x	X Coordinate.
y	Y Coordinate.

The parameter value is limited by the buffer pixel type and the Z resolution.

This value is not checked, if the value is too big only the Least Significant bits are used.

UseExternalBuffer()

void eVision::Easy3D::EZMap16::UseExternalBuffer ( int32_t width, int32_t height, void * buffer, int32_t rowPitch )

virtual

Sets the pointer to an externally allocated buffer.

Parameters

width	The width of the supplied buffer, in pixels.
height	The height of the supplied buffer, in pixels.
buffer	The pointer (aligned on 4 bytes) to the buffer, which must be large enough to hold the image.
rowPitch	The total number of bytes contained in a row, padding included.

Implements eVision::Easy3D::EZMap.

WorldToImage()

bool eVision::Easy3D::EZMap16::WorldToImage ( const eVision::Easy3D::E3DPoint & worldPt, eVision::Easy3D::E3DPoint & pixelPt ) const

virtual

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.

Parameters

worldPt	Position in the 3D world space.
pixelPt	Position in the image space.

Implements eVision::Easy3D::EZMap.

WorldToZMap()

void eVision::Easy3D::EZMap16::WorldToZMap ( const eVision::Easy3D::E3DPoint & worldPt, eVision::Easy3D::E3DPoint & zmapPt ) const

virtual

Transforms a 3D world position to a 3D EZMap16 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.

Parameters

worldPt	Position in the 3D world space.
zmapPt	Position in the ZMap space.

Do not use this method with the same variable as input and output. It might lead to incorrect results.

Implements eVision::Easy3D::EZMap.

ZMapToImage() [1/2]

bool eVision::Easy3D::EZMap16::ZMapToImage ( const eVision::EPoint & xy, eVision::EPoint & uv ) const

virtual

Converts a 2D coordinate in the EZMap16 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.

Parameters

xy	X and Y coordinates of the pixel as an EPoint.
uv	horizontal and vertical coordinates of the pixel as an EPoint.

Implements eVision::Easy3D::EZMap.

ZMapToImage() [2/2]

bool eVision::Easy3D::EZMap16::ZMapToImage ( float x, float y, float & u, float & v ) const

virtual

Converts a 2D coordinate in the EZMap16 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.

Parameters

x	Position along horizontal axis in the ZMap space.
y	Position along vertical axis in the ZMap space.
u	Column of the pixel as a floating point value.
v	Row of the pixel as a floating point value.

Deprecated

Use the overload taking EPoint as arguments instead.

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

Implements eVision::Easy3D::EZMap.

ZMapToWorld()

void eVision::Easy3D::EZMap16::ZMapToWorld ( const eVision::Easy3D::E3DPoint & zmapPt, eVision::Easy3D::E3DPoint & worldPt ) const

virtual

Transforms a 3D EZMap16 position to a 3D world space position.

The ZMap space origin is at the lower left corner of the image.

Parameters

zmapPt	Position in the ZMap space.
worldPt	Position in the 3D world space.

Do not use this method with the same variable as input and output. It might lead to incorrect results.

Implements eVision::Easy3D::EZMap.