| MIL 10 Reference
| Customize Help
| Save Settings

MmeasSetMarker



See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
Synopsis
Set an essential characteristic of a marker.
Syntax
void MmeasSetMarker(
MIL_ID MarkerId, //in
MIL_INT64 CharacteristicToSet, //in
MIL_DOUBLE FirstValue, //in
MIL_DOUBLE SecondValue //in
)
Description

This function sets an essential characteristic of a marker. Essential characteristics are used in determining the location of an edge, stripe, or circle marker in a target image, or specifying the position of point markers, which are generally used as a reference marker. MmeasFindMarker() locates the edges, stripes, or circle that best correspond to the specified marker's characteristics. A marker's characteristics should describe the marker as accurately as possible to ensure that it will be successfully located in an image.

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
MarkerId

Specifies the identifier of the marker.

CharacteristicToSet

Specifies the type of characteristic to set.

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

FirstValue

Specifies the first value to assign to the characteristic.

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

SecondValue

Specifies the second value to assign to the characteristic. The SecondValue parameter only applies to stripe markers. For edge and circle markers, set the SecondValue parameter to M_NULL.

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

The following CharacteristicToSet and corresponding FirstValue and SecondValue parameter settings are used to specify the expected measurement marker characteristics, for point, edge, stripe, and circle markers. Note that the SecondValue parameter should be set to M_NULL if no parameter setting is required.

function map For point, edge, stripe, and circle markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_MARKER_REFERENCE

Sets the offset at which to place the marker's reference position, relative to the marker's actual position. The reference position is only used in calculations between two markers (MmeasCalculate()).

  • For point markers, MIL measures the specified offset relative to the X- and Y-coordinates set for the point using M_POSITION.

  • For edge markers, MIL measures the specified offset relative to the X- and Y-coordinates of the edge's maximum edgevalue.

  • For stripe markers, MIL measures the specified offset relative to the X- and Y-coordinates at the center of a theoretical line between the position (maximum edgevalue) of the stripe's two outermost edges.

  • For circle markers, MIL measures the specified offset relative to the X- and Y-coordinates at the circle's center.

By default, the marker's reference position is the same as its actual position (the default offset is 0).

(summarize)
Collapse FirstValue

Specifies the X-offset at which to place the marker's reference position. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.

Collapse Value

Specifies the X-offset value, in the same units as the input coordinate system specified using M_MARKER_REFERENCE_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-offset at which to place the marker's reference position. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.

Collapse Value

Specifies the Y-offset value, in the same units as the input coordinate system specified using M_MARKER_REFERENCE_INPUT_UNITS.

Collapse M_MARKER_REFERENCE_INPUT_UNITS

Sets the units with which to interpret M_MARKER_REFERENCE. This essentially sets the input coordinate system to use.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_PIXEL.

Collapse M_PIXEL

Specifies to interpret the value in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies to interpret the value in world units, according to the relative coordinate system. If world units are specified, calling MmeasDraw() to draw expected marker characteristics or MmeasFindMarker() generates an error if the operation is not performed on a calibrated image.

(summarize)
Collapse M_RESULT_OUTPUT_UNITS

Sets whether to return results in pixels or world units. This essentially sets the output coordinate system to use.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_ACCORDING_TO_CALIBRATION.

Collapse 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.

Collapse M_PIXEL

Specifies that results are returned in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies that results are returned in world units, according to the relative coordinate system. If world units are specified, calling MmeasGetResult() or MmeasGetResultSingle() generates an error if the result was not calculated on a calibrated image.

(summarize)

For point, edge, and stripe markers, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For point, edge, and stripe markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_NUMBER

Sets the number of edges or stripes to locate in the box search region, or the number of points to explicitly define (points are typically used as a reference marker). In the first case, this can be referred to as the number of marker occurrences.

When M_NUMBER is set to a value greater than 1, the marker is considered a multiple marker. Note that a circle marker cannot be set as a multiple marker.

For edges and stripes, unless a minimum number (M_NUMBER_MIN) is specified, no results will be returned if the number of marker occurrences found falls below M_NUMBER.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 1.

Collapse M_ALL

Specifies that the search should locate all edges or stripes in the box search region. This setting cannot be used for a point marker.

If using M_ALL and M_NUMBER_MIN is set to M_DEFAULT, M_NUMBER_MIN is ignored and MIL will find as many marker occurrences as it can in the image. However, if M_NUMBER_MIN is set to a value other than M_DEFAULT, this value is respected and results are returned, provided that the specified minimum number of markers are found.

(summarize)
Collapse Value

Specifies the number of edges or stripes to locate, or point markers to define.

For edge, stripe, and circle markers, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For edge, stripe, and circle markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_EDGEVALUE_MIN

Sets the minimum edgevalue required for it to be considered an occurrence of the marker.

