M3dimTranslate

See also

User Guide:

Defining 3D geometries Moving or scaling a point cloud or 3D geometry

Reference:

M3dgeoAlloc M3dgeoInquire MbufAllocComponent MbufAllocContainer MbufInquireContainer

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

- SrcContainerBufOrGeometry3dgeoId

Table:

For specifying the source container or 3D geometry object identifier

- DstContainerBufOrGeometry3dgeoId

Table:

For specifying the destination container or 3D geometry object identifier

Compilation information

Synopsis

Translate a specified point cloud or 3D geometry.

Syntax

void M3dimTranslate(

MIL_ID SrcContainerBufOrGeometry3dgeoId,	//in
MIL_ID DstContainerBufOrGeometry3dgeoId,	//in
MIL_DOUBLE TranslationX,	//in
MIL_DOUBLE TranslationY,	//in
MIL_DOUBLE TranslationZ,	//in
MIL_INT64 ControlFlag	//in

)

Description

This function applies the specified translation to the points in the source point cloud container or to the geometry in the source 3D geometry object. You can specify a translation (displacement) along the X, Y, and/or Z-axis of the working coordinate system, in world units.

If the source is a point cloud container, M3dimTranslate() applies the specified translation to the coordinates in the container's M_COMPONENT_RANGE component, and the modified component is added to the destination container. The source container's M_COMPONENT_CONFIDENCE component is copied to the destination container. If M_COMPONENT_REFLECTANCE, M_COMPONENT_NORMALS_MIL, and M_COMPONENT_MESH_MIL components exist in the source container, they are also copied to the destination container. Any previously existing reflectance, normals, and mesh components are removed from the destination container.

Note that, when translating a point cloud, this function affects the coordinates of the points and not their storage location in the container.

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

SrcContainerBufOrGeometry3dgeoId

Specifies a source point cloud container or 3D geometry object.

Note that the source and destination must match so that both are containers or both are 3D geometry objects.

For specifying the source container or 3D geometry object identifier
Value	Description
M_XY_PLANE	Specifies the XY (Z=0) plane.
Source 3D geometry object identifier	Specifies the identifier of the source 3D geometry object. 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 the source 3D geometry object. (more details...)
Source container identifier	Specifies the identifier of the source container. The container must be 3D-processable (that is, if you call MbufInquireContainer() with M_3D_PROCESSABLE, the function returns M_PROCESSABLE). The container must have been previously allocated using MbufAllocContainer() with M_PROC. The container must have at least the 2 components M_COMPONENT_RANGE and M_COMPONENT_CONFIDENCE. (summarize) Specifies the identifier of the source container. (more details...)

DstContainerBufOrGeometry3dgeoId

Specifies the destination container or 3D geometry object.

Note that the source and destination must match so that both are containers or both are 3D geometry objects.

For specifying the destination container or 3D geometry object identifier
Value	Description
Destination 3D geometry object identifier	Specifies the identifier of the destination 3D geometry object, previously allocated using M3dgeoAlloc() with M_GEOMETRY.
Destination container identifier	Specifies the identifier of the destination container, previously allocated using MbufAllocContainer() with M_PROC. The destination container must not be a child container. (summarize) Specifies the identifier of the destination container, previously allocated using MbufAllocContainer() with M_PROC. (more details...)

TranslationX

Specifies the displacement in the X-direction.

TranslationY

Specifies the displacement in the Y-direction.

TranslationZ

Specifies the displacement in the Z-direction.

ControlFlag

Reserved for future expansion and must be set to M_DEFAULT.

Compilation information

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