Represents a generic ZMap type interface. More...

Inheritance diagram for eVision.Easy3D.EZMap:

[legend]

Public Member Functions
bool	IsVoid (self)
	Tests if the eVision.Easy3D.EZMap object size is zero.
ctypes.c_void_p	GetBufferPtr (self)
	Retrieves the pointer to the internal pixel buffer.
ctypes.c_void_p	GetBufferPtr (self, int x, int y)
	Retrieves the pointer to the internal pixel buffer.
ctypes.c_void_p	GetCheckedBufferPtr (self, int x, int y)
	Retrieves the pointer to the pixel buffer.
None	SetBufferPtr (self, int width, int height, ctypes.c_void_p imagePointer, int bitsPerRow)
	Sets the pointer to an externally allocated image buffer.
None	SetBufferPtr (self, int width, int height, ctypes.c_void_p imagePointer)
	Sets the pointer to an externally allocated image buffer.
None	UseExternalBuffer (self, int width, int height, ctypes.c_void_p buffer, int rowPitch)
	Sets the pointer to an externally allocated buffer.
eVision.EPoint	ConvertCoordinatesPixelToMap (self, eVision.EIntPoint pixelCoordinates)
	Converts Pixel coordinates to 3D Map coordinates.
bool	ConvertCoordinatesMapToPixel (self, eVision.EPoint mapCoordinates, eVision.EIntPoint pixelCoordinates)
	Converts 3D Map coordinates to Pixel coordinates.
None	SetSize (self, int width, int height)
	Sets the width and height of the eVision.Easy3D.EZMap.
None	SetSize (self, eVision.Easy3D.EZMap other)
	Sets the width and height of the eVision.Easy3D.EZMap.
None	Load (self, str path)
	Restores the eVision.Easy3D.EZMap stored in the given eVision file.
None	Load (self, eVision.ESerializer\|None serializer)
	Restores the eVision.Easy3D.EZMap stored in the given eVision file.
None	LoadImage (self, str path, bool withMetadata)
	Restores the eVision.Easy3D.EZMap image stored in the given image file.
None	LoadImage (self, str path)
	Restores the eVision.Easy3D.EZMap image stored in the given image file.
None	Save (self, str path)
	Saves the eVision.Easy3D.EZMap object to the given eVision file.
None	Save (self, eVision.ESerializer\|None serializer)
	Saves the eVision.Easy3D.EZMap object to the given eVision file.
None	SaveImage (self, str path, eVision.EImageFileType type, bool withMetadata)
	Saves the eVision.Easy3D.EZMap image to the given image file.
None	SaveImage (self, str path, eVision.EImageFileType type)
	Saves the eVision.Easy3D.EZMap image to the given image file.
None	SaveImage (self, str path)
	Saves the eVision.Easy3D.EZMap image to the given image file.
None	SaveMetadata (self, str path)
	Saves Metadata in JSON format.
None	LoadMetadata (self, str path)
	Loads Metadata in JSON format.
None	SaveImageAndMetadata (self, str pathImage, str pathMetadata, eVision.EImageFileType type)
	Saves image format and Metadata JSON format.
None	SaveImageAndMetadata (self, str pathImage, str pathMetadata)
	Saves image format and Metadata JSON format.
None	LoadImageAndMetadata (self, str pathImage, str pathMetadata)
	Loads image format and Metadata in JSON format.
None	AddMetadata (self, str Key, str value)
	Adds a metadata key (name) and value.
str	GetMetadata (self, str Key)
	Returns the string value of the given metadata.
None	Clear (self)
	Clears the ZMap: replaces all pixels with the undefined value.
None	ResetWorldTransformation (self)
	Reset the world transformation, Map to World and World to Map matrices become identity matrix.
eVision.Easy3D.E3DPoint	GetWorldPositionFromPixelPosition (self, int u, int v)
	Returns the 3D world position corresponding to a eVision.Easy3D.EZMap pixel position.