MIL establishes edgevalues by taking the normalized first derivative of the intensity profile, which generally resembles a peak when an edge is present. When searching for multiple edges, you might need to further constrain the edgevalues that MIL considers, using M_EDGEVALUE_VAR_MIN.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 2.0.

Collapse 0.0 <= Value <= 100.0

Specifies the minimum edgevalue.

A setting of 0.0 indicates that MIL considers all edgevalues, while a setting of 100.0 indicates that MIL only considers the greatest possible edgevalue. The greatest possible edgevalue results from a perfectly straight, perfectly white to perfectly black (or vice-versa) grayscale transition over one pixel. If you set the minimum edgevalue to a very low value, MmeasFindMarker() can take longer to execute.

(summarize)
Collapse M_EDGEVALUE_VAR_MIN

Sets the minimum prominence required for an edge peak, for it to be considered an occurrence of the marker. To determine if the minimum prominence is met, MIL establishes a local threshold for each peak by subtracting M_EDGEVALUE_VAR_MIN from it.

The portion of the profile above the local threshold that contains the edge peak can be referred to as the peak's interval, provided that the profile eventually dips below the local threshold on both sides of its edge peak. For MIL to consider a peak to be an edge, there must be no edgevalues greater than that peak within its interval. If the local threshold calculated with M_EDGEVALUE_VAR_MIN is less than M_EDGEVALUE_MIN, the local threshold equals M_EDGEVALUE_MIN.

M_EDGEVALUE_VAR_MIN is typically used by advanced applications where you are trying to find multiple neighboring edges in the search region, which are formed such that the foreground of the first edge becomes the background of the next edge.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 100.0.

Collapse 0.0 <= Value <= 100.0

Specifies the minimum prominence.

A setting of 0.0 indicates no prominence; that is, MIL only considers the maximum edgevalue of the peak's interval. A setting of 100.0 (default) indicates the greatest possible prominence; that is, MIL considers all edgevalues of the peak's interval that are above M_EDGEVALUE_MIN. In this case, M_EDGEVALUE_VAR_MIN has no effect.

(summarize)
Collapse M_FILTER_SMOOTHNESS

Sets the degree of smoothness (strength of denoising) applied to the internal projection buffer of the search region during the edge extraction. The recursive edge extraction process involves a denoising operation.

Note that M_FILTER_SMOOTHNESS is only available if M_FILTER_TYPE is set to M_SHEN.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 50.0.

Collapse 0.0 <= Value <= 100.0

Specifies the smoothness value.

A value of 100.0 results in a strong noise reduction effect, while a value of 0.0 has almost no noise reduction effect.

(summarize)
Collapse M_FILTER_TYPE

Sets the type of the first derivative filter with which to perform the edge extraction. The edgevalue calculated for each projection value of the search region is dependent on this setting.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_EULER.

Collapse M_EULER

Specifies an Euler FIR filter. This filter performs a non-recursive edge extraction operation with a predefined kernel of size 2:

[-1,1]

This filter is faster but more sensitive to noise, compared to M_PREWITT filter.

(summarize)
Collapse M_PREWITT

Specifies a Prewitt FIR filter. This filter performs a non-recursive edge extraction operation with a predefined kernel of size 3:

[-1,0,1]

This filter is slower but less sensitive to noise, compared to M_EULER filter.

(summarize)
Collapse M_SHEN

Specifies a Shen-Castan Infinite Support Exponential filter. This is an exponential weighting function, of the general form:

This filter performs a recursive edge extraction operation using an IIR filter. If this filter actually used a kernel, the kernel size would be theoretically infinite.

This IIR filter is slower than FIR filters (M_EULER or M_PREWITT). However, this filter is less sensitive to noise and provides more accurate results. You can also control the strength of denoising applied to the projection buffer of the search region during the edge extraction, using the M_FILTER_SMOOTHNESS setting.

(summarize)
Collapse M_MAX_ASSOCIATION_DISTANCE

Sets the maximum distance between a marker's edge (either straight or circular) and its associated subedges. The subedges' positions are points extracted from the marker's subregions that are used during the fit operation. For edge and stripe markers, M_MAX_ASSOCIATION_DISTANCE is measured perpendicular from the fitted edge position, along to the search direction. For circle markers, M_MAX_ASSOCIATION_DISTANCE is measured radially from the fitted circle perimeter.

Subedges falling outside the specified maximum distance are considered outliers and are not used to perform the marker's line or circle fit operation. For edge and stripe markers, this leads to fitted edges more in line with the marker orientation and, for circle markers, this ensures that the fitted circle will be fitted on subedges roughly at the same distance from the fitted circle center.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value. By default, there is no maximum distance; the entire search region is searched for subedges.

(summarize)
Collapse Value

Specifies the distance, in the units of the input coordinate system specified using M_MAX_ASSOCIATION_DISTANCE_INPUT_UNITS.

