MmetPut

This function adds edgels or points from user-supplied arrays to a constructed edgel feature built with external edgels/points. You can add a constructed edgel feature built with external edgels/points to the metrology context using MmetAddFeature() with M_EDGEL and M_EXTERNAL_FEATURE. Every time MmetPut() is called, it adds the specified edgels/points to the constructed feature, without overwriting previously-added edgels/points with the same position. Points and edgels can be added to the same feature, but you must use separate calls.

MmetPut() is useful if you want to construct an edgel feature with edgels established using the Edge Finder module or with the coordinates of chained pixels (points) established using the Blob Analysis module. You can also, for example, use MmetPut() to add points from a cross-section of a 3D scanned object, delimited by an extraction box, so that you can analyze the profile of the cross-section. To inquire information about an external edgel feature (M_EXTERNAL_FEATURE), such as the total number of external points/edgels it contains (M_NUMBER), call MmetInquire().

Information about a particular edgel/point must occupy the same index in each array. You specify points by specifying their position (X- and Y-position arrays). You specify edgels by specifying their position and their gradient angle (edgel direction). An edgel's angle must respect the convention:

A point/edgel's position must be relative to the reference frame of the constructed edgel feature (MmetControl() with M_REFERENCE_FRAME), which can be set to either the global frame or a local frame.

When passing points that are along an edge, but you don't have their gradient angle information (as is the case when obtained using the Blob Analysis module), you can have MmetPut() automatically calculate their approximate gradient angle by passing M_INTERPOLATE_ANGLE to the ControlFlag parameter. MmetPut() interpolates their gradient angles assuming that points in the arrays are consecutive. As such, the points in the X- and Y-position arrays must be an ordered, connected chain of points. Note that if the points are not from an edge, you should not pass M_INTERPOLATE_ANGLE.

Consecutive edgels in the arrays are considered to be consecutive in their associated edge.

For edgels or points along an edge, you can associate the edgels/points with the index of their edge chain/pixel chain using the ChainIndexArrayPtr parameter. You can add to the end of an edge chain/pixel chain that has already been added to the feature.

To remove all the edgels/points from the constructed edgel feature, set the ControlFlag parameter to M_RESET.

Note, if a camera calibration context is associated with the expected target image, set values in real-world units (for example, positional values). Otherwise, use pixel units.