eVision.Easy3D.E3DPoint	GetWorldPositionFromMapPosition (self, float x, float y)
	Returns the 3D world position corresponding to a eVision.Easy3D.EZMap 2D coordinate.
eVision.Easy3D.E3DPoint	GetZMapPositionFromPixelPosition (self, int u, int v)
	Returns the corresponding eVision.Easy3D.EZMap 3D position of a ZMap pixel.
None	SetResolution (self, float rx, float ry, float rz)
	Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.
None	ImageToZMap (self, eVision.EPoint uv, eVision.EPoint xy)
	Converts a 2D image (sub)pixel coordinate to the eVision.Easy3D.EZMap space.
bool	ZMapToImage (self, eVision.EPoint xy, eVision.EPoint uv)
	Converts a 2D coordinate in the eVision.Easy3D.EZMap space to image (sub)pixel space.
None	WorldToZMap (self, eVision.Easy3D.E3DPoint worldPt, eVision.Easy3D.E3DPoint zmapPt)
	Transforms a 3D world position to a 3D eVision.Easy3D.EZMap position.
None	ZMapToWorld (self, eVision.Easy3D.E3DPoint zmapPt, eVision.Easy3D.E3DPoint worldPt)
	Transforms a 3D eVision.Easy3D.EZMap position to a 3D world space position.
bool	WorldToImage (self, eVision.Easy3D.E3DPoint worldPt, eVision.Easy3D.E3DPoint pixelPt)
	Transforms a 3D world position to a floating point (sub)pixel image position.
None	ImageToWorld (self, eVision.Easy3D.E3DPoint pixelPoint, eVision.Easy3D.E3DPoint worldPoint)
	Transforms a floating point (sub)pixel image position to a 3D world position.
None	ImageToWorld (self, eVision.EPoint pixel2DPoint, int halfKernelSize, eVision.Easy3D.E3DPoint worldPoint)
	Transforms a floating point (sub)pixel image position to a 3D world position.
None	ImageToWorld (self, eVision.EPoint pixel2DPoint, eVision.Easy3D.EZMapImageToWorldKernel kernel, int halfKernelSize, eVision.Easy3D.E3DPoint worldPoint)
	Transforms a floating point (sub)pixel image position to a 3D world position.
None	ImageToWorld (self, eVision.EPoint pixel2DPoint, eVision.EFrame frame, int halfKernelSize, eVision.Easy3D.E3DPoint worldPoint)
	Transforms a floating point (sub)pixel image position to a 3D world position.
None	ImageToWorld (self, eVision.EPoint pixel2DPoint, eVision.EFrame frame, eVision.Easy3D.EZMapImageToWorldKernel kernel, int halfKernelSize, eVision.Easy3D.E3DPoint worldPoint)
	Transforms a floating point (sub)pixel image position to a 3D world position.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, float zoomX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX, float panY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX, float panY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector)
	Draws an eVision.Easy3D.EZMap in a device context.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Draws an eVision.Easy3D.EZMap in a device context.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, float zoomX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX, float panY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY, float panX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX, float zoomY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector, float zoomX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EC24Vector\|None c24Vector)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX, float panY, eVision.EC24 colorUndefinedPixel)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX, float panY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY, float panX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX, float zoomY)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector, float zoomX)
	Displays the internal image buffer.
None	DrawImage (self, eVision.EDrawAdapter\|None graphicContext, eVision.EBW8Vector\|None bw8Vector)
	Displays the internal image buffer.
int	Width (self)
	Access ZMap Width.
	Width (self, int value)
	Access ZMap Width.
int	Height (self)
	Access ZMap Height.
	Height (self, int value)
	Access ZMap Height.
int	RowPitch (self)
	Returns the buffer row pitch.
eVision.Legacy.EWorldShape	WorldShape (self)
	Returns the eVision.Legacy.EWorldShape for conversion between 2D image and 2D world space coordinates.