Collapse M_MAX_ASSOCIATION_DISTANCE_INPUT_UNITS

Sets the units with which to interpret M_MAX_ASSOCIATION_DISTANCE. This essentially sets the input coordinate system to use.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_PIXEL.

Collapse M_PIXEL

Specifies to interpret the value in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies to interpret the value in world units, according to the relative coordinate system. If world units are specified, calling MmeasDraw() to draw expected marker characteristics or MmeasFindMarker() generates an error if the operation is not performed on a calibrated image.

(summarize)
Collapse M_POLARITY

Specifies the polarity of the marker. Polarity indicates whether an edge must be a rising edge (increase in grayscale value) or a falling edge (decrease in grayscale value).

(summarize)
Collapse FirstValue

Specifies the polarity of the edge. For stripe markers, this is the polarity of the first edge. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies that polarity is not considered.

Collapse M_NEGATIVE

Specifies that the polarity of the edge is negative (falling edge). For circle markers, this indicates that the inside of the ring-shaped region has a greater grayscale value (falling edge from inside to outside).

(summarize)
Collapse M_POSITIVE

Specifies that the polarity of the edge is positive (rising edge). For circle markers, this indicates that the inside of the ring-shaped region has a lower grayscale value (rising edge from inside to outside).

(summarize)
Collapse SecondValue

Specifies the polarity of the second edge of a stripe. INQ

(summarize)
Collapse M_DEFAULT

Same as M_OPPOSITE.

Collapse M_NULL

Specifies that this parameter does not apply.

This setting must be used for edge and circle markers.

(summarize)
Collapse M_ANY

Specifies that the polarity is not considered.

Collapse M_NEGATIVE

Specifies that the polarity of the second edge is negative (falling edge).

Collapse M_OPPOSITE

Specifies that the polarity of the second edge of a stripe marker is the opposite of that of the first edge.

Collapse M_POSITIVE

Specifies that the polarity of the second edge is positive (rising edge).

Collapse M_SAME

Specifies that the polarity of the second edge of a stripe marker is the same as that of the first edge.

Collapse M_SEARCH_REGION_CLIPPING

Sets whether MIL can automatically clip the marker's search region, when it falls outside the image.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies that the search region cannot be automatically clipped. In this case, if the search region falls outside the image, the marker cannot be found (unless you are using subregions).

(summarize)
Collapse M_MAXIMIZE_AREA

Specifies that, if the search region falls outside the image, MIL can automatically clip the region according to the best valid area in which to search, and the marker can still be found. The modified region is internally created by MIL; the actual search region that you defined is never altered.

The automatically determined region must be inscribed by the defined search region, must be within the boundaries of the image, and must meet the specified M_SEARCH_REGION_CLIPPING_... conditions. MIL will not clip the region if it cannot adhere to all of these requirements.

(summarize)
Collapse M_SEARCH_REGION_CLIPPING_MIN_AREA

Sets the minimum area requirement for the clipped region that can be internally created when using M_SEARCH_REGION_CLIPPING with M_MAXIMIZE_AREA.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.

Collapse Value >= 0.0

Specifies the minimum area required for the clipped region, in pixels.

Collapse M_SEARCH_REGION_CLIPPING_MIN_HEIGHT

Sets the minimum width requirement for the clipped region that can be internally created when using M_SEARCH_REGION_CLIPPING with M_MAXIMIZE_AREA.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.

Collapse Value >= 0.0

Specifies the minimum height required for the clipped region, in pixels.

Collapse M_SEARCH_REGION_CLIPPING_MIN_WIDTH

Sets the minimum width requirement for the clipped region that can be internally created when using M_SEARCH_REGION_CLIPPING with M_MAXIMIZE_AREA.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.

Collapse Value >= 0.0

Specifies the minimum width required for the clipped region, in pixels.

Collapse M_SEARCH_REGION_CLIPPING_PRESERVE_CENTER

Sets the center requirement for the clipped region that can be internally created when using M_SEARCH_REGION_CLIPPING with M_MAXIMIZE_AREA. All the settings are available to edge and stripe markers, but only M_DEFAULT and M_AUTO are available to circle markers.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_AUTO.

Collapse M_ALONG_HEIGHT

Specifies that the center, along the height of the defined search region, must be preserved in the clipped region. This setting is not available for circle markers.

(summarize)
Collapse M_ALONG_WIDTH

Specifies that the center, along the width of the defined search region, must be preserved in the clipped region. This setting is not available for circle markers.

(summarize)
Collapse M_AUTO

Specifies that MIL will determine how the center of the defined search region will be preserved in the clipped region. For edge and stripe markers, M_AUTO is the same as M_NONE. For circle markers, M_AUTO is the only possible value.

(summarize)
Collapse M_NONE

