M3dgeoCopy

See also

User Guide:

Defining transformation matrix objects

Reference:

M3dgeoAlloc M3dgeoInquire MbufAlloc2d MbufInquire

Availability

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

3dcadregistration.cpp
simple3dbinpicking.cpp

Function Map

Parameter Associations

Table:

For specifying the copy type

Compilation information

Synopsis

Copy attributes or settings to or from a 3D geometry object or transformation matrix object.

Syntax

void M3dgeoCopy(

MIL_ID SrcMilObjectId,	//in
MIL_ID DstMilObjectId,	//in
MIL_INT64 CopyType,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function copies attributes or settings to or from a 3D geometry object or transformation matrix object. You can copy the entire object or some attributes or settings of the object (for example, box orientation), depending on the source and destination objects and the specified copy type.

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

SrcMilObjectId

Specifies the identifier of the source object. Note that if the source object is not a predefined or user-defined 3D geometry object or transformation matrix object, the destination object must be.

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

DstMilObjectId

Specifies the identifier of the destination object. Note that if the destination object is not a predefined or user-defined 3D geometry object or transformation matrix object, the source object must be.

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

CopyType

Specifies the type of copy operation.

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 SrcMilObjectId, DstMilObjectId, and CopyType parameters.

For specifying the copy type

For specifying the copy type
CopyType			Description
	SrcMilObjectId
		DstMilObjectId
M_BOX_ORIENTATION			Specifies to set the orientation of a 3D box geometry object, or copy the orientation of a 3D box geometry object. Note that changing the box orientation will not affect its center or its dimensions (that is, the box rotates around its center). (summarize) Specifies to set the orientation of a 3D box geometry object, or copy the orientation of a 3D box geometry object. (more details...)
	M_IDENTITY_MATRIX		Specifies to set the 3D box geometry object's box orientation to the identity matrix. This can be used to reset the box's orientation. (summarize) Specifies to set the 3D box geometry object's box orientation to the identity matrix. (more details...)
		3D geometry object ID	Specifies the identifier of the 3D box geometry object whose orientation to set. The 3D box geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and defined as a box. (summarize) Specifies the identifier of the 3D box geometry object whose orientation to set. (more details...)
	3D box geometry object ID from which to copy		Specifies the identifier of a 3D box geometry object from which to copy the box orientation. The 3D box geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and defined as a box. (summarize) Specifies the identifier of a 3D box geometry object from which to copy the box orientation. (more details...)
		3D box geometry object ID in which to copy	Specifies the identifier of the 3D box geometry object whose orientation to set. The 3D box geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and defined as a box. (summarize) Specifies the identifier of the 3D box geometry object whose orientation to set. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the transformation matrix object in which to copy the box orientation. 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 box orientation. (more details...)
	Transformation matrix object ID to use to define		Specifies the identifier of the transformation matrix object used to set the 3D box geometry object's box orientation. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object used to set the 3D box geometry object's box orientation. (more details...)
		3D geometry object ID	Specifies the identifier of the 3D box geometry object whose orientation to set. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. (summarize) Specifies the identifier of the 3D box geometry object whose orientation to set. (more details...)
M_GEOMETRY			Specifies to copy a 3D geometry object into another 3D geometry object. (summarize) Specifies to copy a 3D geometry object into another 3D geometry object. (more details...)
	M_XY_PLANE		Specifies to copy the XY (Z=0) plane into a 3D geometry object. (summarize) Specifies to copy the XY (Z=0) plane into a 3D geometry object. (more details...)
		3D geometry object ID	Specifies the identifier of the 3D geometry object whose geometry to set to the XY (Z=0) plane. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. (summarize) Specifies the identifier of the 3D geometry object whose geometry to set to the XY (Z=0) plane. (more details...)
	3D geometry object ID from which to copy		Specifies the identifier of a 3D geometry object from which to copy the geometry. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY, and must have been successfully defined. (summarize) Specifies the identifier of a 3D geometry object from which to copy the geometry. (more details...)
		3D geometry object ID	Specifies the identifier of the 3D geometry object whose geometry to set. The 3D geometry object must have been previously allocated using M3dgeoAlloc() with M_GEOMETRY. (summarize) Specifies the identifier of the 3D geometry object whose geometry to set. (more details...)
M_ROTATION_AND_SCALE			Specifies to set only the rotation and scale values of a transformation matrix object using a MIL array buffer, or to copy only the rotation and scale values of a transformation matrix object. (summarize) Specifies to set only the rotation and scale values of a transformation matrix object using a MIL array buffer, or to copy only the rotation and scale values of a transformation matrix object. (more details...)
	M_IDENTITY_MATRIX		Specifies to copy the rotation and scale values of the identity matrix (equivalent to no rotation and uniform scale of 1). (summarize) Specifies to copy the rotation and scale values of the identity matrix (equivalent to no rotation and uniform scale of 1). (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the rotation and scale values of the identity matrix. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the rotation and scale values of the identity matrix. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the rotation and scale values of the identity matrix. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the rotation and scale values of the identity matrix. (more details...)
	MIL array buffer ID to use to define		Specifies the identifier of a 4x4 MIL array buffer used to set the rotation and scale values of the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT, and must have been initialized. (summarize) Specifies the identifier of a 4x4 MIL array buffer used to set the rotation and scale values of the transformation matrix object. (more details...)
		Transformation matrix object ID	Specifies the identifier of the transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object. (more details...)
	Transformation matrix object ID from which to copy		Specifies the identifier of a transformation matrix object from which to copy the rotation and scale values. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of a transformation matrix object from which to copy the rotation and scale values. (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the rotation and scale values of the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the rotation and scale values of the transformation matrix object. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the rotation and scale values of the source transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the rotation and scale values of the source transformation matrix object. (more details...)
M_TRANSFORMATION_MATRIX			Specifies to set the values of a transformation matrix object using a MIL array buffer, or to copy a transformation matrix object. (summarize) Specifies to set the values of a transformation matrix object using a MIL array buffer, or to copy a transformation matrix object. (more details...)
	M_IDENTITY_MATRIX		Specifies to copy the identity matrix. (summarize) Specifies to copy the identity matrix. (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the identity matrix. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the identity matrix. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the identity matrix. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the identity matrix. (more details...)
	MIL array buffer ID to use to define		Specifies the identifier of a 4x4 MIL array buffer used to set the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT, and must have been initialized. (summarize) Specifies the identifier of a 4x4 MIL array buffer used to set the transformation matrix object. (more details...)
		Transformation matrix object ID	Specifies the identifier of the transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object. (more details...)
	Transformation matrix object ID from which to copy		Specifies the identifier of a transformation matrix object to copy. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of a transformation matrix object to copy. (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the values of the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the values of the transformation matrix object. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the values of the source transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the values of the source transformation matrix object. (more details...)
M_TRANSLATION			Specifies to set only the translation values of a transformation matrix object using a MIL array buffer, or to copy only the translation values of a transformation matrix object. (summarize) Specifies to set only the translation values of a transformation matrix object using a MIL array buffer, or to copy only the translation values of a transformation matrix object. (more details...)
	M_IDENTITY_MATRIX		Specifies to copy the translation values of the identity matrix (equivalent to no translation). (summarize) Specifies to copy the translation values of the identity matrix (equivalent to no translation). (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the translation values of the identity matrix. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the translation values of the identity matrix. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the translation values of the identity matrix. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the translation values of the identity matrix. (more details...)
	MIL array buffer ID to use to define		Specifies the identifier of a 4x4 MIL array buffer used to set the translation values of the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT, and must have been initialized. (summarize) Specifies the identifier of a 4x4 MIL array buffer used to set the translation values of the transformation matrix object. (more details...)
		Transformation matrix object ID	Specifies the identifier of the transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the transformation matrix object. (more details...)
	Transformation matrix object ID from which to copy		Specifies the identifier of a transformation matrix object from which to copy the translation values. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of a transformation matrix object from which to copy the translation values. (more details...)
		MIL array buffer ID in which to copy	Specifies the identifier of the 4x4 MIL array buffer in which to copy the translation values of the transformation matrix object. The MIL array buffer must have been previously allocated using MbufAlloc2d() with M_ARRAY and 32 + M_FLOAT. (summarize) Specifies the identifier of the 4x4 MIL array buffer in which to copy the translation values of the transformation matrix object. (more details...)
		Transformation matrix object ID in which to copy	Specifies the identifier of the destination transformation matrix object in which to copy the translation values of the source transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX. (summarize) Specifies the identifier of the destination transformation matrix object in which to copy the translation values of the source transformation matrix object. (more details...)

Compilation information

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