M3dregCopyResult
- See also
Availability
Function map
- Examples
M3dregCopy
- M3dregFree
| MIL_ID SrcResult3dregId, | //in |
| MIL_INT SrcIndex, | //in |
| MIL_INT SrcReference, | //in |
| MIL_ID DstMatrix3dgeoId, | //in |
| MIL_INT64 CopyType, | //in |
| MIL_INT64 ControlFlag | //in |
DescriptionThis function copies a resulting transformation matrix from a pairwise 3D registration result buffer, to a transformation matrix object. The 3D registration result buffer must contain results from a successful call to M3dregCalculate() with a pairwise 3D registration context.
You can copy the transformation matrix that registers a point cloud to its reference point cloud, or you can retrieve the transformation matrix that registers a point cloud to any other point cloud in the list of point clouds that were also registered when M3dregCalculate() was called. The destination transformation matrix object can then be used to align the working coordinate system of the point cloud to the working coordinate system of the other specified point cloud, using M3dimMatrixTransform().
To retrieve the transformation matrix of an intermediate iteration of the registration operation, specify the iteration index using M3dregControl() with M_ITERATION_INDEX, and combine the specified copy type with the M_INTERMEDIATE_ITERATION combination constant.
ParametersSpecifies the identifier of the pairwise 3D registration result buffer. The pairwise 3D registration result buffer must have been previously allocated using M3dregAllocResult().
Specifies the index of the registration result element associated with the source point cloud.
Specifies relative to which coordinate system (the global coordinate system or that of a point cloud) to retrieve the copied transformation matrix.
|
For specifying the reference |
|||||||||||||||||||||||||||||||||||||||
| Value |
Description | ||||||||||||||||||||||||||||||||||||||
| M_DEFAULT |
Same as M_REGISTRATION_GLOBAL. |
||||||||||||||||||||||||||||||||||||||
| M_REGISTRATION_GLOBAL |
Specifies the global coordinate system. |
||||||||||||||||||||||||||||||||||||||
|
0 <= Value <
M3dregInquire(SrcResult3dregId, M_NUMBER_OF_REGISTRATION_ELEMENTS) |
Specifies the index of the registration result element associated with the point cloud to use as the reference. This value should not equal the value specified for SrcIndex. (summarize)Specifies the index of the registration result element associated with the point cloud to use as the reference. (more details...) |
||||||||||||||||||||||||||||||||||||||
Specifies the identifier of the destination transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX.
Specifies the type of copy operation to perform.
|
For specifying which registration matrix to copy to
the destination transformation matrix. |
|||||||||||||||||||||||||||||||||||||||
| Value |
Description | ||||||||||||||||||||||||||||||||||||||
| M_REGISTRATION_MATRIX + |
Specifies to copy the transformation matrix stored in the 3D pairwise registration result buffer to a transformation matrix object. |
||||||||||||||||||||||||||||||||||||||
You can add the following value to the above-mentioned value to determine the result for an intermediate iteration.
|
For specifying to retrieve the result of an
intermediate iteration
|
|||||||||||||||||||||||||||||||||||||||
| Combination
value |
Description | ||||||||||||||||||||||||||||||||||||||
| M_INTERMEDIATE_ITERATION |
Specifies to retrieve the result for an intermediate iteration of the pairwise 3D registration operation. You can specify which intermediate iteration to retrieve results from using M3dregControl() with M_ITERATION_INDEX. (summarize)Specifies to retrieve the result for an intermediate iteration of the pairwise 3D registration operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
| Header | Include mil.h. |
| Library | Use mil.lib; mil3dreg.lib. |
| DLL | Requires mil.dll; mil3dreg.dll. |