eVision.Easy3D.E3DTransformMatrix	MapToWorldMatrix (self)
	eVision.Easy3D.E3DTransformMatrix that transforms positions from the eVision.Easy3D.EZMap space to the world space.
	MapToWorldMatrix (self, eVision.Easy3D.E3DTransformMatrix value)
	eVision.Easy3D.E3DTransformMatrix that transforms positions from the eVision.Easy3D.EZMap space to the world space.
eVision.Easy3D.E3DTransformMatrix	WorldToMapMatrix (self)
	Sets/Gets the eVision.Easy3D.E3DTransformMatrix that transforms positions from the world space to the eVision.Easy3D.EZMap space.
	WorldToMapMatrix (self, eVision.Easy3D.E3DTransformMatrix value)
	Sets/Gets the eVision.Easy3D.E3DTransformMatrix that transforms positions from the world space to the eVision.Easy3D.EZMap space.
eVision.EFrame	ZMapPositionFrame (self)
	Returns the eVision.EFrame from which the eVision.Easy3D.EZMap position of a pixel can be retrieved.
eVision.EPoint	SizeInWorld (self)
	Returns the dimensions of the eVision.Easy3D.EZMap in real world space (e.g metric unit).
eVision.Easy3D.E3DPoint	Resolution (self)
	Gets/Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.
	Resolution (self, eVision.Easy3D.E3DPoint value)
	Gets/Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.
float	XResolution (self)
	Resolution of the eVision.Easy3D.EZMap along the X axis.
	XResolution (self, float value)
	Resolution of the eVision.Easy3D.EZMap along the X axis.
float	YResolution (self)
	Resolution of the eVision.Easy3D.EZMap along the Y axis.
	YResolution (self, float value)
	Resolution of the eVision.Easy3D.EZMap along the Y axis.
float	ZResolution (self)
	Resolution of the eVision.Easy3D.EZMap along the Z axis.
	ZResolution (self, float value)
	Resolution of the eVision.Easy3D.EZMap along the Z axis.
eVision.EImageType	Type (self)
	Pixel accessor type.
eVision.Easy3D.E3DPlane	ProjectionPlane (self)
	Retrieves the eVision.Easy3D.E3DPlane on which the ZMap was projected.

Static Public Member Functions
eVision.Easy3D.EZMap\|None	Create (str path)
	Factory method to allocate and read a ZMap from a file.

Detailed Description

Represents a generic ZMap type interface.

Remarks:

License(s): Easy3D

Member Function Documentation

◆ AddMetadata()

None eVision.Easy3D.EZMap.AddMetadata	(		self,
		str	Key,
		str	value )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Clear()

None eVision.Easy3D.EZMap.Clear ( self )

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ ConvertCoordinatesMapToPixel()

bool eVision.Easy3D.EZMap.ConvertCoordinatesMapToPixel	(		self,
		eVision.EPoint	mapCoordinates,
		eVision.EIntPoint	pixelCoordinates )

Converts 3D Map coordinates to Pixel coordinates.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ ConvertCoordinatesPixelToMap()

eVision.EPoint eVision.Easy3D.EZMap.ConvertCoordinatesPixelToMap	(		self,
		eVision.EIntPoint	pixelCoordinates )

Converts Pixel coordinates to 3D Map coordinates.

Parameters

pixelCoordinates The pixel coordinates to convert.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Create()

eVision.Easy3D.EZMap | None eVision.Easy3D.EZMap.Create ( str path )

static

Factory method to allocate and read a ZMap from a file.

Depending on the serialized EZMap type, it returns the corresponding eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap16 or eVision.Easy3D.EZMap32f object. The allocated EZMap must be released after use.

Parameters

path	Full path to the file.

