MedgeGetResult

Retrieves the type of the Edge Finder context that was used to extract edges.

Retrieves the width of the source image and internal processing buffers, in pixels.

Note that if you have used MedgePut() to add edge chains to the Edge Finder result buffer, the width returned can be bigger than the width of the source image buffer if the edge chains exceed the boundaries of the source image buffer.

Retrieves the height of the source image and internal processing buffers, in pixels.

Note that if you have used MedgePut() to add edge chains to the Edge Finder result buffer, the height returned can be bigger than the height of the source image buffer if the edge chains exceed the boundaries of the source image buffer.

Retrieves the upper bound value, used during hysteresis thresholding to extract edges.

Retrieves the lower bound value, used during hysteresis thresholding to extract edges.

Retrieves both the lower and upper bound values, used during hysteresis thresholding to extract edges.

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

Retrieves information about the internal angle buffer.

Note that information about the internal angle buffer is only available if it was saved using MedgeControl() with M_SAVE_ANGLE set to M_ENABLE.

Retrieves information about the internal cross derivative buffer.

Note that information about the internal cross derivative buffer is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the internal first derivative buffer in the X-direction.

Note that information about the internal first derivative in the X-direction buffer is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the internal first derivative buffer in the Y-direction.

Note that information about the internal first derivative buffer in the Y-direction is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the internal first derivative buffers in both the X- and Y-directions.

Note that information about the internal first derivative buffers in both the X- and Y-directions is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the source buffer.

Note that information about the source buffer is only available if it was saved using MedgeControl() with M_SAVE_IMAGE set to M_ENABLE.

Retrieves information about the internal magnitude buffer.

Note that information about the internal magnitude buffer is only available if it was saved using MedgeControl() with M_SAVE_MAGNITUDE set to M_ENABLE.

The magnitude buffer is calculated according to MedgeControl() with M_MAGNITUDE_TYPE. If M_MAGNITUDE_TYPE is set to M_SQR_NORM, magnitude values are truncated on 15.0 bits. If M_MAGNITUDE_TYPE is set to M_NORM, magnitude values are truncated on 8.7 bits, with fixed-point precision. 32-bit float buffers use the same conventions, but with floating-point precision.

Retrieves information about the internal mask buffer.

Note that information about the internal mask buffer is only available if it was saved using MedgeControl() with M_SAVE_MASK set to M_ENABLE.

Retrieves information about the internal second derivative buffer in the X-direction.

Note that information about the internal second derivative buffer in the X-direction is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the internal second derivative buffer in the Y-direction.

Note that information about the internal second derivative buffer in the Y-direction is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves information about the internal second derivative buffers in both the X- and Y-directions.

Note that information about the internal second derivative buffers in both the X- and Y-directions is only available if it was saved using MedgeControl() with M_SAVE_DERIVATIVES set to M_ENABLE.

Retrieves the coordinates of the edge(s)'s edgels.

Retrieves the angle values of the edge(s)'s edgels.

The angle is always returned in uncalibrated pixel units and is measured counter-clockwise in the image, from the positive X-axis towards the negative Y-axis of the image.

Possible values range from 0 to 360 degrees and mapped in the range of 0 to 255 (that is, an 8-bit range).

Note that the angle value of the edge at each edgel position is only available if it was saved using MedgeControl() with M_SAVE_CHAIN_ANGLE set to M_ENABLE.

Retrieves the edge(s)'s chain code. The chain code describes how edgels are connected using the following neighbor code:

Retrieves the index of each edgel's edge.

Retrieves the magnitude values of the edge(s)'s edgels.

Note that the magnitude value of the edge at each edgel position is only available if it was saved using MedgeControl() with M_SAVE_CHAIN_MAGNITUDE set to M_ENABLE.

Retrieves the magnitude values and the angle values of the edge(s)'s edgels.

Angles are returned, counter-clockwise, from 0 degrees to 360 degrees and mapped in the range of 0 to 255 (that is, an 8-bit range).

Note that the magnitude and angle values of the edge at each edgel position are only available if they were saved using MedgeControl() with M_SAVE_CHAIN_MAGNITUDE and M_SAVE_CHAIN_ANGLE set to M_ENABLE.

Retrieves the X-coordinates of the edge(s)'s edgels.

Retrieves the Y-coordinates of the edge(s)'s edgels.

Retrieves the number of edgels in the edge(s).

Retrieves the number of included edges.

Retrieves the number of vertices in the chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the coordinates of the vertices in the chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the index of the vertices' corresponding edge, in a chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the index of the vertices' corresponding edgels, in a chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the X-coordinates of the vertices in the chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the Y-coordinates of the vertices in the chain approximation.

This result is not valid if MedgeControl() with M_CHAIN_APPROXIMATION is disabled.

Retrieves the average strength value of each edge.

Retrieves the X-coordinate of each edge's extreme right edgel.

Retrieves the X-coordinate of each edge's extreme left edgel.

Retrieves the Y-coordinate of each edge's extreme bottom edgel.

Retrieves the Y-coordinate of each edge's extreme top edgel.

Retrieves the coordinates of each edge's center of gravity.

Retrieves the X-coordinate of each edge's center of gravity.

Retrieves the Y-coordinate of each edge's center of gravity.

Retrieves the X-coordinate of the center of the circle that is the best fit for each edge.

Retrieves the Y-coordinate of the center of the circle that is the best fit for each edge.

Retrieves the coverage of the circle that is the best fit for each edge. The coverage describes the portion of the circle covered by the edge.

Retrieves the fit error of the circle that is the best fit for each edge. This is calculated as the average quadratic error.

Retrieves the radius of the circle that is the best fit for each edge.

Retrieves the closure status of each edge.

Retrieves the convex elongation of each edge.

Retrieves the angle, in degrees, of the ellipse that is the best fit for each edge, relative to the output coordinate system specified using MedgeControl() 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 26: Calibrating your camera setup.

Retrieves the X-coordinate of the center of the ellipse that is the best fit for each edge.

Retrieves the Y-coordinate of the center of the ellipse that is the best fit for each edge.

Retrieves the coverage of the ellipse that is the best fit for each edge. The coverage describes the portion of the ellipse covered by the edge.

Retrieves the fit error of the ellipse that is the best fit for each edge.

Retrieves the major axis of the ellipse that is the best fit for each edge. The major axis divides the ellipse across its long dimension into two equal halves.

Retrieves the minor axis of the ellipse that is the best fit for each edge. The minor axis divides the ellipse across its short dimension into two equal halves, perpendicular to the major axis.

Retrieves the fast length of each edge.

Retrieves the X- and Y-Feret values of each edge. The X-Feret is the dimension of the minimum bounding box of an edge in the horizontal direction. The Y-Feret is the dimension of the minimum bounding box of an edge in the vertical direction.

Retrieves the Feret elongation of each edge. It is accurate for reasonably compact objects, but becomes less accurate for very elongated objects.

Retrieves the general Feret of each edge. This is the Feret diameter calculated at M_FERET_GENERAL_ANGLE, which is set in MedgeControl().

Retrieves the angle, in degrees, at which the maximum Feret diameter is found, relative to the output coordinate system specified using MedgeControl() 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 26: Calibrating your camera setup.

Retrieves the maximum Feret diameter of each edge.

Retrieves the average Feret diameter at all the angles checked (see M_NUMBER_OF_FERETS).

Retrieves the angle, in degrees, at which the minimum Feret diameter is found, relative to the output coordinate system specified using MedgeControl() 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 26: Calibrating your camera setup.