M3dimCopy

See also

User Guide:

Working with points in a point cloud

Reference:

M3dgeoAlloc M3dgeoInquire MbufInquire McalInquire

Availability

Not available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

None.

Function Map

- SrcDepthMapImageBufId

- DstGeometry3dgeoId

- CopyType

- ControlFlag

Parameter Associations

Table:

For specifying the copy type

Compilation information

Synopsis

Copy the extent box of a depth map into a 3D geometry.

Syntax

void M3dimCopy(

MIL_ID SrcDepthMapImageBufId,	//in
MIL_ID DstGeometry3dgeoId,	//in
MIL_INT64 CopyType,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function copies the specified depth map's extent box, calculated from the depth map image buffer's size and calibration information, into the specified 3D geometry object.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

SrcDepthMapImageBufId

Specifies the identifier of the source depth map image buffer.

See the Parameter associations section for possible values that can be specified.

DstGeometry3dgeoId

Specifies the identifier of the destination 3D geometry object.

See the Parameter associations section for possible values that can be specified.

CopyType

Specifies how to copy the depth map's extent box into the 3D geometry object.

See the Parameter associations section for possible values that can be specified.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Parameter associations

The table below lists possible values for the SrcDepthMapImageBufId, DstGeometry3dgeoId, and CopyType parameters.

For specifying the copy type

For specifying the copy type
CopyType			Description
	SrcDepthMapImageBufId
		DstGeometry3dgeoId
M_EXTENT_BOX			Specifies to copy the depth map's extent box into the 3D geometry object. The extent box represents the maximum box that a depth map can span, irrespective of its data. The box defines the minimum/maximum X-, Y-, and Z-coordinates that would be representable in the depth map image buffer, based on the buffer's size and calibration information. (summarize) Specifies to copy the depth map's extent box into the 3D geometry object. (more details...)
	Depth map image buffer ID from which to copy		Specifies the identifier of the depth map image buffer from which to copy the extent box. The image buffer must be a 1-band, 8-bit, 16-bit, or 32-bit unsigned buffer, and must contain a fully corrected depth map (that is, if you call McalInquire() with M_DEPTH_MAP, the function returns M_TRUE). If the image buffer has a region of interest (ROI) associated with it, the ROI is ignored. (summarize) Specifies the identifier of the depth map image buffer from which to copy the extent box. (more details...)
		3D geometry object ID in which to copy	Specifies the identifier of the destination 3D geometry object in which to copy the depth map's extent box. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. Note that, after calling M3dimCopy(), the destination 3D geometry object will return type M_BOX if inquired using M3dgeoInquire() with M_GEOMETRY_TYPE. (summarize) Specifies the identifier of the destination 3D geometry object in which to copy the depth map's extent box. (more details...)

Compilation information

Header	Include mil.h.
Library	Use mil.lib; mil3dim.lib.
DLL	Requires mil.dll; mil3dim.dll.