Specifies that the clipped region need not preserve the center of the defined search region. This setting is not available for circle markers.

(summarize)
Collapse M_SEARCH_REGION_INPUT_UNITS
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_PIXEL.

Collapse M_PIXEL

Specifies to interpret the values in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies to interpret the values in world units, according to the relative coordinate system. If world units are specified, calling MmeasDraw() to draw expected marker characteristics or MmeasFindMarker() generates an error if the operation is not performed on a calibrated image.

(summarize)
Collapse M_SUB_REGIONS_NUMBER

Sets the number of sections in which to divide the search region. Since a subregion of each section is processed, this number also corresponds to the number of subregions to process.

For circle markers, this value will give each subregion the same area; that is, each subregion will occupy (360/M_SUB_REGIONS_NUMBER) o of the circle.

For edge and stripe markers, if you specify one subregion when multiple subregions are required (for example, when using MmeasFindMarker() with M_DEFAULT, M_ANGLE, or M_LINE_EQUATION), MIL internally uses three subregions.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value. For edge and stripe markers, the default is one. For circle markers, the default is eight.

(summarize)
Collapse 1 <= Value < 8

Specifies a number of sections (subregions) that can only be used for edge and stripe markers.

Collapse Value >= 8

Specifies a number of sections (subregions) that can be used for edge, stripe, and circle markers.

Collapse M_SUBPIXEL_MODE

Sets how MIL calculates subpixel positions.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_LOCAL.

Collapse M_GLOBAL

Specifies that MIL calculates subpixel positions based on the entire region within which the edge is found. This mode is recommended when measuring wide edges.

(summarize)
Collapse M_LOCAL

Specifies that MIL calculates subpixel positions based on the immediate neighborhood within which the edge's maximum edgevalue is found. This mode offers more precision, but can be less stable with wide edges.

(summarize)

For edge and stripe markers, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For edge and stripe markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_BOX_ANGLE

Sets the angle of the box search region.

The center of rotation of the box search region is set with M_BOX_ANGLE_REFERENCE.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0°.

Collapse M_ANY

Specifies that the content of the box search region is analyzed to automatically determine the angle of the marker.

Collapse 0 <= Value <= 360

Specifies the angle of the box search region, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

An angle interpreted using the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle according 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.

(summarize)
Collapse M_BOX_ANGLE_ACCURACY

Sets the accuracy of the angular search.

This determines the size of the step angle to use once the approximate location of the marker is found.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies the angle of accuracy to be equal to the angle of tolerance.

Collapse 0.1 <= Value <= 180.0

Specifies the accuracy of the angular search, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_ANGLE_DELTA_NEG

Sets the negative range of angles within which to search for the marker.

The search is performed between the range of angles defined by: (M_BOX_ANGLE - M_BOX_ANGLE_DELTA_NEG) to (M_BOX_ANGLE + M_BOX_ANGLE_DELTA_POS), inclusively, starting with an angle closest to that of M_BOX_ANGLE.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default negative range of angles, in degrees.

For a symmetrical stripe marker (a marker set with M_OPPOSITE), the default is 180.0.

For an edge marker or a non-symmetrical stripe marker, the default is 360.0.

(summarize)
Collapse 0.1 <= Value <= 360.0

Specifies the negative range of angles, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_ANGLE_DELTA_POS

Sets the positive range of angles within which to search for the marker.

The search is performed between the range of angles defined by: (M_BOX_ANGLE - M_BOX_ANGLE_DELTA_NEG) to (M_BOX_ANGLE + M_BOX_ANGLE_DELTA_POS), inclusively, starting with an angle closest to that of M_BOX_ANGLE.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default positive range of angles, in degrees.

For a symmetrical stripe marker (a marker set with M_OPPOSITE), the default is 180.0.

For an edge marker or a non-symmetrical stripe marker, the default is 360.0.

(summarize)
Collapse 0.1 <= Value <= 360.0

Specifies the positive range of angles, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_ANGLE_MODE

Enables the use of multiple-angle search, as specified by the settings of other M_BOX_ANGLE... characteristics. The angle of the marker with the highest match score is returned. For an edge marker, this is the score of the edge, and for a stripe marker, this is the mean score of the edges.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies that the search should only be performed at the angle specified by M_BOX_ANGLE.

Collapse M_ENABLE

Specifies that multiple-angle search is enabled.

Collapse M_BOX_ANGLE_REFERENCE

Sets the center of rotation to use when M_BOX_ANGLE is not zero.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_BOX_CENTER.

Collapse M_BOX_CENTER

Specifies the center of the box search region as the center of rotation. Use the M_BOX_CENTER characteristic to set the coordinates of the center of the box search region.

(summarize)
Collapse M_BOX_ORIGIN

Specifies the top-left corner of the box search region as the center of rotation. Use the M_BOX_ORIGIN characteristic to set the coordinates of the top-left corner of the box search region.

