M3dimCopyResult

See also

User Guide:

Calculating statistics on a point cloud or depth map Defining 3D geometries Working with points in a point cloud

Reference:

M3dgeoAlloc M3dgeoInquire M3dimAllocResult M3dimGetResult M3dimMatrixTransformList M3dimProfile M3dimStat

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

3dmodelheightdefect.cpp

Function Map

- DstGeometryOrMatrix3dgeoId

- CopyType

- ControlFlag

Parameter Associations

Table:

For specifying the copy type and destination object for a 3D image processing result buffer

Compilation information

Synopsis

Copy a group of results into a 3D geometry object or transformation matrix object.

Syntax

void M3dimCopyResult(

MIL_ID SrcResult3dimId,	//in
MIL_ID DstGeometryOrMatrix3dgeoId,	//in
MIL_INT64 CopyType,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function copies a group of 3D image processing results into a 3D geometry object or transformation matrix object, according to the specified copy operation. You can copy bounding box statistics results (calculated using M3dimStat()) into a specified 3D geometry object; whereas, you can copy profile results (calculated using M3dimProfile()) into a specified transformation matrix 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

SrcResult3dimId

Specifies the identifier of a 3D image processing result buffer.

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

DstGeometryOrMatrix3dgeoId

Specifies the identifier of a 3D geometry object or transformation matrix object.

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

CopyType

Specifies the type of copy operation to perform.

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 SrcResult3dimId, DstGeometryOrMatrix3dgeoId, and CopyType parameters.

For specifying the copy type and destination object for a 3D image processing result buffer

For specifying the copy type and destination object for a 3D image processing result buffer
SrcResult3dimId			Description
	CopyType
		DstGeometryOrMatrix3dgeoId
Profile 3D image processing result buffer ID from which to copy			Specifies the identifier of a profile 3D image processing result buffer from which to copy. The result buffer must have been previously allocated using M3dimAllocResult() with M_PROFILE_RESULT. (summarize) Specifies the identifier of a profile 3D image processing result buffer from which to copy. (more details...)
	M_MATRIX_PROFILE_PLANE_TO_WORLD		Specifies to copy profile results into the transformation matrix that, when used with M3dimMatrixTransformList(), transforms M_PROFILE_PLANE_... coordinate values into M_WORLD_... coordinate values. (summarize) Specifies to copy profile results into the transformation matrix that, when used with M3dimMatrixTransformList(), transforms M_PROFILE_PLANE_... coordinate values into M_WORLD_... coordinate values. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the transformation matrix object in which to copy the profile results. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object in which to copy the profile results. (more details...)
	M_MATRIX_WORLD_TO_PROFILE_PLANE		Specifies to copy profile results into the transformation matrix that, when used with M3dimMatrixTransformList(), transforms M_WORLD_... coordinate values into M_PROFILE_PLANE_... coordinate values. (summarize) Specifies to copy profile results into the transformation matrix that, when used with M3dimMatrixTransformList(), transforms M_WORLD_... coordinate values into M_PROFILE_PLANE_... coordinate values. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the transformation matrix object in which to copy the profile results. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object in which to copy the profile results. (more details...)
Statistics 3D image processing result buffer ID from which to copy			Specifies the identifier of a statistics 3D image processing result buffer from which to copy. The result buffer must have been previously allocated using M3dimAllocResult() with M_STATISTICS_RESULT. (summarize) Specifies the identifier of a statistics 3D image processing result buffer from which to copy. (more details...)
	M_BOUNDING_BOX		Specifies to copy bounding box statistics results into the specified 3D geometry object. (summarize) Specifies to copy bounding box statistics results into the specified 3D geometry object. (more details...)
		3D geometry object ID in which to copy	Specifies the identifier of a 3D geometry object in which to copy the statistics results. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. Note that, after calling M3dimCopyResult(), the destination 3D geometry object will return type M_BOX if inquired using M3dgeoInquire() with M_GEOMETRY_TYPE. (summarize) Specifies the identifier of a 3D geometry object in which to copy the statistics results. (more details...)

Compilation information

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