Skip to main content

M3dmeasCopy

BoardSupported
Host SystemYes
V4L2Yes
Clarity UHDYes
Concord PoENo
GenTLYes
GevIQYes
GigE VisionYes
IndioNo
Iris GTXYes
Radient eV-CLYes
Rapixo CLYes
Rapixo CoFYes
Rapixo CXPYes
USB3 VisionYes

Copy a path or template to a 3D geometry.

Syntax

void M3dmeasCopy(
AIL_ID SrcContext3dmeasId, //in
AIL_INT64 SrcIndex, //in
AIL_ID DstAilObjectId, //out
AIL_INT64 DstIndex, //in
AIL_INT64 CopyType, //in
AIL_INT64 ControlFlag //in
)

Description

This function copies a path in a path 3D measurement context or a template in a template 3D measurement context to a 3D geometry.

Parameters

SrcContext3dmeasId (in, AIL_ID)

Specifies the identifier of the source 3D measurement context from which to copy.

For specifying the source 3D measurement context

ValueDescription
Path 3D measurement context identifierSpecifies the identifier of the path 3D measurement context from which to copy the path.
Template 3D measurement context identifierSpecifies the identifier of the template 3D measurement context from which to copy the template.

SrcIndex (in, AIL_INT64)

Specifies the index of the path or template in the source 3D measurement context.

For specifying a path or template

ValueDescription
M_PATH_INDEXSpecifies the path in a path 3D measurement context, if one is specified.
M_TEMPLATE_INDEXSpecifies the template in a template 3D measurement context, if one is specified.

DstAilObjectId (out, AIL_ID)

Specifies the identifier of the 3D geometry object in which to copy the path or template.

For specifying the destination 3D geometry object

ValueDescription
3D geometry object identifierSpecifies the identifier of the 3D geometry object in which to copy the path or template.

The 3D geometry object must have been previously allocated using M3dgeoAlloc with M_GEOMETRY. |

DstIndex (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.

CopyType (in, AIL_INT64)

Specifies the type of copy operation to perform.

Specifies the type of copy operation

ValueDescription
M_GEOMETRY_PATHSpecifies to copy the path from the path 3D measurement context into the specified 3D geometry object, establishing a 3D line geometry.
M_GEOMETRY_TEMPLATESpecifies to copy the template from the template 3D measurement context into the specified 3D geometry object, establishing a 3D line geometry.

ControlFlag (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.

Copyright © 2026 Zebra Technologies.