◆ Draw() [1/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

Parameters

graphicContext Handle to the device context of the destination window.

◆ Draw() [2/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [3/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [4/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ Draw() [5/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [6/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [7/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [8/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ Draw() [9/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [10/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ Draw() [11/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [12/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [13/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [14/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [15/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ Draw() [16/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [17/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ Draw() [18/18]

None eVision.Easy3D.EZMap.Draw	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Draws an eVision.Easy3D.EZMap in a device context.

Remarks:

A ZMap can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [1/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

Parameters

graphicContext Handle to the device context of the destination window.

◆ DrawImage() [2/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [3/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [4/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ DrawImage() [5/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [6/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [7/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EBW8Vector \| None	bw8Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [8/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ DrawImage() [9/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [10/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ DrawImage() [11/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [12/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [13/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EC24Vector \| None	c24Vector,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [14/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [15/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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

◆ DrawImage() [16/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [17/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ DrawImage() [18/18]

None eVision.Easy3D.EZMap.DrawImage	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY,
		eVision.EC24	colorUndefinedPixel )

Displays the internal image buffer.

Remarks:

An image can be drawn (its pixels rendered) using a device context. eVision.Easy3D.EZMap.Draw and eVision.Easy3D.EZMap.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.)

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.

◆ GetBufferPtr() [1/2]

ctypes.c_void_p eVision.Easy3D.EZMap.GetBufferPtr ( self )

Retrieves the pointer to the internal pixel buffer.

Remarks:

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ GetBufferPtr() [2/2]

ctypes.c_void_p eVision.Easy3D.EZMap.GetBufferPtr	(		self,
		int	x,
		int	y )

Retrieves the pointer to the internal pixel buffer.

Remarks:

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

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ GetCheckedBufferPtr()

ctypes.c_void_p eVision.Easy3D.EZMap.GetCheckedBufferPtr	(		self,
		int	x,
		int	y )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ GetMetadata()

str eVision.Easy3D.EZMap.GetMetadata	(		self,
		str	Key )

Returns the string value of the given metadata.

Throws an exception if it does not exist.

Parameters

Key	The name of an existing metadata.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ GetWorldPositionFromMapPosition()

eVision.Easy3D.E3DPoint eVision.Easy3D.EZMap.GetWorldPositionFromMapPosition	(		self,
		float	x,
		float	y )

Returns the 3D world position corresponding to a eVision.Easy3D.EZMap 2D coordinate.

The world position is in the original point cloud space. (x,y) is the ZMap position (which has the same scale as the world space). The value at position (x, y) must not be undefined in the eVision.Easy3D.EZMap, otherwise an exception will be thrown.

Parameters

x	The X coordinate.
y	The Y coordinate.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ GetWorldPositionFromPixelPosition()

eVision.Easy3D.E3DPoint eVision.Easy3D.EZMap.GetWorldPositionFromPixelPosition	(		self,
		int	u,
		int	v )

Returns the 3D world position corresponding to a eVision.Easy3D.EZMap pixel position.

The world position is in the original point cloud space. The pixel space origin is at the upper left corner of the image and ranges to (width-1, height-1). The transformation to the world position is calculated using the center of the pixel. The pixel value at position (u,v) must not be undefined, otherwise an exception will be thrown.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ GetZMapPositionFromPixelPosition()

eVision.Easy3D.E3DPoint eVision.Easy3D.EZMap.GetZMapPositionFromPixelPosition	(		self,
		int	u,
		int	v )

Returns the corresponding eVision.Easy3D.EZMap 3D position of a ZMap pixel.

The ZMap position is in the original point ZMap space. The pixel position origin is the upper left corner of the image and ranges to (width-1, height-1). The center of the pixel is used for the transformation to the ZMap position. Pixel at position (u,v) must be defined, otherwise an exception will be thrown.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Height() [1/2]

int eVision.Easy3D.EZMap.Height ( self )

Access ZMap Height.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ Height() [2/2]

eVision.Easy3D.EZMap.Height	(		self,
		int	value )

Access ZMap Height.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToWorld() [1/5]

None eVision.Easy3D.EZMap.ImageToWorld	(		self,
		eVision.Easy3D.E3DPoint	pixelPoint,
		eVision.Easy3D.E3DPoint	worldPoint )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToWorld() [2/5]

None eVision.Easy3D.EZMap.ImageToWorld	(		self,
		eVision.EPoint	pixel2DPoint,
		eVision.Easy3D.EZMapImageToWorldKernel	kernel,
		int	halfKernelSize,
		eVision.Easy3D.E3DPoint	worldPoint )

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToWorld() [3/5]

None eVision.Easy3D.EZMap.ImageToWorld	(		self,
		eVision.EPoint	pixel2DPoint,
		eVision.EFrame	frame,
		eVision.Easy3D.EZMapImageToWorldKernel	kernel,
		int	halfKernelSize,
		eVision.Easy3D.E3DPoint	worldPoint )

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToWorld() [4/5]

None eVision.Easy3D.EZMap.ImageToWorld	(		self,
		eVision.EPoint	pixel2DPoint,
		eVision.EFrame	frame,
		int	halfKernelSize,
		eVision.Easy3D.E3DPoint	worldPoint )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToWorld() [5/5]

None eVision.Easy3D.EZMap.ImageToWorld	(		self,
		eVision.EPoint	pixel2DPoint,
		int	halfKernelSize,
		eVision.Easy3D.E3DPoint	worldPoint )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ImageToZMap()

None eVision.Easy3D.EZMap.ImageToZMap	(		self,
		eVision.EPoint	uv,
		eVision.EPoint	xy )

Converts a 2D image (sub)pixel coordinate to the eVision.Easy3D.EZMap space.

(u,v) is the pixel position (with its origin in the upper left corner of the image).
(x,y) is the corresponding ZMap position (which has the same scale as the world space). All values are expressed in floating point numbers.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ IsVoid()

bool eVision.Easy3D.EZMap.IsVoid ( self )

Tests if the eVision.Easy3D.EZMap object size is zero.

Remarks:

Returns true if the ZMap size is zero.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Load() [1/2]

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

Restores the eVision.Easy3D.EZMap stored in the given eVision file.

Remarks:

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

Parameters

serializer eVision.ESerializer in read mode.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ Load() [2/2]

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

Restores the eVision.Easy3D.EZMap stored in the given eVision file.

Remarks:

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

Parameters

path	Full path to the file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ LoadImage() [1/2]

None eVision.Easy3D.EZMap.LoadImage	(		self,
		str	path )

Restores the eVision.Easy3D.EZMap image stored in the given image file.

Remarks:

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

Parameters

path	Full path to the file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ LoadImage() [2/2]

None eVision.Easy3D.EZMap.LoadImage	(		self,
		str	path,
		bool	withMetadata )

Restores the eVision.Easy3D.EZMap image stored in the given image file.

Remarks:

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

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ LoadImageAndMetadata()

None eVision.Easy3D.EZMap.LoadImageAndMetadata	(		self,
		str	pathImage,
		str	pathMetadata )

Loads image format and Metadata in JSON format.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ LoadMetadata()

None eVision.Easy3D.EZMap.LoadMetadata	(		self,
		str	path )

Loads Metadata in JSON format.

Parameters

path	Full path to the file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ MapToWorldMatrix() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EZMap.MapToWorldMatrix ( self )

eVision.Easy3D.E3DTransformMatrix that transforms positions from the eVision.Easy3D.EZMap space to the world space.

This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ MapToWorldMatrix() [2/2]

eVision.Easy3D.EZMap.MapToWorldMatrix	(		self,
		eVision.Easy3D.E3DTransformMatrix	value )

eVision.Easy3D.E3DTransformMatrix that transforms positions from the eVision.Easy3D.EZMap space to the world space.

This transformation is composed of rotation and translation only, so it is a rigid transformation and preserves distances.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ProjectionPlane()

eVision.Easy3D.E3DPlane eVision.Easy3D.EZMap.ProjectionPlane ( self )

Retrieves the eVision.Easy3D.E3DPlane on which the ZMap was projected.

◆ ResetWorldTransformation()

None eVision.Easy3D.EZMap.ResetWorldTransformation ( self )

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Resolution() [1/2]

eVision.Easy3D.E3DPoint eVision.Easy3D.EZMap.Resolution ( self )

Gets/Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.

On the Z axis, the resolution is the number of metric units per grey value.

On the X and Y axis, the resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ Resolution() [2/2]

eVision.Easy3D.EZMap.Resolution	(		self,
		eVision.Easy3D.E3DPoint	value )

Gets/Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.

On the Z axis, the resolution is the number of metric units per grey value.

On the X and Y axis, the resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ RowPitch()

int eVision.Easy3D.EZMap.RowPitch ( self )

Returns the buffer row pitch.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Save() [1/2]

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

Saves the eVision.Easy3D.EZMap object to the given eVision file.

Remarks:

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

Parameters

serializer eVision.ESerializer in write mode.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ Save() [2/2]

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

Saves the eVision.Easy3D.EZMap object to the given eVision file.

Remarks:

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

Parameters

path	The full path to the destination file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveImage() [1/3]

None eVision.Easy3D.EZMap.SaveImage	(		self,
		str	path )

Saves the eVision.Easy3D.EZMap image to the given image file.

Remarks:

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

Parameters

path	The full path to the destination file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveImage() [2/3]

None eVision.Easy3D.EZMap.SaveImage	(		self,
		str	path,
		eVision.EImageFileType	type )

Saves the eVision.Easy3D.EZMap image to the given image file.

Remarks:

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

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveImage() [3/3]

None eVision.Easy3D.EZMap.SaveImage	(		self,
		str	path,
		eVision.EImageFileType	type,
		bool	withMetadata )

Saves the eVision.Easy3D.EZMap image to the given image file.

Remarks:

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

Parameters

path	The full path to the destination file.
type	File format, as defined by eVision.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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveImageAndMetadata() [1/2]

None eVision.Easy3D.EZMap.SaveImageAndMetadata	(		self,
		str	pathImage,
		str	pathMetadata )

Saves image format and Metadata JSON format.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveImageAndMetadata() [2/2]

None eVision.Easy3D.EZMap.SaveImageAndMetadata	(		self,
		str	pathImage,
		str	pathMetadata,
		eVision.EImageFileType	type )

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 eVision.EImageFileType. If not specified, the file format is determined from the file extension.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SaveMetadata()

None eVision.Easy3D.EZMap.SaveMetadata	(		self,
		str	path )

Saves Metadata in JSON format.

Parameters

path	The full path to the destination file.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ SetBufferPtr() [1/2]

None eVision.Easy3D.EZMap.SetBufferPtr	(		self,
		int	width,
		int	height,
		ctypes.c_void_p	imagePointer )

Sets the pointer to an externally allocated image buffer.

Deprecated

Use eVision.Easy3D.EZMap.UseExternalBuffer instead.

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

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SetBufferPtr() [2/2]

None eVision.Easy3D.EZMap.SetBufferPtr	(		self,
		int	width,
		int	height,
		ctypes.c_void_p	imagePointer,
		int	bitsPerRow )

Sets the pointer to an externally allocated image buffer.

Deprecated

Use eVision.Easy3D.EZMap.UseExternalBuffer instead.

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

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 eVision.Easy3D.EZMap.SetBufferPtr.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SetResolution()

None eVision.Easy3D.EZMap.SetResolution	(		self,
		float	rx,
		float	ry,
		float	rz )

Sets the resolution of the eVision.Easy3D.EZMap along the X, Y and Z axis.

On the Z axis, the resolution is the number of metric units per grey value. On the X and Y axis, the resolution is the number of metric units per pixel.

Parameters

rx	Contains the resolution along the X axis.
ry	Contains the resolution along the Y axis.
rz	Contains the resolution along the Z axis.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ SetSize() [1/2]

None eVision.Easy3D.EZMap.SetSize	(		self,
		eVision.Easy3D.EZMap	other )

Sets the width and height of the eVision.Easy3D.EZMap.

Remarks:

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.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SetSize() [2/2]

None eVision.Easy3D.EZMap.SetSize	(		self,
		int	width,
		int	height )

Sets the width and height of the eVision.Easy3D.EZMap.

Remarks:

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.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ SizeInWorld()

eVision.EPoint eVision.Easy3D.EZMap.SizeInWorld ( self )

Returns the dimensions of the eVision.Easy3D.EZMap in real world space (e.g metric unit).

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Type()

eVision.EImageType eVision.Easy3D.EZMap.Type ( self )

Pixel accessor type.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ UseExternalBuffer()

None eVision.Easy3D.EZMap.UseExternalBuffer	(		self,
		int	width,
		int	height,
		ctypes.c_void_p	buffer,
		int	rowPitch )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ Width() [1/2]

int eVision.Easy3D.EZMap.Width ( self )

Access ZMap Width.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ Width() [2/2]

eVision.Easy3D.EZMap.Width	(		self,
		int	value )

Access ZMap Width.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ WorldShape()

eVision.Legacy.EWorldShape eVision.Easy3D.EZMap.WorldShape ( self )

Returns the eVision.Legacy.EWorldShape for conversion between 2D image and 2D world space coordinates.

This EWorldShape can be used by EasyGauge to do measurements on a eVision.Easy3D.EZMap in real space coordinates (e.g mm).

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ WorldToImage()

bool eVision.Easy3D.EZMap.WorldToImage	(		self,
		eVision.Easy3D.E3DPoint	worldPt,
		eVision.Easy3D.E3DPoint	pixelPt )

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.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ WorldToMapMatrix() [1/2]

eVision.Easy3D.E3DTransformMatrix eVision.Easy3D.EZMap.WorldToMapMatrix ( self )

Sets/Gets the eVision.Easy3D.E3DTransformMatrix that transforms positions from the world space to the eVision.Easy3D.EZMap space.

This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ WorldToMapMatrix() [2/2]

eVision.Easy3D.EZMap.WorldToMapMatrix	(		self,
		eVision.Easy3D.E3DTransformMatrix	value )

Sets/Gets the eVision.Easy3D.E3DTransformMatrix that transforms positions from the world space to the eVision.Easy3D.EZMap space.

This transformation is composed of rotation and translation only, so it is a rigid transformation and it preserves distances.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ WorldToZMap()

None eVision.Easy3D.EZMap.WorldToZMap	(		self,
		eVision.Easy3D.E3DPoint	worldPt,
		eVision.Easy3D.E3DPoint	zmapPt )

Transforms a 3D world position to a 3D eVision.Easy3D.EZMap position.

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

The scales of the world space and ZMap space are the same.

Remarks:

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

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ XResolution() [1/2]

float eVision.Easy3D.EZMap.XResolution ( self )

Resolution of the eVision.Easy3D.EZMap along the X axis.

The resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ XResolution() [2/2]

eVision.Easy3D.EZMap.XResolution	(		self,
		float	value )

Resolution of the eVision.Easy3D.EZMap along the X axis.

The resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ YResolution() [1/2]

float eVision.Easy3D.EZMap.YResolution ( self )

Resolution of the eVision.Easy3D.EZMap along the Y axis.

The resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ YResolution() [2/2]

eVision.Easy3D.EZMap.YResolution	(		self,
		float	value )

Resolution of the eVision.Easy3D.EZMap along the Y axis.

The resolution is the number of metric units per pixel.

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ZMapPositionFrame()

eVision.EFrame eVision.Easy3D.EZMap.ZMapPositionFrame ( self )

Returns the eVision.EFrame from which the eVision.Easy3D.EZMap position of a pixel can be retrieved.

The ZMap position is in the original point ZMap space.

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ ZMapToImage()

bool eVision.Easy3D.EZMap.ZMapToImage	(		self,
		eVision.EPoint	xy,
		eVision.EPoint	uv )

Converts a 2D coordinate in the eVision.Easy3D.EZMap space to image (sub)pixel space.

(x,y) is the ZMap position (which has the same scale as the world space).
(u,v) is the corresponding pixel position (with its origin in the upper left corner of the image). All values are expressed in floating point numbers. Returns true if the pixel position is inside the image limits.

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ ZMapToWorld()

None eVision.Easy3D.EZMap.ZMapToWorld	(		self,
		eVision.Easy3D.E3DPoint	zmapPt,
		eVision.Easy3D.E3DPoint	worldPt )

Transforms a 3D eVision.Easy3D.EZMap position to a 3D world space position.

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

Remarks:

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

Parameters

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, and eVision.Easy3D.EZMap8.

◆ ZResolution() [1/2]

float eVision.Easy3D.EZMap.ZResolution ( self )

Resolution of the eVision.Easy3D.EZMap along the Z axis.

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

◆ ZResolution() [2/2]

eVision.Easy3D.EZMap.ZResolution	(		self,
		float	value )

Resolution of the eVision.Easy3D.EZMap along the Z axis.

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

Reimplemented in eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap16, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap32f, eVision.Easy3D.EZMap8, and eVision.Easy3D.EZMap8.

Public Member Functions

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ AddMetadata()

◆ Clear()

◆ ConvertCoordinatesMapToPixel()

◆ ConvertCoordinatesPixelToMap()

◆ Create()

◆ Draw() [1/18]

◆ Draw() [2/18]

◆ Draw() [3/18]

◆ Draw() [4/18]

◆ Draw() [5/18]

◆ Draw() [6/18]

◆ Draw() [7/18]

◆ Draw() [8/18]

◆ Draw() [9/18]

◆ Draw() [10/18]

◆ Draw() [11/18]

◆ Draw() [12/18]

◆ Draw() [13/18]

◆ Draw() [14/18]

◆ Draw() [15/18]

◆ Draw() [16/18]

◆ Draw() [17/18]

◆ Draw() [18/18]

◆ DrawImage() [1/18]

◆ DrawImage() [2/18]

◆ DrawImage() [3/18]

◆ DrawImage() [4/18]

◆ DrawImage() [5/18]

◆ DrawImage() [6/18]

◆ DrawImage() [7/18]

◆ DrawImage() [8/18]

◆ DrawImage() [9/18]

◆ DrawImage() [10/18]

◆ DrawImage() [11/18]

◆ DrawImage() [12/18]

◆ DrawImage() [13/18]

◆ DrawImage() [14/18]

◆ DrawImage() [15/18]

◆ DrawImage() [16/18]

◆ DrawImage() [17/18]

◆ DrawImage() [18/18]

◆ GetBufferPtr() [1/2]

◆ GetBufferPtr() [2/2]

◆ GetCheckedBufferPtr()

◆ GetMetadata()

◆ GetWorldPositionFromMapPosition()

◆ GetWorldPositionFromPixelPosition()

◆ GetZMapPositionFromPixelPosition()

◆ Height() [1/2]

◆ Height() [2/2]

◆ ImageToWorld() [1/5]

◆ ImageToWorld() [2/5]

◆ ImageToWorld() [3/5]

◆ ImageToWorld() [4/5]

◆ ImageToWorld() [5/5]

◆ ImageToZMap()

◆ IsVoid()

◆ Load() [1/2]

◆ Load() [2/2]

◆ LoadImage() [1/2]

◆ LoadImage() [2/2]

◆ LoadImageAndMetadata()

◆ LoadMetadata()

◆ MapToWorldMatrix() [1/2]

◆ MapToWorldMatrix() [2/2]

◆ ProjectionPlane()

◆ ResetWorldTransformation()

◆ Resolution() [1/2]

◆ Resolution() [2/2]

◆ RowPitch()

◆ Save() [1/2]

◆ Save() [2/2]

◆ SaveImage() [1/3]

◆ SaveImage() [2/3]

◆ SaveImage() [3/3]

◆ SaveImageAndMetadata() [1/2]