MmetGetResult

Retrieves the number of constructed features.

Retrieves the total number of features. This total includes both measured features and constructed features.

Retrieves the number of features that are not successfully calculated. The status of those features is M_FAIL.

Retrieves the number of features that are successfully calculated. The status of those features is M_PASS.

Retrieves the number of measured features.

Retrieves the number of tolerances.

Retrieves the number of tolerances that have the status M_FAIL, which is the resulting status when tolerance values are smaller than M_VALUE_MIN or greater than M_VALUE_MAX.

Retrieves the number of tolerances that have the status M_PASS, which is the resulting status when it is not M_FAIL or M_WARNING.

Retrieves the number of tolerances that have the status M_WARNING, which is the resulting status when tolerance values are greater or equal to M_VALUE_MIN and lower than M_VALUE_WARNING_MIN. It also occurs when tolerance values are lower or equal to M_VALUE_MAX and greater than M_VALUE_WARNING_MAX.

Retrieves whether the timeout has been reached. You can set the timeout limit using MmetControl() with M_TIMEOUT. By default, there is no limit.

Retrieves the aperture of an arc or the angle of a segment, a line, or a local frame. The angle is measured in degrees, relative to the output coordinate system specified using MmetControl() with M_RESULT_OUTPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 25: Calibrating your camera setup.

Retrieves the end angle of an arc. The angle is measured in degrees, relative to the output coordinate system specified using MmetControl() with M_RESULT_OUTPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 25: Calibrating your camera setup.

Retrieves the start angle of an arc. The angle is measured in degrees, relative to the output coordinate system specified using MmetControl() with M_RESULT_OUTPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 25: Calibrating your camera setup.

Retrieves the portion of the feature that was covered by the fitted edgels, as a percentage. If the fitted edgels of the feature completely cover all of the possible edgels of the feature (before the fit), M_COVERAGE returns 100%.

You can retrieve M_COVERAGE for physically measured or constructed arcs, circles, and segments. For features that have not been fit, the coverage is 100%.

Retrieves the perimeter of a circle or the length of a segment or arc feature.

Retrieves the coefficient A of the equation for a constructed line.

The line equation is: A x + B y + C = 0.

Retrieves the coefficient B of the equation for a constructed line.

The line equation is: A x + B y + C = 0.

Retrieves the coefficient C of the equation for a constructed line.

The line equation is: A x + B y + C = 0.

Retrieves the number of subfeatures in a multiple feature or the number of edgels in an edgel feature.

Retrieves the X-coordinate of the ending point of a segment or arc.

Retrieves the Y-coordinate of the ending point of a segment or arc.

Retrieves the X-coordinate of the starting point of a segment or arc.

Retrieves the Y-coordinate of the starting point of a segment or arc.

Retrieves the X-coordinate of a point or edgel, the X-coordinate of the center of a circle or arc, or the X-coordinate of the origin of a local frame. For measured points and edgels, you must retrieve M_NUMBER to allocate the appropriate size of the array.

Retrieves the Y-coordinate of a point or edgel, the Y-coordinate of the center of a circle or arc, or the Y-coordinate of the origin of a local frame. For measured points and edgels, you must retrieve M_NUMBER to allocate the appropriate size of the array.

Retrieves the radius of a circle or arc feature.

Retrieves the calculated geometric tolerance value.

Retrieves the label of a specific feature or a specific tolerance.

Retrieves the status of the calculation of features and tolerances.

When multiple features or tolerances are specifed (LabelOrIndex set to M_ALL_FEATURES, M_CONSTRUCTED_FEATURES, M_MEASURED_FEATURES, M_ALL_TOLERANCES, or M_GENERAL), the status is M_FAIL unless the individual statuses of each feature or tolerance being queried is M_PASS. Note that when LabelOrIndex is set to M_GENERAL, all tolerances and all features in the entire metrology context are queried.

The geometric tolerance's status is determined by whether it (M_TOLERANCE_VALUE) adheres to the thresholds set using MmetControl() with M_VALUE_MAX, M_VALUE_MIN, M_VALUE_WARNING_MAX, and M_VALUE_WARNING_MIN. The following is an example of (non-zero) minimum and maximum tolerance value and warning value thresholds: