MedgeInquire

Table:	For operation settings (both M_CONTOUR and M_CREST)
Table:	For operation settings (M_CREST only)
Table:	For internal buffers (both M_CONTOUR and M_CREST)
Table:	For edge features (both M_CONTOUR and M_CREST)
Table:	For sorting keys (both M_CONTOUR and M_CREST)
Table:	For general settings (both M_CONTOUR and M_CREST)
Table:	For Feret settings (both M_CONTOUR and M_CREST)
Table:	For post-calculations (both M_CONTOUR and M_CREST)
Table:	For result buffer settings (general)
Table:	For result buffer settings (closest-edgel operations)
Table:	For inquiring about the system
+ combination:	For inquiring the default value
+ combination:	For inquiring if an inquire type is sortable or is supported
+ combination:	For specifying the data type

Return value

Compilation information

None.

MedgeGetResult

MedgeMask

Synopsis

Inquire about an Edge Finder context or an Edge Finder result buffer.

Syntax

MIL_INT MedgeInquire(

MIL_ID ContextOrResultId,	//in
MIL_INT64 InquireType,	//in
void *UserVarPtr	//out

)

Description

This function inquires information about the specified Edge Finder context or Edge Finder result buffer.

Note that for an Edge Finder result buffer, this function only retrieves information about result buffer settings (set with MedgeControl(), for example). To retrieve results from the Edge Finder result buffer, use MedgeGetResult().

If the inquired setting is set to M_DEFAULT (for example, in MedgeControl()), MedgeInquire() will return M_DEFAULT. To inquire the actual default value, add M_DEFAULT to the InquireType parameter.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.

Parameters

This function is not supported on the selected boards.

Parameters

ContextOrResultId

Specifies either the Edge Finder context or the Edge Finder result buffer about which to inquire information. Both the Edge Finder context and the Edge Finder result buffer must have been previously allocated on the system using MedgeAlloc() or MedgeAllocResult(), respectively.

InquireType

Specifies the type of setting about which to inquire.

See the Parameter associations section for possible values that can be specified.

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

MIL_DOUBLE
MIL_ID
MIL_INT
MIL_INT32
MIL_INT64

Specifies the address in which to write the requested information. Since this function also returns the requested information, you can set this parameter to M_NULL.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For operation settings (both M_CONTOUR and M_CREST)
For operation settings (M_CREST only)
For internal buffers (both M_CONTOUR and M_CREST)
For edge features (both M_CONTOUR and M_CREST)
For sorting keys (both M_CONTOUR and M_CREST)
For general settings (both M_CONTOUR and M_CREST)
For Feret settings (both M_CONTOUR and M_CREST)
For post-calculations (both M_CONTOUR and M_CREST)
For result buffer settings (general)
For result buffer settings (closest-edgel operations)
For inquiring about the system

To inquire about the operation settings for both M_CONTOUR and M_CREST Edge Finder contexts, set the InquireType parameter to one of the following values:

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For operation settings (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ACCURACY +		Inquires the edgel accuracy of the edge extraction. SET (summarize) Inquires the edgel accuracy of the edge extraction. SET (more details...)
	M_DEFAULT	Same as M_HIGH.
	M_DISABLE	Specifies that edgel accuracy will be disabled. INFO
	M_HIGH	Specifies high accuracy. INFO
	M_VERY_HIGH	Specifies very high accuracy. INFO
M_ANGLE_ACCURACY +		Inquires the edgel angle accuracy of the edge extraction. SET (summarize) Inquires the edgel angle accuracy of the edge extraction. SET (more details...)
	M_DEFAULT	Same as M_HIGH.
	M_HIGH	Specifies high precision. INFO
	M_LOW	Specifies low precision. INFO
M_CHAIN_ALL_NEIGHBORS +		Inquires whether edge chains are built using all the available neighboring edgels. SET (summarize) Inquires whether edge chains are built using all the available neighboring edgels. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that edge chains are built with the least amount of edgel information possible. INFO
	M_ENABLE	Specifies that edge chains are built with as much edgel information as possible. INFO
M_EXTRACTION_SCALE +		Inquires the image scale with which to extract the edges. Returns the scale of the image at which to do the edge extraction. Once the extraction is complete, the results are scaled to the original scale of the image. A lower extraction scale speeds up the search but can result in a less reliable result, including, the loss of important details and/or a reduction in the accuracy of the search results. M_EXTRACTION_SCALE is for advanced users of the Edge Finder module. The default setting usually provides the most accurate search results. SET (summarize) Inquires the image scale with which to extract the edges. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.0.
	Value > 0	Specifies the extraction scale.
M_FILTER_SMOOTHNESS +		Inquires the degree of smoothness (strength of denoising) of the edge extraction filter. SET (summarize) Inquires the degree of smoothness (strength of denoising) of the edge extraction filter. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 50.0.
	0.0 <= Value <= 100.0	Specifies the smoothness value. INFO
M_FILTER_TYPE +		Inquires the type of filter used when performing the edge extraction. SET (summarize) Inquires the type of filter used when performing the edge extraction. SET (more details...)
	M_DEFAULT	Same as M_SHEN.
	M_DERICHE	Specifies a Canny-Deriche infinite support filter. INFO
	M_FREI_CHEN	Specifies a Frei Chen filter. INFO
	M_PREWITT	Specifies a Prewitt filter. INFO
	M_SHEN	Specifies a Shen-Castan infinite support exponential filter. INFO
	M_SOBEL	Specifies a Sobel filter. INFO
M_FLOAT_MODE +		Inquires whether the entire edge extraction process is forced to be performed using floating-point precision calculations. SET (summarize) Inquires whether the entire edge extraction process is forced to be performed using floating-point precision calculations. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that all edge extractions are not forced to be performed using floating-point precision calculations.
	M_ENABLE	Specifies that all edge extractions are forced to be performed using floating-point precision calculations.
M_KERNEL_SIZE +		Inquires the actual X and Y size (same in X and Y) of the convolution kernel used for kernel filtering mode. Note that the kernel size can change according to the filter type, the smoothness factor, the specified maximum kernel width, the specified kernel depth, and whether you are using floating-point calculations. (summarize) Inquires the actual X and Y size (same in X and Y) of the convolution kernel used for kernel filtering mode. (more details...)
	Value	Specifies the actual size, in X and Y, of the convolution kernel.
M_MAGNITUDE_TYPE +		Inquires the type of magnitude value used to calculate the magnitude of the edge at each edgel position. SET (summarize) Inquires the type of magnitude value used to calculate the magnitude of the edge at each edgel position. SET (more details...)
	M_DEFAULT	Specifies the default value. INFO
	M_NORM	Specifies that the magnitude will be used.
	M_SQR_NORM	Specifies that the square of the magnitude will be used. INFO
M_MODIFICATION_COUNT +		Inquires the current value of the modification counter. The modification counter is increased by one each time settings for the context are modified. Although you cannot identify the modification counter's contents, you can compare them throughout your application to know if the context has been altered. If the modification counter has changed you can, for example, prompt the user to save before closing the application. (summarize) Inquires the current value of the modification counter. (more details...)
	Value	Specifies the current value of the modification counter.
M_OVERSCAN +		Inquires the type of overscan used by the convolution filters when extracting edges for kernel filtering mode. Note that M_OVERSCAN is ignored if using an IIR filter (e.g. Shen and Deriche filter types). SET (summarize) Inquires the type of overscan used by the convolution filters when extracting edges for kernel filtering mode. SET (more details...)
	M_DEFAULT	Same as M_MIRROR.
	M_DISABLE	Specifies that no overscan will be used, unless processing the border pixels is faster than ignoring them; in the latter case, MIL automatically selects the overscan to optimize speed according to the specified operation and the target system.
	M_MIRROR	Specifies that the border pixels of a source image are processed using overscan pixel values that mirror the source buffer pixel values. INFO
	M_REPLACE	Specifies that the border pixels of a source image are processed using overscan pixel values set to the overscan replacement value (MedgeControl() with M_OVERSCAN_REPLACE_VALUE).
	M_TRANSPARENT	Specifies that the border pixels of a source image are processed using transparent overscan pixel values. INFO
M_OVERSCAN_REPLACE_VALUE +		Inquires the replacement value for the overscan pixel values when using replacement type overscan. Note that M_OVERSCAN_REPLACE_VALUE is ignored unless M_OVERSCAN with MedgeControl() is set to M_REPLACE. In addition, M_OVERSCAN_REPLACE_VALUE is ignored if using an IIR filter (e.g. Shen and Deriche filter types). SET (summarize) Inquires the replacement value for the overscan pixel values when using replacement type overscan. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.
	M_REPLACE_MAX	Specifies that the overscan neighborhood pixel values will be set to the maximum value of the source image buffer.
	M_REPLACE_MIN	Specifies that the overscan neighborhood pixel values will be set to the minimum value of the source image buffer.
	Value	Specifies the value of the overscan neighborhood pixels.
M_THRESHOLD_HIGH +		Inquires the user-defined upper bound of the hysteresis threshold. SET (summarize) Inquires the user-defined upper bound of the hysteresis threshold. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	Value	Specifies the upper bound of the hysteresis threshold.
M_THRESHOLD_LOW +		Inquires the user-defined lower bound of the hysteresis threshold. SET (summarize) Inquires the user-defined lower bound of the hysteresis threshold. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0.
	Value	Specifies the lower bound of the hysteresis threshold.
M_THRESHOLD_MODE +		Inquires the threshold mode of the edge extraction. Note that lower threshold values result in a more sensitive edgel detection. SET (summarize) Inquires the threshold mode of the edge extraction. SET (more details...)
	M_DEFAULT	Same as M_HIGH.
	M_DISABLE	Specifies no threshold. INFO
	M_HIGH	Specifies a high threshold. INFO
	M_LOW	Specifies a low threshold. INFO
	M_MEDIUM	Specifies a medium threshold. INFO
	M_USER_DEFINED	Specifies that the threshold values will be user-defined. INFO
	M_VERY_HIGH	Specifies a very high threshold. INFO
M_THRESHOLD_TYPE +		Inquires the type of the hysteresis threshold used when performing the edge extraction. SET (summarize) Inquires the type of the hysteresis threshold used when performing the edge extraction. SET (more details...)
	M_DEFAULT	Same as M_HYSTERESIS.
	M_FULL_HYSTERESIS	Specifies that the lower bound threshold value is 0.
	M_HYSTERESIS	Specifies that both the lower bound threshold value and the upper bound threshold value will be used.
	M_NO_HYSTERESIS	Specifies that the lower bound threshold value is equal to the upper bound threshold value.
M_TIMEOUT +		Inquires the maximum edge extraction and calculation time for MedgeCalculate(). SET (summarize) Inquires the maximum edge extraction and calculation time for MedgeCalculate(). SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies an infinite amount of edge extraction and calculation time.
	Value > 0	Specifies the maximum edge extraction and calculation time, in msec.

To inquire about the operation settings for M_CREST Edge Finder contexts, set the InquireType parameter to the value below.

For operation settings (M_CREST only)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_FOREGROUND_VALUE +		Inquires the color used to extract line crests from the image. SET (summarize) Inquires the color used to extract line crests from the image. SET (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_DEFAULT	Same as M_FOREGROUND_BLACK.
	M_ANY	Specifies that the line crests are both lighter and darker than the image's background color. INFO
	M_FOREGROUND_BLACK	Specifies that the line crests are darker than the image's background color. INFO
	M_FOREGROUND_WHITE	Specifies that the line crests are lighter than the image's background color. INFO

To inquire whether internal buffers have been saved in the Edge Finder result buffer, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For internal buffers (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_SAVE_ANGLE +		Inquires whether the internal angle buffer used to extract edges is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the internal angle buffer used to extract edges is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the angle buffer will not be saved.
	M_ENABLE	Specifies that the angle buffer will be saved.
M_SAVE_CHAIN_ANGLE +		Inquires whether the angle value at each edgel position is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the angle value at each edgel position is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the angle values will not be saved.
	M_ENABLE	Specifies that the angle values will be saved.
M_SAVE_CHAIN_MAGNITUDE +		Inquires whether the magnitude value at each edgel position is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the magnitude value at each edgel position is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the magnitude values will not be saved.
	M_ENABLE	Specifies that the magnitude values will be saved.
M_SAVE_DERIVATIVES +		Inquires whether the internal derivative buffers used to extract edges are saved in the Edge Finder result buffer. SET (summarize) Inquires whether the internal derivative buffers used to extract edges are saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the derivative buffers will not be saved.
	M_ENABLE	Specifies that the derivative buffers will be saved.
M_SAVE_IMAGE +		Inquires whether the source image is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the source image is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the image will not be saved.
	M_ENABLE	Specifies that the image will be saved.
M_SAVE_MAGNITUDE +		Inquires whether the internal magnitude buffer used to extract edges is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the internal magnitude buffer used to extract edges is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the magnitude buffer will not be saved.
	M_ENABLE	Specifies that the magnitude buffer will be saved.
M_SAVE_MASK +		Inquires whether the mask buffer is saved in the Edge Finder result buffer. SET (summarize) Inquires whether the mask buffer is saved in the Edge Finder result buffer. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the mask will not be saved.
	M_ENABLE	Specifies that the mask will be saved.

To inquire about which edge features will be calculated for each edge, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts. Note that, when an edge feature has been calculated, M_ENABLE is returned.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For edge features (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_AVERAGE_STRENGTH +		Inquires whether the average strength value of each edge will be calculated. SET (summarize) Inquires whether the average strength value of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the average strength will not be calculated.
	M_ENABLE	Specifies that the average strength will be calculated.
M_BOX_X_MAX +		Inquires whether the extreme right edgel coordinate of each edge will be calculated. SET (summarize) Inquires whether the extreme right edgel coordinate of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the extreme right edgel coordinate will not be calculated.
	M_ENABLE	Specifies that the extreme right edgel coordinate will be calculated.
M_BOX_X_MIN +		Inquires whether the extreme left edgel coordinate of each edge will be calculated. SET (summarize) Inquires whether the extreme left edgel coordinate of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the extreme left edgel coordinate will not be calculated.
	M_ENABLE	Specifies that the extreme left edgel coordinate will be calculated.
M_BOX_Y_MAX +		Inquires whether the extreme bottom edgel coordinate of each edge will be calculated. SET (summarize) Inquires whether the extreme bottom edgel coordinate of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the extreme bottom edgel coordinate will not be calculated.
	M_ENABLE	Specifies that the extreme bottom edgel coordinate will be calculated.
M_BOX_Y_MIN +		Inquires whether the extreme top edgel coordinate of each edge will be calculated. SET (summarize) Inquires whether the extreme top edgel coordinate of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the extreme top edgel coordinate will not be calculated.
	M_ENABLE	Specifies that the extreme top edgel coordinate will be calculated.
M_CENTER_OF_GRAVITY_X +		Inquires whether the X-position of each edge's center of gravity will be calculated. SET (summarize) Inquires whether the X-position of each edge's center of gravity will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-position of the center of gravity will not be calculated.
	M_ENABLE	Specifies that the X-position of the center of gravity will be calculated.
M_CENTER_OF_GRAVITY_Y +		Inquires whether the Y-position of each edge's center of gravity will be calculated. SET (summarize) Inquires whether the Y-position of each edge's center of gravity will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-position of the center of gravity will not be calculated.
	M_ENABLE	Specifies that the Y-position of the center of gravity will be calculated.
M_CIRCLE_FIT_CENTER_X +		Inquires whether the X-coordinate of the center of the circle that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the X-coordinate of the center of the circle that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-coordinate will not be calculated.
	M_ENABLE	Specifies that the X-coordinate will be calculated.
M_CIRCLE_FIT_CENTER_Y +		Inquires whether the Y-coordinate of the center of the circle that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the Y-coordinate of the center of the circle that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-coordinate will not be calculated.
	M_ENABLE	Specifies that the Y-coordinate will be calculated.
M_CIRCLE_FIT_COVERAGE +		Inquires whether the coverage of the circle that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the coverage of the circle that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the coverage of the circle will not be calculated.
	M_ENABLE	Specifies that the coverage of the circle will be calculated.
M_CIRCLE_FIT_ERROR +		Inquires whether the fit error of the circle that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the fit error of the circle that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the fit error of the circle will not be calculated.
	M_ENABLE	Specifies that the fit error of the circle will be calculated.
M_CIRCLE_FIT_RADIUS +		Inquires whether the radius of the circle that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the radius of the circle that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the radius will not be calculated.
	M_ENABLE	Specifies that the radius will be calculated.
M_CLOSURE +		Inquires whether the closure of each edge will be calculated. SET (summarize) Inquires whether the closure of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the edge's closure state will not be calculated.
	M_ENABLE	Specifies that the edge's closure state will be calculated.
M_CONVEX_PERIMETER +		Inquires whether the convex elongation of each edge will be calculated. SET (summarize) Inquires whether the convex elongation of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the convex elongation will not be calculated.
	M_ENABLE	Specifies that the convex elongation will be calculated.
M_ELLIPSE_FIT_ANGLE +		Inquires whether the angle of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the angle of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the angle will not be calculated.
	M_ENABLE	Specifies that the angle will be calculated.
M_ELLIPSE_FIT_CENTER_X +		Inquires whether the X-coordinate of the center of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the X-coordinate of the center of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-coordinate will not be calculated.
	M_ENABLE	Specifies that the X-coordinate will be calculated.
M_ELLIPSE_FIT_CENTER_Y +		Inquires whether the Y-coordinate of the center of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the Y-coordinate of the center of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-coordinate will not be calculated.
	M_ENABLE	Specifies that the Y-coordinate will be calculated.
M_ELLIPSE_FIT_COVERAGE +		Inquires whether the coverage of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the coverage of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the coverage of the ellipse will not be calculated.
	M_ENABLE	Specifies that the coverage of the ellipse will be calculated.
M_ELLIPSE_FIT_ERROR +		Inquires whether the fit error of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the fit error of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the fit error of the ellipse will not be calculated.
	M_ENABLE	Specifies that the fit error of the ellipse will be calculated.
M_ELLIPSE_FIT_MAJOR_AXIS +		Inquires whether the major axis of the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the major axis of the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the major axis will not be calculated.
	M_ENABLE	Specifies that the major axis will be calculated.
M_ELLIPSE_FIT_MINOR_AXIS +		Inquires whether the minor axis the ellipse that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the minor axis the ellipse that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the minor axis will not be calculated.
	M_ENABLE	Specifies that the minor axis will be calculated.
M_FAST_LENGTH +		Inquires whether the length of each edge will be quickly calculated. SET (summarize) Inquires whether the length of each edge will be quickly calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that a fast length will not be calculated.
	M_ENABLE	Specifies that a fast length will be calculated.
M_FERET_ELONGATION +		Inquires whether the Feret elongation of each edge will be calculated. SET (summarize) Inquires whether the Feret elongation of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Feret elongation will not be calculated.
	M_ENABLE	Specifies that the Feret elongation will be calculated.
M_FERET_MAX_ANGLE +		Inquires whether the maximum Feret angle of each edge will be calculated. SET (summarize) Inquires whether the maximum Feret angle of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the maximum Feret angle will not be calculated.
	M_ENABLE	Specifies that the maximum Feret angle will be calculated.
M_FERET_MAX_DIAMETER +		Inquires whether the maximum Feret diameter of each edge will be calculated. SET (summarize) Inquires whether the maximum Feret diameter of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the maximum Feret diameter will not be calculated.
	M_ENABLE	Specifies that the maximum Feret diameter will be calculated.
M_FERET_MEAN_DIAMETER +		Inquires whether the average Feret diameter of each edge will be calculated. SET (summarize) Inquires whether the average Feret diameter of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the average Feret diameter will not be calculated.
	M_ENABLE	Specifies that the average Feret diameter will be calculated.
M_FERET_MIN_ANGLE +		Inquires whether the minimum Feret angle of each edge will be calculated. SET (summarize) Inquires whether the minimum Feret angle of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the minimum Feret angle will not be calculated.
	M_ENABLE	Specifies that the minimum Feret angle will be calculated.
M_FERET_MIN_DIAMETER +		Inquires whether the minimum Feret diameter of each edge will be calculated. SET (summarize) Inquires whether the minimum Feret diameter of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the minimum Feret diameter will not be calculated.
	M_ENABLE	Specifies that the minimum Feret diameter will be calculated.
M_FERET_X +		Inquires whether the X-Feret value of each edge will be calculated. SET (summarize) Inquires whether the X-Feret value of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-Feret value will not be calculated.
	M_ENABLE	Specifies that the X-Feret value will be calculated.
M_FERET_Y +		Inquires whether the Y-Feret value of each edge will be calculated. SET (summarize) Inquires whether the Y-Feret value of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-Feret value will not be calculated.
	M_ENABLE	Specifies that the Y-Feret value will be calculated.
M_FIRST_POINT_X +		Inquires whether the X-coordinate of each edge's first point (starting point) will be calculated. SET (summarize) Inquires whether the X-coordinate of each edge's first point (starting point) will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the first point's X-coordinate will not be calculated.
	M_ENABLE	Specifies that the first point's X-coordinate will be calculated.
M_FIRST_POINT_Y +		Inquires whether the Y-coordinate of each edge's first point (starting point) will be calculated. SET (summarize) Inquires whether the Y-coordinate of each edge's first point (starting point) will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the first point's Y-coordinate will not be calculated.
	M_ENABLE	Specifies that the first point's Y-coordinate will be calculated.
M_GENERAL_FERET +		Inquires whether the general Feret of each edge will be calculated. SET (summarize) Inquires whether the general Feret of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the general Feret will not be calculated.
	M_ENABLE	Specifies that the general Feret will be calculated.
M_LABEL_VALUE +		Inquires whether the label value of each edge in an image will be calculated. SET (summarize) Inquires whether the label value of each edge in an image will be calculated. SET (more details...)
	M_DEFAULT	Same as M_ENABLE.
	M_DISABLE	Specifies that the label value will not be calculated.
	M_ENABLE	Specifies that the label value will be calculated.
M_LENGTH +		Inquires whether the length of each edge will be calculated. SET (summarize) Inquires whether the length of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the length of each edge will not be calculated.
	M_ENABLE	Specifies that the length of each edge will be calculated.
M_LINE_FIT_A +		Inquires whether the coefficient A of the line that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the coefficient A of the line that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the coefficient A will not be calculated.
	M_ENABLE	Specifies that the coefficient A will be calculated.
M_LINE_FIT_B +		Inquires whether the coefficient B of the line that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the coefficient B of the line that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the coefficient B will not be calculated.
	M_ENABLE	Specifies that the coefficient B will be calculated.
M_LINE_FIT_C +		Inquires whether the coefficient C of the line that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the coefficient C of the line that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the coefficient C will not be calculated.
	M_ENABLE	Specifies that the coefficient C will be calculated.
M_LINE_FIT_ERROR +		Inquires whether the fit error of the line that is the best fit for each edge will be calculated. SET (summarize) Inquires whether the fit error of the line that is the best fit for each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the fit error will not be calculated.
	M_ENABLE	Specifies that the fit error will be calculated.
M_MOMENT_ELONGATION +		Inquires whether the moment elongation of each edge will be calculated. SET (summarize) Inquires whether the moment elongation of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the moment elongation will not be calculated.
	M_ENABLE	Specifies that the moment elongation will be calculated.
M_MOMENT_ELONGATION_ANGLE +		Inquires whether the angle of the principal axis along each edge's moment elongation will be calculated. SET (summarize) Inquires whether the angle of the principal axis along each edge's moment elongation will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the angle of the moment elongation will not be calculated.
	M_ENABLE	Specifies that the angle of the moment elongation will be calculated.
M_POSITION_X +		Inquires whether the X-position of each edge will be calculated. SET (summarize) Inquires whether the X-position of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-position will not be calculated.
	M_ENABLE	Specifies that the X-position will be calculated.
M_POSITION_Y +		Inquires whether the Y-position of each edge will be calculated. SET (summarize) Inquires whether the Y-position of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-position will not be calculated.
	M_ENABLE	Specifies that the Y-position will be calculated.
M_SIZE +		Inquires whether the number of edgels in each edge will be calculated. SET (summarize) Inquires whether the number of edgels in each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the number of edgels will not be calculated.
	M_ENABLE	Specifies that the number of edgels will be calculated.
M_STRENGTH +		Inquires whether the strength value of each edge will be calculated. SET (summarize) Inquires whether the strength value of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the strength will not be calculated.
	M_ENABLE	Specifies that the strength will be calculated.
M_TORTUOSITY +		Inquires whether the tortuosity measure of each edge will be calculated. SET (summarize) Inquires whether the tortuosity measure of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the tortuosity measure will not be calculated.
	M_ENABLE	Specifies that the tortuosity measure will be calculated.
M_X_MAX_AT_Y_MAX +		Inquires whether the X-maximum at Y-maximum contact point of each edge will be calculated. SET (summarize) Inquires whether the X-maximum at Y-maximum contact point of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-maximum at Y-maximum will not be calculated.
	M_ENABLE	Specifies that the X-maximum at Y-maximum will be calculated.
M_X_MIN_AT_Y_MIN +		Inquires whether the X-minimum at Y-minimum contact point of each edge will be calculated. SET (summarize) Inquires whether the X-minimum at Y-minimum contact point of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the X-minimum at Y-minimum will not be calculated.
	M_ENABLE	Specifies that the X-minimum at Y-minimum will be calculated.
M_Y_MAX_AT_X_MIN +		Inquires whether the Y-maximum at X-minimum contact point of each edge will be calculated. SET (summarize) Inquires whether the Y-maximum at X-minimum contact point of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-maximum at X-minimum will not be calculated.
	M_ENABLE	Specifies that the Y-maximum at X-minimum will be calculated.
M_Y_MIN_AT_X_MAX +		Inquires whether the Y-minimum at X-maximum contact point of each edge will be calculated. SET (summarize) Inquires whether the Y-minimum at X-maximum contact point of each edge will be calculated. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Y-minimum at X-maximum will not be calculated.
	M_ENABLE	Specifies that the Y-minimum at X-maximum will be calculated.

To inquire about the corresponding edge feature associated with the specified sorting key, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For sorting keys (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_SORTn_DOWN +		Inquires the feature associated with the n ^th sorting key (in descending order), where n stands for an integer between 1 and 3. (summarize) Inquires the feature associated with the n ^th sorting key (in descending order), where n stands for an integer between 1 and 3. (more details...)
	M_NULL	Specifies that no feature has been associated with the specified sorting key.
	M_AVERAGE_STRENGTH	Sorts based on the average strength of each edge. INFO
	M_BOX_X_MAX	Sorts based on the extreme right edgel coordinate of each edge.
	M_BOX_X_MIN	Sorts based on the extreme left edgel coordinate of each edge.
	M_BOX_Y_MAX	Sorts based on the extreme bottom edgel coordinate of each edge.
	M_BOX_Y_MIN	Sorts based on the extreme top edgel coordinate of each edge.
	M_CENTER_OF_GRAVITY_X	Sorts based on the X-position of each edge's center of gravity. INFO
	M_CENTER_OF_GRAVITY_Y	Sorts based on the Y-position of each edge's center of gravity. INFO
	M_CIRCLE_FIT_CENTER_X	Sorts based on the X-coordinate of the center of the circle that is the best fit for each edge.
	M_CIRCLE_FIT_CENTER_Y	Sorts based on the Y-coordinate of the center of the circle that is the best fit for each edge.
	M_CIRCLE_FIT_COVERAGE	Sorts based on the coverage of the circle that is the best fit for each edge. INFO
	M_CIRCLE_FIT_ERROR	Sorts based on the fit error of the circle that is the best fit for each edge. INFO
	M_CIRCLE_FIT_RADIUS	Sorts based on the radius of the circle that is the best fit for each edge.
	M_CLOSURE	Sorts based on the closure state of each edge. INFO
	M_CONVEX_PERIMETER	Sorts based on the convex elongation of each edge. INFO
	M_ELLIPSE_FIT_ANGLE	Sorts based on the angle of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_CENTER_X	Sorts based on the X-coordinate of the center of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_CENTER_Y	Sorts based on the Y-coordinate of the center of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_COVERAGE	Sorts based on the coverage of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_ERROR	Sorts based on the fit error of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_MAJOR_AXIS	Sorts based on the major axis of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_MINOR_AXIS	Sorts based on the minor axis of the ellipse that is the best fit for each edge. INFO
	M_FAST_LENGTH	Sorts based on a coarse approximation for the length of each edge. INFO
	M_FERET_ELONGATION	Sorts based on the Feret elongation of each edge. INFO
	M_FERET_MAX_ANGLE	Sorts based on the maximum Feret angle of each edge. INFO
	M_FERET_MAX_DIAMETER	Sorts based on the maximum Feret diameter of each edge. INFO
	M_FERET_MEAN_DIAMETER	Sorts based on the average Feret diameter at all the angles checked (see M_NUMBER_OF_FERETS).
	M_FERET_MIN_ANGLE	Sorts based on the minimum Feret angle of each edge. INFO
	M_FERET_MIN_DIAMETER	Sorts based on the minimum Feret diameter of each edge. INFO
	M_FERET_X	Sorts based on the X-Feret value of each edge. INFO
	M_FERET_Y	Sorts based on the Y-Feret value of each edge. INFO
	M_FIRST_POINT_X	Sorts based on the X-coordinate of each edge's first point (starting point). INFO
	M_FIRST_POINT_Y	Sorts based on the Y-coordinate of each edge's first point (starting point). INFO
	M_GENERAL_FERET	Sorts based on the general Feret of each edge. INFO
	M_LABEL_VALUE	Sorts based on the label value of each edge in an image. INFO
	M_LENGTH	Sorts based on the length of each edge. INFO
	M_LINE_FIT_A	Sorts based on the coefficient A of the line that is the best fit for each edge. INFO
	M_LINE_FIT_B	Sorts based on the coefficient B of the line that is the best fit for each edge. INFO
	M_LINE_FIT_C	Sorts based on the coefficient C of the line that is the best fit for each edge. INFO
	M_LINE_FIT_ERROR	Sorts based on the fit error of the line that is the best fit for each edge. INFO
	M_MOMENT_ELONGATION	Sorts based on the moment elongation of each edge. INFO
	M_MOMENT_ELONGATION_ANGLE	Sorts based on the angle of the principal axis along each edge's moment elongation (M_MOMENT_ELONGATION).
	M_POSITION_X	Sorts based on the X-position of each edge. INFO
	M_POSITION_Y	Sorts based on the Y-position of each edge. INFO
	M_SIZE	Sorts based on the number of edgels of each edge.
	M_STRENGTH	Sorts based on the strength of each edge. INFO
	M_TORTUOSITY	Sorts based on the tortuosity measure of each edge. INFO
	M_X_MAX_AT_Y_MAX	Sorts based on the maximum X-coordinate at the maximum Y-coordinate of each edge. INFO
	M_X_MIN_AT_Y_MIN	Sorts based on the minimum X-coordinate at the minimum Y-coordinate of each edge. INFO
	M_Y_MAX_AT_X_MIN	Sorts based on the maximum Y-coordinate at the minimum X-coordinate of each edge. INFO
	M_Y_MIN_AT_X_MAX	Sorts based on the minimum Y-coordinate at the maximum X-coordinate of each edge. INFO
M_SORTn_UP +		Inquires the feature associated with the n ^th sorting key (in ascending order), where n stands for an integer between 1 and 3. (summarize) Inquires the feature associated with the n ^th sorting key (in ascending order), where n stands for an integer between 1 and 3. (more details...)
	M_NULL	Specifies that no feature has been associated with the specified sorting key.
	M_AVERAGE_STRENGTH	Sorts based on the average strength of each edge. INFO
	M_BOX_X_MAX	Sorts based on the extreme right edgel coordinate of each edge.
	M_BOX_X_MIN	Sorts based on the extreme left edgel coordinate of each edge.
	M_BOX_Y_MAX	Sorts based on the extreme bottom edgel coordinate of each edge.
	M_BOX_Y_MIN	Sorts based on the extreme top edgel coordinate of each edge.
	M_CENTER_OF_GRAVITY_X	Sorts based on the X-position of each edge's center of gravity. INFO
	M_CENTER_OF_GRAVITY_Y	Sorts based on the Y-position of each edge's center of gravity. INFO
	M_CIRCLE_FIT_CENTER_X	Sorts based on the X-coordinate of the center of the circle that is the best fit for each edge.
	M_CIRCLE_FIT_CENTER_Y	Sorts based on the Y-coordinate of the center of the circle that is the best fit for each edge.
	M_CIRCLE_FIT_COVERAGE	Sorts based on the coverage of the circle that is the best fit for each edge. INFO
	M_CIRCLE_FIT_ERROR	Sorts based on the fit error of the circle that is the best fit for each edge. INFO
	M_CIRCLE_FIT_RADIUS	Sorts based on the radius of the circle that is the best fit for each edge.
	M_CLOSURE	Sorts based on the closure state of each edge. INFO
	M_CONVEX_PERIMETER	Sorts based on the convex elongation of each edge. INFO
	M_ELLIPSE_FIT_ANGLE	Sorts based on the angle of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_CENTER_X	Sorts based on the X-coordinate of the center of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_CENTER_Y	Sorts based on the Y-coordinate of the center of the ellipse that is the best fit for each edge.
	M_ELLIPSE_FIT_COVERAGE	Sorts based on the coverage of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_ERROR	Sorts based on the fit error of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_MAJOR_AXIS	Sorts based on the major axis of the ellipse that is the best fit for each edge. INFO
	M_ELLIPSE_FIT_MINOR_AXIS	Sorts based on the minor axis of the ellipse that is the best fit for each edge. INFO
	M_FAST_LENGTH	Sorts based on a coarse approximation for the length of each edge. INFO
	M_FERET_ELONGATION	Sorts based on the Feret elongation of each edge. INFO
	M_FERET_MAX_ANGLE	Sorts based on the maximum Feret angle of each edge. INFO
	M_FERET_MAX_DIAMETER	Sorts based on the maximum Feret diameter of each edge. INFO
	M_FERET_MEAN_DIAMETER	Sorts based on the average Feret diameter at all the angles checked (see M_NUMBER_OF_FERETS).
	M_FERET_MIN_ANGLE	Sorts based on the minimum Feret angle of each edge. INFO
	M_FERET_MIN_DIAMETER	Sorts based on the minimum Feret diameter of each edge. INFO
	M_FERET_X	Sorts based on the X-Feret value of each edge. INFO
	M_FERET_Y	Sorts based on the Y-Feret value of each edge. INFO
	M_FIRST_POINT_X	Sorts based on the X-coordinate of each edge's first point (starting point). INFO
	M_FIRST_POINT_Y	Sorts based on the Y-coordinate of each edge's first point (starting point). INFO
	M_GENERAL_FERET	Sorts based on the general Feret of each edge. INFO
	M_LABEL_VALUE	Sorts based on the label value of each edge in an image. INFO
	M_LENGTH	Sorts based on the length of each edge. INFO
	M_LINE_FIT_A	Sorts based on the coefficient A of the line that is the best fit for each edge. INFO
	M_LINE_FIT_B	Sorts based on the coefficient B of the line that is the best fit for each edge. INFO
	M_LINE_FIT_C	Sorts based on the coefficient C of the line that is the best fit for each edge. INFO
	M_LINE_FIT_ERROR	Sorts based on the fit error of the line that is the best fit for each edge. INFO
	M_MOMENT_ELONGATION	Sorts based on the moment elongation of each edge. INFO
	M_MOMENT_ELONGATION_ANGLE	Sorts based on the angle of the principal axis along each edge's moment elongation (M_MOMENT_ELONGATION).
	M_POSITION_X	Sorts based on the X-position of each edge. INFO
	M_POSITION_Y	Sorts based on the Y-position of each edge. INFO
	M_SIZE	Sorts based on the number of edgels of each edge.
	M_STRENGTH	Sorts based on the strength of each edge. INFO
	M_TORTUOSITY	Sorts based on the tortuosity measure of each edge. INFO
	M_X_MAX_AT_Y_MAX	Sorts based on the maximum X-coordinate at the maximum Y-coordinate of each edge. INFO
	M_X_MIN_AT_Y_MIN	Sorts based on the minimum X-coordinate at the minimum Y-coordinate of each edge. INFO
	M_Y_MAX_AT_X_MIN	Sorts based on the maximum Y-coordinate at the minimum X-coordinate of each edge. INFO
	M_Y_MIN_AT_X_MAX	Sorts based on the minimum Y-coordinate at the maximum X-coordinate of each edge. INFO

To inquire about general Edge Finder context settings, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For general settings (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_CONTEXT_TYPE +		Inquires the type of the Edge Finder context. SET (summarize) Inquires the type of the Edge Finder context. SET (more details...)
	M_CONTOUR	Specifies a contour context type, which is used to find object contours in images.
	M_CREST	Specifies a crest context type, which is used to find thin line crests in images.
M_FILTER_POWER +		Inquires the power of the filter used to extract edges. This indicates the decreasing factor of the noise variance. In the following formula, h represents the filter values. The sum is computed over the filter support region. This region can be finite or infinite; it includes the neighboring image elements that are taken into account when computing the output image element. (summarize) Inquires the power of the filter used to extract edges. (more details...)
	Value	Specifies the power of the filter used to extract edges.
M_MASK_SIZE_X +		Inquires the X-size of the mask. (summarize) Inquires the X-size of the mask. (more details...)
	M_NULL	Specifies that no mask has been set using MedgeMask().
	Value	Specifies the X-size of the mask, in pixels.
M_MASK_SIZE_Y +		Inquires the Y-size of the mask. (summarize) Inquires the Y-size of the mask. (more details...)
	M_NULL	Specifies that no mask has been set using MedgeMask().
	Value	Specifies the Y-size of the mask, in pixels.

To inquire about the values used to calculate Feret settings, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts.

For Feret settings (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_FERET_ANGLE_SEARCH_END +		Inquires the end of the angular range at which to search for Feret diameters. The angular range is used to calculate the following Feret features: M_FERET_MAX_DIAMETER, M_FERET_MIN_DIAMETER, M_FERET_MAX_ANGLE, and M_FERET_MIN_ANGLE. SET (summarize) Inquires the end of the angular range at which to search for Feret diameters. SET (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 360.0°.
	0.0 <= Value <= 360.0	Specifies the end of the angular region.
M_FERET_ANGLE_SEARCH_START +		Inquires the start of the angular range at which to search for Feret diameters. The angular range is used to calculate the following Feret features: M_FERET_MAX_DIAMETER, M_FERET_MIN_DIAMETER, M_FERET_MAX_ANGLE, and M_FERET_MIN_ANGLE. SET (summarize) Inquires the start of the angular range at which to search for Feret diameters. SET (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 0.0°.
	0.0 <= Value <= 360.0	Specifies the start of the angular region.
M_GENERAL_FERET_ANGLE +		Inquires the angle at which to calculate M_GENERAL_FERET. SET (summarize) Inquires the angle at which to calculate M_GENERAL_FERET. SET (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 0.0°.
	M_MOMENT_ELONGATION_ANGLE + n	Specifies to use the moment elongation angle plus the offset n. INFO
	0.0 <= Value <= 360.0	Specifies the angle, in degrees.
M_NUMBER_OF_FERETS +		Inquires the number of Ferets used to calculate M_FERET_MAX_DIAMETER, M_FERET_MIN_DIAMETER, M_FERET_MAX_ANGLE, M_FERET_MIN_ANGLE, M_FERET_MEAN_DIAMETER, M_FERET_ELONGATION, and M_CONVEX_PERIMETER. SET (summarize) Inquires the number of Ferets used to calculate M_FERET_MAX_DIAMETER, M_FERET_MIN_DIAMETER, M_FERET_MAX_ANGLE, M_FERET_MIN_ANGLE, M_FERET_MEAN_DIAMETER, M_FERET_ELONGATION, and M_CONVEX_PERIMETER. SET (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_DEFAULT	Specifies the default value; the default value is 8.
	Value	Specifies the number of Ferets.

To inquire about the settings used when performing post-calculations on extracted edges, set the InquireType parameter to one of the values below. These values can be specified for both M_CONTOUR and M_CREST Edge Finder contexts.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For post-calculations (both M_CONTOUR and M_CREST)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_APPROXIMATION_TOLERANCE +		Inquires the resolution of the edge approximation. SET (summarize) Inquires the resolution of the edge approximation. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 50.0.
	0.0 <= Value <= 100.0	Specifies the resolution. INFO
M_CHAIN_APPROXIMATION +		Inquires the simple geometric features used to approximate edges. SET (summarize) Inquires the simple geometric features used to approximate edges. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the edge approximation will not be performed. INFO
	M_LINE	Specifies that the edge approximation will be performed using a polygonal segmentation of each edge. INFO
M_FILL_GAP_ANGLE +		Inquires the aperture angle where Edge Finder searches for edge extremity candidates when filling edge gaps. SET (summarize) Inquires the aperture angle where Edge Finder searches for edge extremity candidates when filling edge gaps. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 360.0°.
	0.0 <= Value <= 360.0	Specifies the aperture angle, in degrees.
M_FILL_GAP_CANDIDATE +		Inquires whether an edge extremity is filled with the other extremity of the same edge, or with an extremity of any edge. SET (summarize) Inquires whether an edge extremity is filled with the other extremity of the same edge, or with an extremity of any edge. SET (more details...)
	M_DEFAULT	Same as M_ANY.
	M_ANY	Specifies that the extremity of an edge can be connected with the extremity of any edge.
	M_SAME	Specifies that the extremity of an edge can only be connected with the other extremity of the same edge.
M_FILL_GAP_CONTINUITY +		Inquires the continuity constraint used when performing edge gap filling, when more than one edge extremity candidate is present. SET (summarize) Inquires the continuity constraint used when performing edge gap filling, when more than one edge extremity candidate is present. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 50.0.
	0.0 <= Value <= 100.0	Specifies the continuity constraint. INFO
M_FILL_GAP_DISTANCE +		Inquires the maximum distance radius where Edge Finder searches for edge extremity candidates when filling edge gaps. SET (summarize) Inquires the maximum distance radius where Edge Finder searches for edge extremity candidates when filling edge gaps. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0 pixels.
	M_INFINITE	Specifies an infinite maximum distance radius.
	Value	Specifies the maximum distance radius, in pixels. INFO
M_FILL_GAP_POLARITY +		Inquires the polarity constraint used when performing the filling of edge gaps. SET (summarize) Inquires the polarity constraint used when performing the filling of edge gaps. SET (more details...)
	M_DEFAULT	Same as M_ANY.
	M_ANY	Specifies that gaps between edges will be filled, regardless of their polarity.
	M_REVERSE	Specifies that gaps between edges that have reverse polarity will be filled. INFO
	M_SAME	Specifies that gaps between edges that have the same polarity will be filled. INFO

To inquire about general Edge Finder result buffer settings, set the InquireType parameter to one of the following values:

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For result buffer settings (general)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_DRAW_CROSS_SIZE +		Inquires the size of the cross used for certain drawing operations. For example, M_DRAW_EDGELS, M_DRAW_POSITION, and M_DRAW_CENTER_OF_GRAVITY are drawn using this cross. SET (summarize) Inquires the size of the cross used for certain drawing operations. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 4.0 pixels.
	Value	Specifies the size of the cross, in pixels.
M_MODEL_FINDER_COMPATIBLE +		Inquires whether the Edge Finder result buffer is ready to be used with a Model Finder context. SET (summarize) Inquires whether the Edge Finder result buffer is ready to be used with a Model Finder context. SET (more details...)
	M_DEFAULT	Same as M_DISABLE.
	M_DISABLE	Specifies that the Edge Finder result buffer cannot be used with a Model Finder context.
	M_ENABLE	Specifies that the Edge Finder result buffer can be used with a Model Finder context.
M_NEAREST_NEIGHBOR_RADIUS +		Inquires the radius distance used to select (MedgeSelect()) the closest edge or edges from a point. SET (summarize) Inquires the radius distance used to select (MedgeSelect()) the closest edge or edges from a point. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 2.0 pixels.
	Value	Specifies the radius distance, in pixels.
M_RESULT_OUTPUT_UNITS +		Inquires whether results are returned in pixel or world units. SET (summarize) Inquires whether results are returned in pixel or world units. SET (more details...)
	M_DEFAULT	Same as M_ACCORDING_TO_CALIBRATION.
	M_ACCORDING_TO_CALIBRATION	Specifies that results are returned in world units if the result was calculated on an image associated with a calibration context; otherwise, specifies that results are returned in pixel units.
	M_PIXEL	Specifies that results are returned in pixel units, with respect to the pixel coordinate system.
	M_WORLD	Specifies that results are returned in world units, with respect to the relative coordinate system. INFO

To inquire about Edge Finder result buffer settings used when performing closest-edgel operations with MedgeGetNeighbors(), set the InquireType parameter to one of the values below.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For result buffer settings (closest-edgel operations)
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_NEIGHBOR_ANGLE +		Inquires the gradient angle that an edgel must have, before being considered a candidate, when finding the closest edgels to a list of points. SET (summarize) Inquires the gradient angle that an edgel must have, before being considered a candidate, when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Same as M_ANY.
	M_ANY	Specifies that the edgel candidate can have any gradient angle. INFO
	M_REVERSE	Specifies that the gradient angle of the edgel candidate must have the reverse angle (+ 180°) of the source point.
	M_SAME	Specifies that the gradient angle of the edgel candidate must have the same angle as the source point.
	M_SAME_OR_REVERSE	Specifies that the gradient angle of the edgel candidate must either have the same, or the reverse angle of the source point.
M_NEIGHBOR_ANGLE_TOLERANCE +		Inquires the angular tolerance used for the angle constraint (M_NEIGHBOR_ANGLE), when finding the closest edgels to a list of points. SET (summarize) Inquires the angular tolerance used for the angle constraint (M_NEIGHBOR_ANGLE), when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 180.0°.
	0.0 <= Value <= 360.0	Specifies the angular tolerance, in degrees. INFO
M_NEIGHBOR_MAXIMUM_NUMBER +		Inquires the maximum number of closest edgel candidates that can be returned (for each source point), when finding the closest edgels to a list of points. SET (summarize) Inquires the maximum number of closest edgel candidates that can be returned (for each source point), when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 1.
	Value	Specifies the maximum number of edgels.
M_NEIGHBOR_MINIMUM_SPACING +		Inquires the minimum distance separating edgels within the same edge, in order for each to be considered potential candidates, when finding the closest edgels to a list of points. SET (summarize) Inquires the minimum distance separating edgels within the same edge, in order for each to be considered potential candidates, when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Same as M_INFINITE.
	M_INFINITE	Specifies no minimum distance separating two edgel candidates.
	Value >= 1	Specifies the minimum distance, in edgels.
M_SEARCH_ANGLE +		Inquires the search angle constraint (applied the Edge Finder result buffer), when finding the closest edgels to a list of points. SET (summarize) Inquires the search angle constraint (applied the Edge Finder result buffer), when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0.0°.
	0.0 <= Value <= 360.0	Specifies the angle, in degrees.
M_SEARCH_ANGLE_SIGN +		Inquires the orientation to use for the search angle constraint, when finding the closest edgels to a list of points. SET (summarize) Inquires the orientation to use for the search angle constraint, when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Same as M_SAME.
	M_REVERSE	Specifies that the orientation of the angle must be the reverse (+ 180°) of the source angle. INFO
	M_SAME	Specifies that the orientation of the angle must be the same as the source angle.
	M_SAME_OR_REVERSE	Specifies that the orientation of the angle can be the same as, or the reverse of, the source angle.
M_SEARCH_ANGLE_TOLERANCE +		Inquires the angular tolerance used for the search angle constraint, when finding the closest edgels to a list of points. SET (summarize) Inquires the angular tolerance used for the search angle constraint, when finding the closest edgels to a list of points. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 360.0°.
	0.0 <= Value <= 360.0	Specifies the angle, in degrees.
M_SEARCH_RADIUS_MAX +		Inquires the maximum radius distance used to search for the closest edgel candidates that match source edgels. SET (summarize) Inquires the maximum radius distance used to search for the closest edgel candidates that match source edgels. SET (more details...)
	M_DEFAULT	Same as M_INFINITE.
	M_INFINITE	Specifies a maximum distance radius that spans all edgels in the Edge Finder result buffer.
	Value	Specifies the maximum distance radius, in pixels.
M_SEARCH_RADIUS_MIN +		Inquires the minimum radius distance used to search for the closest edgel candidates that match source edgels. SET (summarize) Inquires the minimum radius distance used to search for the closest edgel candidates that match source edgels. SET (more details...)
	M_DEFAULT	Specifies the default value; the default value is 0 pixels.
	Value	Specifies the minimum distance radius, in pixels.

To inquire about the system on which either the Edge Finder context or Edge Finder result buffer has been allocated, set the InquireType parameter to the value below.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

For inquiring about the system
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_OWNER_SYSTEM +		Inquires the identifier of the system on which either the Edge Finder context or Edge Finder result buffer has been allocated. SET SET (summarize) Inquires the identifier of the system on which either the Edge Finder context or Edge Finder result buffer has been allocated. SET SET (more details...)
	M_DEFAULT_HOST	Specifies the default Host system of the current MIL application.
	MIL system identifier	Specifies a valid system identifier, previously allocated using MsysAlloc().

Combination constant for

Tables:

For operation settings (both M_CONTOUR and M_CREST)
For operation settings (M_CREST only)
For internal buffers (both M_CONTOUR and M_CREST)
For edge features (both M_CONTOUR and M_CREST)
For sorting keys (both M_CONTOUR and M_CREST)
For general settings (both M_CONTOUR and M_CREST)
For Feret settings (both M_CONTOUR and M_CREST)
For post-calculations (both M_CONTOUR and M_CREST)
For result buffer settings (general)
For result buffer settings (closest-edgel operations)
For inquiring about the system

the values listed in all the parameter association tables.

You can add the following value to the above-mentioned values to get the default value of an inquire type, regardless of the current value of the inquire type.

For inquiring the default value
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_DEFAULT		Inquires the default value of the specified inquire type. (summarize) Inquires the default value of the specified inquire type. (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE

Combination constant for

Tables:

For operation settings (both M_CONTOUR and M_CREST)
For operation settings (M_CREST only)
For internal buffers (both M_CONTOUR and M_CREST)
For edge features (both M_CONTOUR and M_CREST)
For sorting keys (both M_CONTOUR and M_CREST)
For general settings (both M_CONTOUR and M_CREST)
For Feret settings (both M_CONTOUR and M_CREST)
For post-calculations (both M_CONTOUR and M_CREST)
For result buffer settings (general)
For result buffer settings (closest-edgel operations)
For inquiring about the system

the values listed in all the parameter association tables.

You can add the following value to the above-mentioned values to determine whether an inquire type is sortable or supported for the Edge Finder context currently being inquired.

Note that to inquire if an inquire type is sortable, you must add M_SUPPORTED to the appropriate sort value (M_SORTn_UP or M_SORTn_DOWN) and the specified inquire type (for example, M_SIZE + M_SORTn_UP + M_SUPPORTED). If the inquire type is not supported for the Edge Finder context, or sortable, M_NULL is returned.

For inquiring if an inquire type is sortable or is supported
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_SUPPORTED		Inquires whether the specified inquire type is either sortable, or supported for the Edge Finder context. (summarize) Inquires whether the specified inquire type is either sortable, or supported for the Edge Finder context. (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	M_NULL	Specifies that the inquire type is not sortable, or is not supported.
	Value != 0	Specifies that the inquire type is sortable, or is supported.

Combination constants for

Tables:

For operation settings (both M_CONTOUR and M_CREST)
For operation settings (M_CREST only)
For internal buffers (both M_CONTOUR and M_CREST)
For edge features (both M_CONTOUR and M_CREST)
For sorting keys (both M_CONTOUR and M_CREST)
For general settings (both M_CONTOUR and M_CREST)
For Feret settings (both M_CONTOUR and M_CREST)
For post-calculations (both M_CONTOUR and M_CREST)
For result buffer settings (general)
For result buffer settings (closest-edgel operations)
For inquiring about the system

the values listed in all the parameter association tables.

You can add one of the following values to the above-mentioned values to cast the requested information to a required data type.

For specifying the data type
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_TYPE_MIL_DOUBLE		Casts the requested information to a MIL_DOUBLE. (summarize) Casts the requested information to a MIL_DOUBLE. (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
M_TYPE_MIL_ID		Casts the requested information to a MIL_ID. Note that M_TYPE_MIL_ID should only be used with M_OWNER_SYSTEM. (summarize) Casts the requested information to a MIL_ID. (more details...)
	UserVarPtr data type info	Data type: MIL_ID
M_TYPE_MIL_INT		Casts the requested information to a MIL_INT. (summarize) Casts the requested information to a MIL_INT. (more details...)
	UserVarPtr data type info	Data type: MIL_INT
M_TYPE_MIL_INT32		Casts the requested information to a MIL_INT32. (summarize) Casts the requested information to a MIL_INT32. (more details...)
	UserVarPtr data type info	Data type: MIL_INT32
M_TYPE_MIL_INT64		Casts the requested information to a MIL_INT64. (summarize) Casts the requested information to a MIL_INT64. (more details...)
	UserVarPtr data type info	Data type: MIL_INT64

Return value

The returned value is the requested information, cast to a MIL_INT.

Compilation information

Header	Include mil.h.
Library	Use mil.lib; miledge.lib.
DLL	Requires mil.dll; miledge.dll.