M3dmetCopyResult
Synopsis
Copy a group of results from a fit 3D
metrology result buffer into an image buffer, 3D geometry object,
or a transformation matrix.
Syntax
This function copies a group of results from a 3D metrology
result buffer into an image buffer, 3D geometry object, or a
transformation matrix.
The copy operations that are available depends on the resulting
status of the fit operation. To retrieve the status of the fit
operation, use M3dmetGetResult() with M_STATUS.
Note that this function reference has not been updated for a MIL
system added during a MIL update. Refer to the to see if there is
complementary information.
Parameters
This function is not supported on the selected
boards.
The table below lists possible values for the
DstMilObjectId and CopyType parameters.
For specifying the destination object and copy type
for a 3D metrology result buffer


M_FITTED_GEOMETRY 
Specifies to copy the fitted 3D geometry object.
3D cylinder geometry objects and 3D line geometry objects copied
using this copy operation will always be finite.
Note that, you can only perform
this copy operation if the fit operation completed
successfully.
(summarize)
Specifies to copy the fitted 3D geometry object.
(more
details...)


MIL 3D geometry object
identifier 
Specifies the identifier of a 3D geometry object in which to
copy results.

M_FIXTURING_MATRIX 
Specifies to initialize a transformation matrix object with the
transformation matrix that can fixture the fitted 3D geometry to a
position near the origin.
If the fitted geometry is a plane, the matrix is initialized
with the transformation that could move the plane to the XYplane
(Z=0), with its normal as the Zaxis. The centroid of all inlier
points becomes the origin.
If the fitted geometry is a cylinder or line, the matrix is
initialized with the transformation that could move the starting
point of the geometry to the origin, and the central axis to the
Zaxis.
If the fitted geometry is a sphere, the matrix is initialized
with the transformation that could move the center of the sphere to
the origin.
Note that, you can only perform
this copy operation if the fit operation completed
successfully.
(summarize)
Specifies to initialize a transformation matrix
object with the transformation matrix that can fixture the fitted
3D geometry to a position near the origin.
(more
details...)


MIL 3D transformation matrix
object
identifier 
Specifies the identifier of a 3D transformation matrix object in
which to copy results.

M_INLIER_MASK 
Specifies to copy the points that were considered inliers during
the fit. That is, points that were considered inliers will have a
confidence score of 255 in the destination image buffer, and all
other points will have a confidence score of 0.
Note that, you can perform this
copy operation whether the fit operation completed successfully or
not, as long as a call to M3dmetFit() was made.
(summarize)
Specifies to copy the points that were considered
inliers during the fit.
(more
details...)


Image buffer identifier 
Specifies the identifier of an image buffer in which to copy
results.
The image buffer must be a 1band, 8bit unsigned image buffer.
This image buffer must have a size equal to the number of points
used during the fit. You can inquire this value using M3dmetGetResult() with
M_NUMBER_OF_POINTS_TOTAL.
This image buffer must not have a region of interest (ROI)
associated with it. Using an image buffer with an ROI will cause an
error.
(summarize)
Specifies the identifier of an image buffer in which
to copy results.
(more
details...)

M_OUTLIER_MASK 
Specifies to copy the points that were considered outliers
during the fit. That is, points that were considered outliers will
have a confidence score of 255 in the destination image buffer, and
all other points will have a confidence score of 0.
Note that, you can perform this
copy operation whether the fit operation completed successfully or
not, as long as a call to M3dmetFit() was made.
(summarize)
Specifies to copy the points that were considered
outliers during the fit.
(more
details...)


Image buffer identifier 
Specifies the identifier of an image buffer in which to copy
results.
The image buffer must be a 1band, 8bit unsigned image buffer.
This image buffer must have a size equal to the number of points
used during the fit. You can inquire this value using M3dmetGetResult() with
M_NUMBER_OF_POINTS_TOTAL.
This image buffer must not have a region of interest (ROI)
associated with it. Using an image buffer with an ROI will cause an
error.
(summarize)
Specifies the identifier of an image buffer in which
to copy results.
(more
details...)

Compilation information
Header

Include mil.h. 
Library

Use mil.lib; mil3dmet.lib. 
DLL

Requires mil.dll; mil3dmet.dll. 
FITTED GEOMETRY FIXTURING MATRIX
INLIER MASK UNSIGNED NONE OUTLIER MASK UNSIGNED NONE