(summarize)
Collapse M_BOX_ANGLE_TOLERANCE

Sets the rotation tolerance of the marker.

This is the full range of degrees within which a marker can be rotated from a box search region that is at a specific angle and still be found. This determines the step angle used for a multiple-angle search.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 5.0.

Collapse 0.1 <= Value <= 360.0

Specifies the rotation tolerance, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_CENTER

Sets the coordinates of the center of the box search region.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

When you change M_BOX_CENTER, MIL recalculates M_BOX_ORIGIN, relative to the new center position.

(summarize)
Collapse FirstValue

Specifies the X-coordinate of the center of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default X-coordinate of the center of the box search region. This depends on the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. If using pixel units, the default center is the center of the pixel coordinate system. If using world units, the default center is the origin of the relative coordinate system.

(summarize)
Collapse Value

Specifies the X-coordinate of the center of the box search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-coordinate of the center of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default Y-coordinate of the center of the box search region. This depends on the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. If using pixel units, the default center is the center of the pixel coordinate system. If using world units, the default center is the origin of the relative coordinate system.

(summarize)
Collapse Value

Specifies the Y-coordinate of the center of the box search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_ORIGIN

Sets the coordinates of the top-left corner of the box search region.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

When you change M_BOX_ORIGIN, MIL recalculates M_BOX_CENTER, relative to the new box origin.

(summarize)
Collapse FirstValue

Specifies the X-coordinate of the origin of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default X-coordinate of the origin of the box search region. The default origin is the origin of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

(summarize)
Collapse Value

Specifies the X-coordinate of the origin of the box search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-coordinate of the origin of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default Y-coordinate of the origin of the box search region. The default origin is the origin of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

(summarize)
Collapse Value

Specifies the Y-coordinate of the origin of the box search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_BOX_SIZE

Sets the width and height of the box search region.

If M_SEARCH_REGION_INPUT_UNITS is set to M_WORLD, the Measurement module uses the world dimensions specified to estimate a rectangular box in pixel units. The module will then use this approximation for internal calculations.

Note that the search region must fit entirely inside the target image, unless subregions are used or clipping is enabled. If don't use subregions or enable clipping, and you choose a location, size, or search angle that causes the box to extend beyond the edge of the target image, the marker cannot be found (MmeasGetResult() with M_VALID_FLAG will return M_FALSE).

When you set the width and height of the search region, the search region expands or shrinks with respect to its origin, set with M_BOX_ORIGIN. When the width or height changes, MIL recalculates M_BOX_CENTER, relative to the box search region's origin.

Note that if you have enabled clipping, the size of the box search region internally use might be smaller than the specified size. This is only a temporary effect; it does not change the specified size. For more information, see the Search region section of Chapter 13: Measurement.

(summarize)
Collapse FirstValue

Specifies the width of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies to use the width of the entire target image. If you specify M_DEFAULT, and M_SEARCH_REGION_INPUT_UNITS is set to M_WORLD, you must also set the SecondValue parameter to M_DEFAULT; otherwise, an error will occur.

(summarize)
Collapse Value

Specifies the width of the box search region within the target image, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. This value must be positive.

(summarize)
Collapse SecondValue

Specifies the height of the box search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies to use the height of the entire target image. If you specify M_DEFAULT, and M_SEARCH_REGION_INPUT_UNITS is set to M_WORLD, you must also set the FirstValue parameter to M_DEFAULT; otherwise, an error will occur.

(summarize)
Collapse Value

Specifies the height of the box search region within the target image, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. This value must be positive.

(summarize)
Collapse M_DRAW_PROFILE_SCALE_OFFSET

Sets the scale and offset to use when drawing the edge profile or edgevalue characteristics using MmeasDraw() with M_DRAW_EDGES_PROFILE, M_DRAW_EDGEVALUE_MIN_IN_PROFILE, M_DRAW_EDGEVALUE_PEAK_WIDTH_IN_PROFILE, or M_DRAW_POSITION_IN_PROFILE.

(summarize)
Collapse FirstValue

Sets the scale to use when drawing. The shape and proportions of the drawing are kept the same; only the size is affected. This can be useful for applications where the information being drawn is too small or too large to see clearly. INQ

(summarize)
Collapse M_AUTO_SCALE_PROFILE

Specifies to automatically compute the greatest scale factor that will fit the entire drawing within the destination buffer (or within the area that corresponds to the search region, if M_DRAW_IN_BOX is combined when drawing) after the offset has been applied.

Collapse Value > 0

Specifies the scale multiplier.

The default value is 1.

(summarize)
Collapse SecondValue

Sets the offset at which to draw the information from the middle of the height of the destination buffer or the area corresponding to the search region. The shape and proportions of the drawing are kept the same; only the location is affected. The middle is described as the center height of the image buffer or the profile's associated search region, and is at an offset of 0. INQ

