MmeasSetMarker

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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

Specifies that this parameter does not apply.

This setting must be used for edge and circle markers.

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

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.

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.

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.

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.

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

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.

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

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.

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.

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 26: Calibrating your camera setup.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

This is the default value.

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

This is the default 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.

Specifies the default value.

The default number of edges or stripes is the same as the value set in M_NUMBER.

Specifies bicubic interpolation. The new value is determined by taking a weighted average of the 16 values (4x4) that surround the source point. Note that the sum of the weights used for bicubic interpolation might be greater than one. If this occurs and the result reflects an overflow or underflow, the result is saturated.

Specifies bilinear interpolation. The new value is determined by taking a weighted average of the 4 values (2x2) that surround the source point.

Specifies nearest neighbor interpolation. The new value is that of the pixel closest to the source point.

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.

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 26: Calibrating your camera setup.

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.

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.

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.

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.

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

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

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.

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.

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.

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.

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.

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.

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.

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 26: Calibrating your camera setup.