(summarize)
Collapse M_AUTO_OFFSET_PROFILE

Specifies to automatically compute the offset such that the maximum and minimum of the drawing are touching the ends of the destination buffer (or the area that corresponds to the search region, if M_DRAW_IN_BOX is combined when drawing). This value can only be used when FirstValue is set to M_AUTO_SCALE_PROFILE.

Note that this value is optimized for M_DRAW_EDGES_PROFILE. Using M_AUTO_OFFSET_PROFILE with other M_DRAW_..._PROFILE values might draw outside of the destination (image buffer or the area corresponding to the search region).

(summarize)
Collapse Value

Specifies the offset from the middle of the height of the destination buffer or the area corresponding to the search region. The ends of the destination buffer or the area corresponding to the search region correspond to offsets -100 and 100. There is no limit to the offset value. However, large values might cause the required drawing to be drawn outside the visible area.

The default value is 0.

(summarize)
Collapse M_NUMBER_MIN

Sets the minimum number of edges or stripes to locate in the box search region.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_NUMBER.

Collapse Value

Specifies the minimum number of edges or stripes to locate.

Collapse M_ORIENTATION

Sets the orientation of the edge or stripe marker.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_VERTICAL.

Collapse M_ANY

Specifies that the orientation of the marker is unknown; both horizontal and vertical orientations are searched.

Collapse M_HORIZONTAL

Specifies that the marker has a horizontal orientation.

Collapse M_VERTICAL

Specifies that the marker has a vertical orientation.

Collapse M_SEARCH_REGION_ANGLE_INTERPOLATION_MODE

Sets the type of interpolation to use when searching for markers. This only has an effect when either M_BOX_ANGLE_MODE is enabled or M_BOX_ANGLE is set to a value other than 0.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_BILINEAR.

Collapse M_BICUBIC

Specifies a bicubic interpolation.

Collapse M_BILINEAR

Specifies a bilinear interpolation.

Collapse M_NEAREST_NEIGHBOR

Specifies a nearest neighbor interpolation.

Collapse M_SUB_REGIONS_OFFSET

Sets the offset of the subregions, from the center point of each of their sections.

Specify the offset as a percentage of the distance from the center point of the section to the maximum possible offset in each section. 100 corresponds to the maximum possible offset. The direction of the offset (X or Y) is taken from M_ORIENTATION, with positive values shifting the subregion down or to the right, and negative values shifting up or to the left.

Note that subregions are offset as a group.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.

Collapse -100 <= Value <= 100

Specifies the offset of the subregions.

Collapse M_SUB_REGIONS_SIZE

Sets the size of the subregions, as a percentage of their section.

Subregions are always rectangular and extend from one edge of the box search region to the other in the orientation direction. If made smaller than their section, the subregions become thinner and occupy the specified percentage of their section. In this case, subregions will remain centered unless moved with M_SUB_REGIONS_OFFSET.

Note that the size of subregions are set as a group.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 100%.

Collapse 0 <= Value <= 100

Specifies the size of the subregions, as a percentage. If the size is set to 100, subregions will be evenly distributed within the box search region, with no space between them.

(summarize)

For point markers only, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For point markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_MULTIPLE_POINT_ANGLE

Sets the angle at which subsequent points are placed, in a theoretical line, for a multiple point marker (at the interval set with M_SPACING and proceeding from the coordinates defined by M_POSITION).

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0°.

Collapse 0 <= Value <= 360

Specifies the angle for a multiple point marker, in degrees, in the units of the input coordinate system specified using M_POINT_INPUT_UNITS.

An angle interpreted according to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle according 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.

(summarize)
Collapse M_POINT_INPUT_UNITS

Sets the units with which to interpret M_POSITION, M_SPACING, and M_MULTIPLE_POINT_ANGLE. This essentially sets the input coordinate system to use.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_PIXEL.

Collapse M_PIXEL

Specifies to interpret the values in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies to interpret the values in world units, according to the relative coordinate system. If world units are specified, calling MmeasDraw() to draw expected marker characteristics generates an error if the operation is not performed on a calibrated image.

(summarize)
Collapse M_POSITION

Sets the coordinates of a point marker.

For a multiple point marker, this defines the position of the first point.

(summarize)
Collapse FirstValue

Specifies the X-coordinate of the point marker. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies that the position is invalid. When a point marker is allocated, M_POSITION is set to M_ANY. After allocation, you must explicitly set a position (X-coordinate, Y-coordinate); otherwise, an error will occur.

(summarize)
Collapse Value

Specifies the X-coordinate of the point marker, in the units of the input coordinate system specified using M_POINT_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-coordinate of the point marker. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies that the position is invalid. When a point marker is allocated, M_POSITION is set to M_ANY. After allocation, you must explicitly set a position (X-coordinate, Y-coordinate); otherwise, an error will occur.

(summarize)
Collapse Value

Specifies the Y-coordinate of the point marker, in the units of the input coordinate system specified using M_POINT_INPUT_UNITS.

Collapse M_SPACING

Sets the spacing (distance) between points of a point marker. This setting is only available for multiple point markers.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies that the spacing is invalid. When a point marker is allocated, M_SPACING is set to M_ANY. After allocation, you must explicitly set the spacing; otherwise, an error will occur.

(summarize)
Collapse Value

Specifies the spacing, in the units of the input coordinate system specified using M_POINT_INPUT_UNITS.

For stripe markers only, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For stripe markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_INCLUSION_POINT

Sets a position (inclusion point) in the target image that must either be included or not included in the stripe marker found, depending on M_INCLUSION_POINT_INSIDE_STRIPE. If you specify an inclusion point, you must also set M_INCLUSION_POINT_INSIDE_STRIPE to M_YES or M_NO; otherwise, the specified inclusion point is ignored. INQ

(summarize)
Collapse FirstValue

Specifies the X-coordinate of the inclusion point.

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies no inclusion point. In this case, M_INCLUSION_POINT_INSIDE_STRIPE is ignored.

(summarize)
Collapse Value

Specifies the inclusion point's X-coordinate, in the units of the input coordinate system specified using M_INCLUSION_POINT_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-coordinate of the inclusion point.

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies no inclusion point. In this case, M_INCLUSION_POINT_INSIDE_STRIPE is ignored.

(summarize)
Collapse Value

Specifies the inclusion point's Y-coordinate, in the units of the input coordinate system specified using M_INCLUSION_POINT_INPUT_UNITS.

Collapse M_INCLUSION_POINT_INPUT_UNITS

Sets the units with which to interpret M_INCLUSION_POINT. This essentially sets the input coordinate system to use.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_PIXEL.

Collapse M_PIXEL

Specifies to interpret the value in pixel units, according to the pixel coordinate system.

Collapse M_WORLD

Specifies to interpret the value in world units, according to the relative coordinate system. If world units are specified, calling MmeasDraw() to draw expected marker characteristics or MmeasFindMarker() generates an error if the operation is not performed on a calibrated image.

(summarize)
Collapse M_INCLUSION_POINT_INSIDE_STRIPE

Sets whether the stripe marker found must contain the inclusion point (M_INCLUSION_POINT).

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_ANY.

Collapse M_ANY

Specifies that M_INCLUSION_POINT is ignored.

Collapse M_NO

Specifies that only stripes that have the inclusion point falling outside its two outer edges can be found.

Collapse M_YES

Specifies that only stripes that have the inclusion point falling between its two outer edges can be found.

For circle markers only, the CharacteristicToSet and corresponding FirstValue and SecondValue parameters can be set to the following:

function map For circle markers
CollapseCharacteristicToSet Description
FirstValue
SecondValue
Collapse M_CIRCLE_ACCURACY

Sets the accuracy of the circle's fit operation.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_HIGH.

Collapse M_HIGH

Specifies that the circle's fit operation will be performed with high accuracy. This typically takes longer than low accuracy, but can produce more precise results.

(summarize)
Collapse M_LOW

Specifies that the circle's fit operation will be performed with low accuracy. This is typically faster than high accuracy, but can produce less precise results, particularly with noisy or badly contrasted images.

(summarize)
Collapse M_CIRCLE_INSIDE_SEARCH_REGION

Sets whether the circle's fit operation can result in a circle that is outside the ring search region.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies that the circle's fit operation can result in a circle that is outside the ring search region.

Collapse M_ENABLE

Specifies that the circle's fit operation cannot result in a circle that is outside the ring search region.

Collapse M_RING_CENTER

Sets the coordinates of the center of the ring search region. The ring's center is considered to be its position.

Note that at least three valid subregions must be within the target image for the circle marker to be found (even if clipping is enabled).

(summarize)
Collapse FirstValue

Specifies the X-coordinate of the center of the ring search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default X-coordinate of the center of the ring search region. This depends on the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. If using pixel units, the default center is the center of the pixel coordinate system. If using world units, the default center is the origin of the relative coordinate system.

(summarize)
Collapse Value

Specifies the X-coordinate of the center of the ring search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse SecondValue

Specifies the Y-coordinate of the center of the ring search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default Y-coordinate of the center of the ring search region. This depends on the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS. If using pixel units, the default center is the center of the pixel coordinate system. If using world units, the default center is the origin of the relative coordinate system.

(summarize)
Collapse Value

Specifies the Y-coordinate of the center of the ring search region, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_RING_RADII

Sets the inner and outer radius of the ring search region. The radii values are set according to the region's center (M_RING_CENTER). The inner and outer radius must be set concurrently. The inner radius must be less than the outer radius; this creates a ring within which the circle must be found.

(summarize)
Collapse FirstValue

Specifies the inner radius of the ring search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies an inner radius of 0.0. If the outer radius is set to M_DEFAULT, the inner radius must also be set to M_DEFAULT; otherwise, an error will occur.

(summarize)
Collapse Value >= 0

Specifies the inner radius, relative to the center of the ring search region, in the units specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse SecondValue

Specifies the outer radius of the ring search region. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default outer radius. This value corresponds to either half the target image's width (X-size x 0.5) or half its height (Y-size x 0.5), depending on which is smaller. Note that if the outer radius is set to M_DEFAULT, the inner radius must also be set to M_DEFAULT; otherwise, an error will occur.

(summarize)
Collapse Value > Inner radius

Specifies the outer radius, relative to the center of the ring search region, in the units specified using M_SEARCH_REGION_INPUT_UNITS.

Collapse M_SUB_REGIONS_CHORD_ANGLE

Sets the angle with which to set the ring search region's outer ring segment (chord). The projection of this chord segment determines the dimension of the rectangular subregion that is perpendicular to radial direction.

(summarize)
Collapse FirstValue

Specifies one of the following.INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 10.0 degrees.

Collapse 0 < Value <= 45.0

Specifies the angle, in degrees, in the units of the input coordinate system specified using M_SEARCH_REGION_INPUT_UNITS.

An angle interpreted according to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle according 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.

(summarize)
Compilation information
Header Include mil.h.
Library Use mil.lib; milmeas.lib.
DLL Requires mil.dll; milmeas.dll.
MARKER REFERENCE DEFAULT DEFAULT MARKER REFERENCE INPUT UNITS DEFAULT PIXEL WORLD RESULT OUTPUT UNITS DEFAULT ACCORDING TO CALIBRATION PIXEL WORLD NUMBER DEFAULT ALL EDGEVALUE MIN DEFAULT EDGEVALUE VAR MIN DEFAULT FILTER SMOOTHNESS DEFAULT FILTER TYPE DEFAULT EULER PREWITT SHEN MAX ASSOCIATION DISTANCE DEFAULT MAX ASSOCIATION DISTANCE INPUT UNITS DEFAULT PIXEL WORLD POLARITY DEFAULT ANY NEGATIVE POSITIVE DEFAULT NULL ANY NEGATIVE OPPOSITE POSITIVE SAME SEARCH REGION CLIPPING DEFAULT DISABLE MAXIMIZE AREA SEARCH REGION CLIPPING MIN AREA DEFAULT SEARCH REGION CLIPPING MIN HEIGHT DEFAULT SEARCH REGION CLIPPING MIN WIDTH DEFAULT SEARCH REGION CLIPPING PRESERVE CENTER DEFAULT ALONG HEIGHT ALONG WIDTH AUTO NONE SEARCH REGION INPUT UNITS DEFAULT PIXEL WORLD SUB REGIONS NUMBER DEFAULT SUBPIXEL MODE DEFAULT GLOBAL LOCAL BOX ANGLE DEFAULT ANY BOX ANGLE ACCURACY DEFAULT DISABLE BOX ANGLE DELTA NEG DEFAULT BOX ANGLE DELTA POS DEFAULT BOX ANGLE MODE DEFAULT DISABLE ENABLE BOX ANGLE REFERENCE DEFAULT BOX CENTER BOX ORIGIN BOX ANGLE TOLERANCE DEFAULT BOX CENTER DEFAULT DEFAULT BOX ORIGIN DEFAULT DEFAULT BOX SIZE DEFAULT DEFAULT DRAW PROFILE SCALE OFFSET AUTO SCALE PROFILE AUTO OFFSET PROFILE NUMBER MIN DEFAULT ORIENTATION DEFAULT ANY HORIZONTAL VERTICAL SEARCH REGION ANGLE INTERPOLATION MODE DEFAULT BICUBIC BILINEAR NEAREST NEIGHBOR SUB REGIONS OFFSET DEFAULT SUB REGIONS SIZE DEFAULT MULTIPLE POINT ANGLE DEFAULT POINT INPUT UNITS DEFAULT PIXEL WORLD POSITION DEFAULT ANY DEFAULT ANY SPACING DEFAULT ANY INCLUSION POINT DEFAULT ANY DEFAULT ANY INCLUSION POINT INPUT UNITS DEFAULT PIXEL WORLD INCLUSION POINT INSIDE STRIPE DEFAULT ANY NO YES CIRCLE ACCURACY DEFAULT HIGH LOW CIRCLE INSIDE SEARCH REGION DEFAULT DISABLE ENABLE RING CENTER DEFAULT DEFAULT RING RADII DEFAULT DEFAULT SUB REGIONS CHORD ANGLE DEFAULT STRIPE EDGE CIRCLE POINT