| MIL 10 Reference
| Customize Help
| Save Settings

MimControl


See also
Availability
Available in MIL-Lite with restrictions (see remarks)
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
MimConnectMap
MimConvert
Synopsis
Control an image processing context or result buffer setting.
Syntax
void MimControl(
MIL_ID ContextOrResultImId, //in
MIL_INT64 ControlType, //in
MIL_DOUBLE ControlValue //in
)
Description

This function allows you to control an image processing context or result buffer setting. All the control type settings can be inquired using MimInquire().

When compiling C code in 64-bit mode, MimControl() internally calls the MIL_INT64 version of this function (MimControlInt64()). If you need to pass floating-point values, call the MIL_DOUBLE version of this function (MimControlDouble()).
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
ContextOrResultImId

Specifies the identifier of the image processing context or result buffer. The image processing context or result buffer must have been previously allocated on the system using MimAlloc() or MimAllocResult(), respectively.

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

ControlType

Specifies the processing feature to control.

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

ControlValue

Specifies the value needed for the control. When the ControlValue is an image buffer, the internal representation of the image stored in the image processing context might not be the same as the original image.

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

Parameter associations

The table below lists possible values for the ContextOrResultImId, ControlType, and ControlValue parameters.

The following ContextOrResultImId, ControlType, and ControlValue parameter settings can be specified for different types of image processing contexts or result buffers.

function map For specifying the control type and control value for an image processing context or result buffer
CollapseContextOrResultImId Description
ControlType
ControlValue
Collapse Adaptive binarize context ID

Specifies an adaptive binarize context, allocated using MimAlloc() with M_BINARIZE_ADAPTIVE_CONTEXT, and used in MimBinarizeAdaptive() operations.

The main setting with which to control an adaptive binarize context is M_THRESHOLD_MODE. In general, all other control settings are used by the specified thresholding process to establish the threshold values with which to binarize.

(summarize)
Collapse M_AVERAGE_MODE

Sets how MIL establishes average pixel values that can be required to determine threshold values. This is typically used when M_THRESHOLD_MODE is set to M_NIBLACK or M_LOCAL_MEAN. INQ

(summarize)
Collapse M_DEFAULT

Same as M_UNIFORM.
Collapse M_GAUSSIAN

Specifies a Gaussian type average.
Collapse M_UNIFORM

Specifies a uniform type average.
Collapse M_FOREGROUND_VALUE

Sets whether the objects to binarize are lighter or darker than the background. INQ

(summarize)
Collapse M_DEFAULT

Same as M_FOREGROUND_WHITE.
Collapse M_FOREGROUND_BLACK

Specifies that the objects to binarize are darker than the background.
Collapse M_FOREGROUND_WHITE

Specifies that the objects to binarize are lighter than the background.
Collapse M_GLOBAL_MAX

Sets the maximum threshold value. The threshold destination image (MimBinarizeAdaptive()) cannot hold values higher than M_GLOBAL_MAX. Higher threshold values are clipped.

If the source image (MimBinarizeAdaptive()) also has a maximum value restriction (MbufControl() with M_MAX), MIL uses the lower maximum value as the actual maximum.

By default, MIL binarizes pixels with an intensity higher than the maximum as part of the foreground (object). To change this behavior, use the M_FOREGROUND_VALUE control. INQ

(summarize)
Collapse M_DEFAULT

Specifies that there is no maximum threshold value restriction imposed by M_GLOBAL_MAX.
Collapse Value > M_GLOBAL_MIN

Specifies the maximum threshold value.
Collapse M_GLOBAL_MIN

Sets the minimum threshold value. The threshold destination image (MimBinarizeAdaptive()) cannot hold values lower than M_GLOBAL_MIN. Lower threshold values are clipped.

If the source image (MimBinarizeAdaptive()) also has a minimum value restriction (MbufControl() with M_MIN), MIL uses the greater minimum value as the actual maximum.

By default, MIL binarizes pixels with an intensity lower than the minimum as part of the background. To change this behavior, use the M_FOREGROUND_VALUE control. INQ

(summarize)
Collapse M_DEFAULT

Specifies that there is no minimum threshold value restriction imposed by M_GLOBAL_MIN.
Collapse Value < M_GLOBAL_MAX

Specifies the minimum threshold value.
Collapse M_GLOBAL_OFFSET

Sets the offset to add to each threshold value. MimBinarizeAdaptive() uses the adjusted threshold values. The specified offset is reflected in the threshold destination image (MimBinarizeAdaptive()). INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.
Collapse Value

Specifies the offset.
Collapse M_GLOBAL_OFFSET_SECOND_PASS

Sets the offset to apply to the threshold values for the second pass of an hysteresis adaptive binarization. MIL applies the offset for the second pass in the same way that it applies the offset for the first pass (M_GLOBAL_OFFSET). For M_GLOBAL_OFFSET_SECOND_PASS to have an effect, you must enable M_HYSTERESIS.

For an M_NIBLACK threshold mode, either M_GLOBAL_OFFSET_SECOND_PASS must have a different value than M_GLOBAL_OFFSET or M_NIBLACK_BIAS_SECOND_PASS must have a different value than M_NIBLACK_BIAS, otherwise MIL generates an error. For other threshold modes, MIL generates an error if M_GLOBAL_OFFSET_SECOND_PASS and M_GLOBAL_OFFSET have the same value. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.
Collapse Value

Specifies the offset.
Collapse M_HYSTERESIS

Specifies whether to perform the adaptive binarization using an hysteresis process. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.
Collapse M_DISABLE

Specifies that the adaptive binarization does not use an hysteresis process.
Collapse M_ENABLE

Specifies that the adaptive binarization uses an hysteresis process. In this case, MIL performs a geodesic reconstruction (a type of morphological operation) after a second pass of the specified threshold.

Regardless of threshold mode, MIL uses M_GLOBAL_OFFSET_SECOND_PASS instead of M_GLOBAL_OFFSET during the second pass of MimBinarizeAdaptive(). For an M_NIBLACK threshold mode, the second pass also uses M_NIBLACK_BIAS_SECOND_PASS instead of M_NIBLACK_BIAS. MIL generates an error if every M_..._SECOND_PASS value it uses is the same as its first pass counterpart.

(summarize)
Collapse M_LOCAL_DIMENSION

Specifies the size of the neighborhood that the threshold mode uses to establish threshold values.

For an M_NIBLACK or M_LOCAL_MEAN threshold mode, the size should be the largest square that represents a uniform background. The size should also be greater than the object's expected thickness. For an M_BERNSEN threshold mode, the size should be close to the object's expected width. For an M_PSEUDOMEDIAN threshold mode, the size should be half the object's expected thickness. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 15 pixels.
Collapse Value >= 1

Specifies the size of the neighborhood, in pixels. Only integer values accepted.

(summarize)
Collapse M_MINIMUM_CONTRAST

Sets the minimum contrast between background and foreground (object) pixels. MIL binarizes (classifies) pixels in a neighborhood as background if they do not meet the minimum contrast. An M_LOCAL_MEAN threshold mode ignores the minimum contrast. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 5.0.
Collapse Value >= 0.0

Specifies the minimum contrast.
Collapse M_NIBLACK_BIAS

Sets the bias for Niblack's binarization mode. This value only has an effect if M_THRESHOLD_MODE is set to M_NIBLACK.

The bias gives you some general control over thresholding. A higher bias binarizes fainter values as part of the object. A lower bias binarizes fainter values as part of the background. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.2.
Collapse Value >= 0.0

Specifies the bias. Typical values range from 0.1 to 0.3.

(summarize)
Collapse M_NIBLACK_BIAS_SECOND_PASS

Sets the bias for the second pass of a Niblack adaptive binarization that uses an hysteresis process. For this control to have an effect, you must specify an M_NIBLACK threshold mode and enable M_HYSTERESIS.

Either M_NIBLACK_BIAS_SECOND_PASS must have a different value than M_NIBLACK_BIAS or M_GLOBAL_OFFSET_SECOND_PASS must have a different value than M_GLOBAL_OFFSET, otherwise MIL generates an error. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.2.
Collapse Value >= 0.0

Specifies the bias.
Collapse M_THRESHOLD_MODE

Sets how MIL establishes the threshold values with which to binarize the source image. INQ

(summarize)
Collapse M_DEFAULT

Same as M_NIBLACK.
Collapse M_BERNSEN

Specifies that threshold values are established using Bernsen's adaptive threshold algorithm. This represents a type of morphological erosion and dilation. This threshold results in the fastest process.

(summarize)
Collapse M_LOCAL_MEAN

Specifies that threshold values are established using adaptive local mean calculations. This is a simplified version of M_NIBLACK. M_LOCAL_MEAN usually results in a faster, though less precise, binarization than M_NIBLACK.

(summarize)
Collapse M_NIBLACK

Specifies that threshold values are established using Niblack's adaptive threshold algorithm. This setting offers the highest precision. The processing time is usually quite quick.

(summarize)
Collapse M_PSEUDOMEDIAN

Specifies that threshold values are established using adaptive pseudomedian calculations. This is similar to an M_BERNSEN threshold, except it represents a type of morphological open or close process instead of erosion or dilation.

(summarize)
Collapse Adaptive binarize from seed context ID

Specifies an adaptive binarize context that uses seeds, allocated using MimAlloc() with M_BINARIZE_ADAPTIVE_FROM_SEED_CONTEXT, and used in MimBinarizeAdaptive() operations.

The main setting with which to control an adaptive binarize context that uses seeds is M_THRESHOLD_MODE. In general, all other control settings are used by the specified thresholding process to establish the threshold values with which to binarize.

(summarize)
Collapse M_FOREGROUND_VALUE

Sets whether the objects to binarize are lighter or darker than the background. INQ

(summarize)
Collapse M_DEFAULT

Same as M_FOREGROUND_WHITE.
Collapse M_FOREGROUND_BLACK

Specifies that the objects to binarize are darker than the background.
Collapse M_FOREGROUND_WHITE

Specifies that the objects to binarize are lighter than the background.
Collapse M_GLOBAL_OFFSET

Sets the offset to add to each established threshold value. Binarization uses the adjusted threshold values, however offsets do not change the threshold values themselves. The content of the threshold destination image (MimBinarizeAdaptive() with ThresholdImageBufId) remains unaltered. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.0.
Collapse Value

Specifies the offset.
Collapse M_NB_ITERATIONS

Sets the number of times to perform the adaptive threshold process specified with M_THRESHOLD_MODE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_TO_IDEMPOTENCE.
Collapse M_TO_IDEMPOTENCE

Specifies that the threshold process iterates until idempotence is reached. This is the number of iterations at which subsequent iterations do not alter results.

(summarize)
Collapse Value > 0

Specifies the number of iterations. Only integer values accepted. The threshold process for an M_TOGGLE threshold mode is always performed once.

(summarize)
Collapse M_NB_SEED_ITERATIONS

Sets the number of iterations with which to internally establish the seeds that the threshold mode requires. This value only has an effect if you do not specify your own seed images with MimBinarizeAdaptive(). INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 1.
Collapse Value > 0

Specifies the number of iterations. Only integer values accepted.

(summarize)
Collapse M_THRESHOLD_MODE

Sets how MIL uses seeds to establish the threshold values with which to binarize the source image. You can provide the required seed images when you call MimBinarizeAdaptive(). If you do not, MIL internally establishes the seed data. INQ

(summarize)
Collapse M_DEFAULT

Same as M_RECONSTRUCT.
Collapse M_LEVEL

Specifies that threshold values are established using an adaptive leveling. This essentially performs two geodesic reconstructions. One that processes the foreground as white, and the other that processes the foreground as black. This results in M_LEVEL generally taking twice as long as M_RECONSTRUCT. M_LEVEL uses one seed image.

(summarize)
Collapse M_RECONSTRUCT

Specifies that threshold values are established using an adaptive geodesic reconstruction. This represents a type of morphological erosion or dilation. M_RECONSTRUCT uses one seed image. M_RECONSTRUCT is typically faster than M_LEVEL and slower than M_TOGGLE.

(summarize)
Collapse M_TOGGLE

Specifies that threshold values are established as one of two possibilities, defined by the seeds. MIL compares the source pixel (including the offset) to each seed. The value of the closest seed is the threshold value for that pixel. M_TOGGLE uses two seed images (typically min and max values). M_TOGGLE is the fastest threshold mode.

(summarize)
Collapse Dead pixel correction image processing
context ID

Specifies a dead pixel correction image processing context, allocated using MimAlloc() with M_DEAD_PIXEL_CONTEXT, and used in MimDeadPixelCorrection() operations.

(summarize)
Collapse M_DEAD_PIXELS

Sets the dead pixels image buffer used to identify dead pixels in the source image, where all non-zero pixels are considered dead pixels.

Note that you should only use this control type if you have not specified a series of values that identify the dead pixels, using MimPut() with M_XY_DEAD_PIXELS.

(summarize)
Collapse Dead pixel mask image buffer ID

Specifies identifier of the image buffer containing the dead pixel mask.

The buffer must be a single-band image buffer, allocated using MbufAlloc...().

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse M_INTERPOLATION_MODE

Sets the interpolation mode. INQ

(summarize)
Collapse M_DEFAULT

Same as M_AVERAGE.
Collapse M_AVERAGE

Specifies to overwrite a dead pixel with an interpolation performed using a weighted average of all its neighboring pixels in the source image.
Collapse Deinterlacing image processing context ID

Specifies a deinterlacing image processing context, allocated using MimAlloc() with M_DEINTERLACE_CONTEXT, and used in MimDeinterlace() operations.

(summarize)
Collapse M_DEINTERLACE_TYPE

Sets the deinterlacing algorithm to use. The chosen algorithm can either be applied to all the pixels in the source image or to the pixels that are part of an object in motion (adaptive version of the algorithm).

To determine if a pixel is part of a moving object, the adaptive algorithm compares it with the pixel at the same location in neighboring frames. If the difference between the maximum and minimum pixel intensity exceeds a set threshold (M_MOTION_DETECT_THRESHOLD), then the pixel is considered to be part of a moving object. Otherwise, the pixel is considered to be part of the background. The deinterlacing algorithm is not applied to the background pixels. Instead, the background pixels in the output image will be formed by the corresponding pixels in the even or odd field. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISCARD.
Collapse M_ADAPTIVE_AVERAGE

Specifies that the average algorithm is applied to the pixels that are considered to be part of a moving object and leaves the background pixels unchanged.
Collapse M_ADAPTIVE_BOB

Specifies that the bob algorithm is applied to the pixels that are considered to be part of a moving object and leaves the background pixels unchanged.
Collapse M_ADAPTIVE_DISCARD

Specifies that the discard algorithm is applied to the pixels that are considered to be part of a moving object and leaves the background pixels unchanged.
Collapse M_AVERAGE

Performs the averaging algorithm. This algorithm is equivalent to performing the discard algorithm twice, once using the first field in the frame and once using the second. The resulting two frames will then be averaged to form one deinterlaced output frame.

(summarize)
Collapse M_BOB

Performs the bob algorithm. This algorithm performs the discard algorithm twice, once using the first field in the frame and once using the second. The result is two output frames. Therefore, the output frame rate is twice as high as the input frame rate.

(summarize)
Collapse M_DISCARD

Performs the discard algorithm. This algorithm takes one field from the source image and discards the other. The second field is then calculated from this field. Each row of the second field is obtained by averaging the two corresponding neighboring rows in the first field. For example, the first row of the second field is calculated from the average of the first and second rows of the first field.

(summarize)
Collapse M_DISCARD_FIELD

Sets the field to discard when using the M_DISCARD or M_ADAPTIVE_DISCARD algorithm. Note, in the averaging and bob algorithms, the discard algorithm is called twice; the first field is discarded on the first call and the second field is discarded on the second call. INQ

(summarize)
Collapse M_DEFAULT

Same as M_EVEN_FIELD.
Collapse M_EVEN_FIELD

Specifies that the even field is discarded.
Collapse M_ODD_FIELD

Specifies that the odd field is discarded.
Collapse M_FIRST_FIELD

Sets the first field to be processed for each input frame and consequently sets the order of the output frames when using the M_BOB or M_ADAPTIVE_BOB algorithm. INQ

(summarize)
Collapse M_DEFAULT

Same as M_EVEN_FIELD.
Collapse M_EVEN_FIELD

Specifies that the even field will be processed first.
Collapse M_ODD_FIELD

Specifies that the odd field will be processed first.
Collapse M_MOTION_DETECT_NUM_FRAMES

Sets the number of frames to use for comparison purposes to determine if a pixel is part of an object in motion. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 2.
Collapse Value > 1

Specifies the number of frames.
Collapse M_MOTION_DETECT_OUTPUT

Sets whether the output images of MimDeinterlace() are deinterlaced images or images indicating which pixels are considered to be part of an object in motion (the internal motion detection mask). In the latter case, the pixel values are either 0, if they are part of a background object, or the maximum unsigned value (0xFF for an 8 bit image), if they are part of an object in motion. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.
Collapse M_DISABLE

Specifies that the output images are the deinterlaced images.
Collapse M_ENABLE

Specifies that the output images indicate the background pixels and the pixels that are considered to be part of the object in motion.
Collapse M_MOTION_DETECT_REFERENCE_FRAME

Sets the index of the frame to process within the group of frames that are used for motion detection. This frame is used as the reference frame. INQ

(summarize)
Collapse M_DEFAULT

Same as M_CENTER_FRAME.
Collapse M_CENTER_FRAME

Specifies that the center frame in the group is used as the reference frame.
Collapse M_FIRST_FRAME

Specifies that the first frame in the group is used as the reference frame.
Collapse M_LAST_FRAME

Specifies that the last frame in the group is used as the reference frame.
Collapse 0 <= Value < M_MOTION_DETECT_NUM_FRAMES

Specifies the index of the frame relative to the first frame of the group. The first frame of the group has index 0.

(summarize)
Collapse M_MOTION_DETECT_THRESHOLD

Sets the threshold value used to differentiate between pixels that are part of objects in motion and background pixels. Each pixel is compared with the pixel at the same location in neighboring frames. If the difference between the maximum and minimum pixel intensity exceeds the specified threshold, the pixel is considered part of a moving object. Otherwise, it is considered part of the background. INQ

(summarize)
Collapse Value >= 0

Specifies the threshold.
Collapse M_SOURCE_FIRST_IMAGE

Sets the index of the input image used to generate the first deinterlaced image. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.
Collapse Value >= 0

Specifies the index of the image in the source image array.
Collapse Event list image processing result ID

Specifies an event list image processing result buffer, allocated using MimAllocResult() with M_EVENT_LIST, and used in MimLocateEvent() operations.

(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. The setting of this control type will only affect functions within this module which return positional results. This control type can be changed at any time to return results in the required output units. 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, with respect to the pixel coordinate system.
Collapse M_WORLD

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

(summarize)
Collapse Find orientation image processing context ID

Specifies a find orientation image processing context identifier, allocated using MimAlloc() with M_FIND_ORIENTATION_CONTEXT, and used in MimFindOrientation() operations.

(summarize)
Collapse M_BORDER_ATTENUATION

Sets whether MimFindOrientation() must process the image's borders, or if the operation can ignore spatial patterns occurring close to the ends of the image buffer. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ENABLE.
Collapse M_DISABLE

Specifies that MimFindOrientation() cannot ignore the image's borders. The find orientation operation will use the borders.

(summarize)
Collapse M_ENABLE

Specifies that MimFindOrientation() can ignore the image's borders. The find orientation operation will not necessarily use the borders.

(summarize)
Collapse M_FREQUENCY_CUTOFF_RATIO_HIGH

Specifies the upper limit of frequencies in which to look for dominant orientations, as a percentage of the maximum frequency; the maximum frequency is dictated by the size of the image. Larger images will have higher maximum frequencies. Frequencies higher than this percentage will be ignored during computation. This can be useful for discarding noise in the image. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 95%.
Collapse 0.0 <= Value <= 100.0

Specifies the upper limit of frequencies in which to look for dominant orientations, as a percentage of the maximum frequency. For example, by specifying 95% (the default), frequencies above MaxFrequency x 95% will be ignored.

(summarize)
Collapse M_FREQUENCY_CUTOFF_RATIO_LOW

Specifies the lower limit of frequencies in which to look for dominant orientations, as a percentage of the maximum frequency; the maximum frequency is dictated by the size of the image. Larger images will have higher maximum frequencies. Frequencies lower than this percentage will be ignored during computation. This can be useful for discarding noise in the image. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 5%.
Collapse 0.0 <= Value <= 100.0

Specifies the lower limit of frequencies in which to look for dominant orientations, as a percentage of the maximum frequency. For example, by specifying 5% (the default), frequencies below MaxFrequency x 5% will be ignored.

(summarize)
Collapse M_INTERPOLATION_MODE

Sets the interpolation mode used to internally resize the source image if it is of an inappropriate size. This will only be used if the source image has dimensions that are not a power of 2 (X-size and Y-size).

Note that you cannot set an interpolation mode if you are using M_CLIP_CENTER. INQ

(summarize)
Collapse M_DEFAULT

Same as M_NEAREST_NEIGHBOR.
Collapse M_AVERAGE

Specifies averaging interpolation. The M_MODE control type must be set to M_RESIZE_DOWN.

(summarize)
Collapse M_BICUBIC

Specifies bicubic interpolation.
Collapse M_BILINEAR

Specifies bilinear interpolation.
Collapse M_INTERPOLATE

Specifies interpolated resizing. For resizing up, this is equivalent to bilinear; for resizing down, this is equivalent to averaging. This gives the best speed/result compromise for interpolated resizing.

(summarize)
Collapse M_MAX

Specifies an interpolation based on the maximum pixel value in the source image area. The M_MODE control type must be set to M_RESIZE_DOWN.

Note that this can alter the shapes of objects and reduce the robustness of the operation.

(summarize)
Collapse M_MIN

Specifies an interpolation based on the minimum pixel value in the source image area. The M_MODE control type must be set to M_RESIZE_DOWN.

Note that this can alter the shapes of objects and reduce the robustness of the operation.

(summarize)
Collapse M_NEAREST_NEIGHBOR

Specifies the nearest neighbor interpolation.
Collapse M_MODE

Sets the resizing mode used if the source image is of an inappropriate size. Resizing will only occur if the source image has dimensions that are not a power of 2 (X-size and Y-size). The find orientation operation is then performed on the resized image, which is stored in a temporary image buffer. The original image is not altered.

For more information on resizing, see the Basic geometric transforms section of Chapter 3: Image processing. INQ

(summarize)
Collapse M_DEFAULT

Same as M_CLIP_CENTER.
Collapse M_CLIP_CENTER

Specifies to perform the find orientation operation using the largest centered portion of the image with dimensions that are a power of 2 (X-size and Y-size).
Collapse M_RESIZE_DOWN

Specifies to perform the find orientation operation on a subsampled version of the image with the closest possible dimensions that are a power of 2 (X-size and Y-size).
Collapse M_RESIZE_UP

Specifies to perform the find orientation operation on a zoomed version of the image with the closest possible dimensions that are a power of 2 (X-size and Y-size).
Collapse Flat-field image processing context ID

Specifies a flat-field image processing context, allocated using MimAlloc() with M_FLAT_FIELD_CONTEXT, and used in MimFlatField() operations.

(summarize)
Collapse M_DARK_CONST

Sets the dark constant value. This is used to remove thermal agitation recorded in the grabbed image (from the CCD) or to remove the darkest possible shade of black when removing uneven lighting from grabbed images.

Note that M_DARK_CONST and M_DARK_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse 0 <= Value <= 65535

Specifies the constant.
Collapse M_DARK_IMAGE

Sets the identifier of the dark image. This is used to remove thermal agitation recorded in the grabbed image (from the CCD) or to remove the dark shadows from the source image when removing uneven lighting from grabbed images. Note that, this image should be a uniformly dark area (such as, grabbing with the lens cap on your camera).

Note that M_DARK_CONST and M_DARK_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse DarkImageId

Specifies the identifier of the image buffer. This image buffer must be an 8- or 16-bit unsigned processing image buffer.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse M_FLAT_CONST

Sets the flat constant value. This is used to remove the variations of CCD sensitivity recorded in the grabbed image (from the CCD) or to reduce the gray in the grabbed image when removing uneven lighting.

Note that M_FLAT_CONST and M_FLAT_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse 0 <= Value <= 65535

Specifies the constant.
Collapse M_FLAT_IMAGE

Sets the identifier of the flat image. This is used to remove the variations of CCD sensitivity recorded in the grabbed image (from the CCD) or to reduce the gray in the grabbed image when removing uneven lighting. Note that, this image should be a uniform light gray area. When dealing with CCD sensitivity, the exposure time should be relatively short. Alternatively, when dealing with uneven lighting, the exposure time should be set so that no pixel is saturated.

Note that M_FLAT_CONST and M_FLAT_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse FlatImageId

Specifies the identifier of the image buffer. This image buffer must be an 8- or 16-bit unsigned processing buffer.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse M_GAIN_CONST

Sets the gain factor used to normalize (or scale) the result of the flat field calculation back to the full dynamic range of the destination image. INQ

(summarize)
Collapse M_AUTOMATIC

Specifies an automatic gain factor.

The automatically generated gain factor is determined by subtracting the flat image (M_FLAT_IMAGE) from the offset image (M_OFFSET_IMAGE) and then taking the average of the resulting image's pixels.

If a constant value is specified instead of images (by using M_FLAT_CONST and M_OFFSET_CONST), MIL returns the result of the subtraction instead.

(summarize)
Collapse Value > 0.0

Specifies the gain factor.
Collapse M_OFFSET_CONST

Sets the offset constant value. This is used to remove the electrical bias recorded in the grabbed image (from the CCD) or to reduce the black in the flat image when removing uneven lighting.

Note that M_OFFSET_CONST and M_OFFSET_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse 0 <= Value <= 65535

Specifies the constant.
Collapse M_OFFSET_IMAGE

Sets the identifier of the offset image. This is used to remove the electrical bias recorded in the image (from the CCD) or to reduce the black in the flat image when removing uneven lighting. Note that, this image should be a uniform dark area. When dealing with electrical bias, the exposure time should be relatively short. Alternatively, when dealing with uneven lighting, the exposure time should be the same as for the flat image (that is, so that no pixel is saturated).

Note that M_OFFSET_CONST and M_OFFSET_IMAGE both cannot be set in the same flat-field imaging processing context.

(summarize)
Collapse OffsetImageId

Specifies the identifier of the image buffer. This image buffer must be an 8- or 16-bit unsigned processing buffer.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse Histogram equalization adaptive context ID

Specifies a histogram equalization adaptive context, allocated using MimAlloc() with M_HISTOGRAM_EQUALIZE_ADAPTIVE_CONTEXT, and used in MimHistogramEqualizeAdaptive() operations.

(summarize)
Collapse M_ALPHA_VALUE

Sets the adjustment factor for M_EXPONENTIAL and M_RAYLEIGH operations. For other operations, M_ALPHA_VALUE is ignored. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.4.
Collapse Value >= 0.0

Specifies the adjustment factor.

For an M_EXPONENTIAL operation, greater adjustment values result in less occurrences of the most frequent pixels of the histogram in the resulting image buffer.

For an M_RAYLEIGH operation, greater adjustment values result in greater occurrences of the most frequent pixels of the histogram in the resulting image buffer.

(summarize)
Collapse M_CLIP_LIMIT

Sets the maximum percentage of values that a tile's histogram bin can represent. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 1%.
Collapse 0.0 < Value <= 100.0

Specifies the maximum percentage. For example, if a tile has 100 pixels and you specify a maximum limit of 10%, there can be no bin in that tile's histogram with more than 10 values. This essentially limits the contrast. Exceeding values are distributed evenly among the tile's other histogram bins.

(summarize)
Collapse M_HIST_SIZE

Sets the number of bins for each tile's histogram. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ACCORDING_TO_SOURCE.
Collapse M_ACCORDING_TO_SOURCE

Specifies that MimHistogramEqualizeAdaptive() automatically determines the number of bins for each tile's histogram, according to the number of intensities that are possible in the specified image buffer. For example, if you specify an 8-bit unsigned buffer, each tile's histogram will have 256 bins.

(summarize)
Collapse Value >= 2

Specifies the number of bins for each tile's histogram. Only integer values accepted.

(summarize)
Collapse M_NUMBER_OF_TILES_X

Sets the number of tiles along the X-direction of the source image specified with MimHistogramEqualizeAdaptive().

Given the number of tiles in the X- and Y-direction, the size of the source image, and the requirement that tiles be congruent rectangles, MimHistogramEqualizeAdaptive() is able to establish the size of the tiles with which to process the image. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 8.
Collapse Value >= 2

Specifies the number of tiles. Only integer values accepted.

(summarize)
Collapse M_NUMBER_OF_TILES_Y

Sets the number of tiles along the Y-direction of the source image specified with MimHistogramEqualizeAdaptive().

Given the number of tiles in the Y- and X-direction, the size of the source image, and the requirement that tiles be congruent rectangles, MimHistogramEqualizeAdaptive() is able to establish the size of the tiles with which to process the image. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 8.
Collapse Value >= 2

Specifies the number of tiles. Only integer values accepted.

(summarize)
Collapse M_OPERATION

Sets the equalization operation that MimHistogramEqualizeAdaptive() uses.

The cumulative probability distribution, Pf(f), of the input image is approximated by its cumulative histogram:

For more information, refer to "Pratt, William K. Digital Image Processing . United States: John Wiley & Sons, 1978. 318.". INQ (summarize)
Collapse M_DEFAULT

Same as M_UNIFORM.
Collapse M_EXPONENTIAL

Specifies an equalization density function which generates an Exponential distribution.

Output probability density model:

Transfer function:

(summarize)
Collapse M_HYPER_CUBE_ROOT

Specifies an equalization density function which generates a Hyperbolic Cube Root distribution.

Output probability density model:

Transfer function:

(summarize)
Collapse M_HYPER_LOG

Specifies an equalization density function which generates a Hyperbolic Logarithmic distribution.

Output probability density model:

Transfer function:

(summarize)
Collapse M_RAYLEIGH

Specifies an equalization density function which generates a Rayleigh distribution.

Output probability density model:

Transfer function:

(summarize)
Collapse M_UNIFORM

Specifies an equalization density function which generates a Uniform distribution.

Output probability density model:

Transfer function:

(summarize)
Collapse Intensity histogram image processing result
ID

Specifies an intensity histogram image processing result buffer, allocated using MimAllocResult() with M_HIST_LIST, and used in MimHistogram() operations.

(summarize)
Collapse M_HIST_BIN_SIZE_MODE

Sets the number of values each histogram bin can represent. To specify the number of histogram bins in the result, use MimAllocResult() and the NbEntries parameter. For example, if you are using an 8-bit unsigned source image, and you want to have one bin for every possible intensity value, you should set the NbEntries parameter to 256. INQ

(summarize)
Collapse M_DEFAULT

Same as M_REGULAR.
Collapse M_FIT_SRC_DATA

Specifies that MimHistogram() determines the resulting bin size according to the source image's minimum and maximum intensity values, and the total number of bins. For example, if you call MimHistogram() with a 16-bit signed buffer that holds a source image with a minimum pixel intensity value of 10 and a maximum of 1009, the histogram's bins must account for values between 10 and 1009, which is a total of 1000 possible values. In this case, if the histogram has 100 bins, each bin can represent 10 values (1000/100).

(summarize)
Collapse M_FIT_SRC_RANGE

Specifies that MimHistogram() determines the resulting bin size according to the full range of possible values in the source buffer, and the total number of bins. For example, if you call MimHistogram() with a 16-bit signed buffer, the histogram's bins must account for intensity values ranging from -32768 to 32767, which is a total of 65536 possible values. In this case, if the histogram has 512 bins, each bin can represent 128 values (65536/512). Note that the minimum and maximum values possible for a buffer can be modified using MbufControl() with M_MIN and M_MAX.

(summarize)
Collapse M_FREEDMAN

Specifies that MimHistogram() determines the resulting bin size according to the Freedman–Diaconis rule. This is a statistical estimate based on an equation of the general form: BinSize=2I Q R(x)n -1/3 .

For more information, see "Freedman, David; Diaconis, Persi. On the histogram as a density estimator . Heidelberg, Berlin: Springer, 1981. ".

(summarize)
Collapse M_REGULAR

Specifies that each histogram bin can hold 1 value.
Collapse M_HIST_SMOOTHING_ITERATIONS

Sets the number of smoothing iterations to perform on the histogram after it has been generated. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.
Collapse Value >= 0

Specifies the number of smoothing iterations. Only integer values accepted.

The smoothing applied is an integer-based averaging of the histogram; the resulting number of values might therefore be different than the number of values in the source image.

(summarize)
Collapse Locate peak 1D image processing context ID

Specifies a 1D locate peak image processing context, allocated using MimAlloc() with M_LOCATE_PEAK_1D_CONTEXT, and used in MimLocatePeak1d() operations.

(summarize)
Collapse M_MINIMUM_CONTRAST

Sets the minimum contrast (difference) between the intensity of the local 1D background and the minimum acceptable intensity of a pixel in the peak neighborhood.

This control type is intended to adjust how M3dmapAddScan() internally processes laser line images. When using MimLocatePeak1d(), you typically set the value using the function's parameters; this control type only sets the default value used by the function. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 100.
Collapse 0 <= Value <= 255

Specifies the minimum contrast.
Collapse M_NUMBER_OF_PEAKS

Sets the maximum number of peaks to find along a given lane. If more than the specified number of peaks are found, the highest peaks are kept. INQ

(summarize)
Collapse Value >= 0

Specifies the number of peaks. Only integer values accepted.

(summarize)
Collapse M_PEAK_INTENSITY_RANGE

Sets the number of pixels used to calculate the average peak intensity. The pixels are chosen around the peak intensity pixel. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 5.
Collapse Value >= 0

Specifies the number of pixels.
Collapse M_PEAK_WIDTH_DELTA

Sets the number of pixels that can be added to or subtracted from the nominal width, when determining the range of allowable widths of the peak neighborhood.

This control type is intended to adjust how M3dmapAddScan() internally processes laser line images. When using MimLocatePeak1d(), you typically set the value using the function's parameters; this control type only sets the default value used by the function. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 20.
Collapse Value >= 0

Specifies the number of pixels.
Collapse M_PEAK_WIDTH_NOMINAL

Sets the nominal (expected average) width of the peak neighborhood. In laser line images, this is the average width of the laser line.

This control type is intended to adjust how M3dmapAddScan() internally processes laser line images. When using MimLocatePeak1d(), you typically set the value using the function's parameters; this control type only sets the default value used by the function. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 20.
Collapse Value >= 0

Specifies the number of pixels.
Collapse M_SCAN_LANE_DIRECTION

Sets the direction in which to detect peaks. INQ

(summarize)
Collapse M_DEFAULT

Same as M_VERTICAL.
Collapse M_HORIZONTAL

Detects peaks along the image's X-axis.

Typically for laser line images with a vertical laser line.

(summarize)
Collapse M_VERTICAL

Detects peaks along the image's Y-axis.

Typically for laser line images with a horizontal laser line.

(summarize)
Collapse Locate peak 1D image processing result ID

Specifies a locate peak 1D image processing result buffer, allocated using MimAllocResult() with M_LOCATE_PEAK_1D_RESULT, and used in MimLocatePeak1d() operations.

(summarize)
Collapse M_SORT_CRITERION

Sets the quality with which to sort peaks. INQ

(summarize)
Collapse M_DEFAULT +

Same as M_PEAK_INTENSITY.
Collapse M_PEAK_INTENSITY +

Orders peaks according to their intensity.
Collapse M_PEAK_POSITION +

Orders peaks according to their position.
Collapse Match image processing context ID

Specifies a match image processing context, allocated using MimAlloc() with M_MATCH_CONTEXT, and used in MimMatch() operations.

(summarize)
Collapse M_MASK_IMAGE

Sets the image buffer containing the mask image. All non-zero values are considered masked pixels that will be ignored during the match.

(summarize)
Collapse MaskImageId

Specifies the identifier of the image buffer containing the mask image.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse M_MAX_SCORE

Sets the maximum score when performing a match using the normalized grayscale correlation mode. When using other matching modes, this control type is ignored.

This control type causes MIL to linearly remap the range of the internal match results to the range established, from the lowest possible value to the maximum score specified. INQ

(summarize)
Collapse M_DEFAULT

Same as M_MAX_DEPTH.
Collapse M_MAX_DEPTH

Specifies to establish the maximum score based on the pixel depth of the destination buffer (for example, when dealing with a 16-bit signed buffer, the maximum value would be 32, 767). Note that, when using floating-point destination buffers, the range is [-1, 1]; unless you use a clipping score type (using M_SCORE_TYPE set to either M_NORM_CLIP or M_NORM_CLIP_SQR), in which case the range is [0, 1].

(summarize)
Collapse Value

Specifies the maximum score. This score can be any positive value less than the maximum predetermined by the destination buffer's pixel depth.

(summarize)
Collapse M_MODE

Sets the type of computation to perform when matching the source image to the model image. INQ

(summarize)
Collapse M_DEFAULT

Same as M_CORRELATE_NORMALIZED.
Collapse M_ABS_SUM_OF_DIFFERENCES

Computes the absolute sum of the differences.
Collapse M_CORRELATE

Computes a grayscale correlation.
Collapse M_CORRELATE_NORMALIZED

Computes a normalized grayscale correlation.
Collapse M_MODEL_IMAGE

Sets the image buffer containing the model image.

(summarize)
Collapse ModelImageId

Specifies the identifier of the image buffer containing the model image. Note that this buffer must be an 8-bit unsigned image buffer.

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

(summarize)
Collapse M_MODEL_STEP

Sets whether to use every pixel or every other pixel in the model image when matching the source image to the model image. INQ

(summarize)
Collapse M_DEFAULT

Same as 1.
Collapse 1

Specifies to take every pixel (on both axes) to compute the match.
Collapse 2

Specifies to take every other pixel (on both axes) to compute the match.
Collapse M_SCORE_TYPE

Sets how to compute the final correlation score. Note that this control type is only used when performing a match using normalized grayscale correlation mode (using M_MODE set to M_CORRELATE_NORMALIZED). INQ

(summarize)
Collapse M_DEFAULT

Same as M_NORM_CLIP_SQR.
Collapse M_NORM

Specifies to use normalized grayscale correlation to compute the final match score.
Collapse M_NORM_CLIP

Specifies to clip the results from a normalized grayscale correlation when computing the final correlation score. The calculation used is the same as M_NORM, but any value less than 0 is clipped (that is, recorded as 0).

(summarize)
Collapse M_NORM_CLIP_SQR

Specifies to clip the results from the square of the normalized grayscale correlation when computing the final correlation score. The calculation used is the same as M_SQR_NORM, but any value less than 0 is clipped (that is, recorded as 0).

(summarize)
Collapse M_SQR_NORM

Specifies to use the square of the normalized grayscale correlation to compute the final correlation score.
Collapse Multiple statistics image processing context
ID

Specifies a multiple statistics image processing context, allocated using MimAlloc() with M_STAT_MULTIPLE_CONTEXT, and used in MimStatMultiple() operations.

(summarize)
Collapse M_MODE

Sets the mode in which to compute results. INQ

(summarize)
Collapse M_DEFAULT

Same as M_2D.
Collapse M_2D

Specifies to compute statistics on 2-dimensional images with a result for every individual pixel.
Collapse M_SIZE_X

Sets the X-size of the target area in the source buffer. Note that setting this control type is optional, unless you preprocess the context, using MimStatMultiple() with M_PREPROCESS, without specifying a source buffer. INQ

(summarize)
Collapse Width

Specifies the width of the target area in the source buffer, in pixels.
Collapse M_SIZE_Y

Sets the Y-size of the target area in the source buffer. Note that setting this control type is optional, unless you preprocess the context, using MimStatMultiple() with M_PREPROCESS, without specifying a source buffer. INQ

(summarize)
Collapse Height

Specifies the height of the target area in the source buffer, in pixels.
Collapse M_TYPE

Sets the particular statistics to be performed. Enabling fewer statistics will help increase the speed of the operation. You can set the type to one or more of the following values. INQ

(summarize)
Collapse M_ALL

Specifies that all statistical operations are performed.
Collapse M_MAX

Specifies the maximum pixel value. Note that the result of this operation is stored as a single value and not as a result image inside the multiple statistics result buffer.

(summarize)
Collapse M_MAX_ABS

Specifies the maximum absolute pixel value. Note that the result of this operation is stored as a single value and not as a result image inside the multiple statistics result buffer.

(summarize)
Collapse M_MEAN

Specifies the mean value of the pixels.
Collapse M_MIN

Specifies the minimum pixel value. Note that the result of this operation is stored as a single value and not as a result image inside the multiple statistics result buffer.

(summarize)
Collapse M_MIN_ABS

Specifies the minimum absolute pixel value. Note that the result of this operation is stored as a single value and not as a result image inside the multiple statistics result buffer.

(summarize)
Collapse M_NUMBER

Specifies the number of images.
Collapse M_STANDARD_DEVIATION

Specifies the standard deviation value.
Collapse M_SUM

Specifies the sum of the pixel values.
Collapse M_SUM_ABS

Specifies the sum of the absolute pixel values.
Collapse M_SUM_OF_SQUARES

Specifies the sum of the squared pixel values.
Collapse Rearrangement image processing context ID

Specifies a rearrangement image processing context, allocated using MimAlloc() with M_REARRANGE_CONTEXT, and used in MimRearrange() operations.

(summarize)
Collapse M_MODE

Sets the processing mode. INQ

(summarize)
Collapse M_LINES

Specifies that each area to be rearranged is a single horizontal line.
Collapse M_RECTS

Specifies that each area to be rearranged is a single rectangle.
Collapse Wavelet image processing context ID

Specifies a wavelet image processing context, allocated using MimAlloc() with M_WAVELET_TRANSFORM_CONTEXT or M_WAVELET_TRANSFORM_CUSTOM_CONTEXT, and used in MimWaveletTransform() or MimWaveletDenoise() operations. Unless otherwise specified, settings apply to both M_WAVELET_TRANSFORM_CONTEXT and M_WAVELET_TRANSFORM_CUSTOM_CONTEXT context types.

(summarize)
Collapse M_TRANSFORMATION_MODE

Sets the wavelet transformation mode. Modifying the transformation mode can affect how MIL samples the data and produces the wavelet results (for example, the diagonal, horizontal, and vertical coefficients). INQ

(summarize)
Collapse M_DEFAULT

Same as M_DYADIC.
Collapse M_DYADIC

Specifies a dyadic wavelet transformation. For each transformation level, MIL samples the wavelet coefficients by a factor of 2. For example, when drawing dyadic results, they are at different sizes, at different levels. Dyadic transformations generally apply to signal coding and data compression. Performing MimWaveletDenoise() with M_DYADIC is typically faster than M_UNDECIMATED, though the quality of denoising is usually lower. In general, M_DYADIC uses less resources (processing time and memory) than M_UNDECIMATED.

(summarize)
Collapse M_UNDECIMATED +

Specifies an undecimated wavelet transformation. Such transformations are designed to overcome the lack of invariance between transformation levels in dyadic wavelet transformations. For example, when drawing undecimated results, they are at the same size regardless of the level. Undecimated transformations generally apply to signal denoising and pattern recognition. Performing MimWaveletDenoise() with M_UNDECIMATED is typically slower than M_DYADIC, though the quality of denoising is usually higher. In general, M_UNDECIMATED uses more resources (processing time and memory) than M_DYADIC.

(summarize)
Collapse M_WAVELET_TYPE

Sets a predefined type of wavelet filter. Only available if the context type is M_WAVELET_TRANSFORM_CONTEXT. The mathematical domain of complex filter types (M_..._COMPLEX) consists of numbers that have a real part (real numbers) and an imaginary part (imaginary numbers). The mathematical domain of filter types that are not complex consist of real numbers only. INQ

(summarize)
Collapse M_DEFAULT

Same as M_HAAR.
Collapse M_DAUBECHIES_1

Specifies a Daubechies wavelet filter that uses 1 vanishing moment and real coefficients.
Collapse M_DAUBECHIES_2

Specifies a Daubechies wavelet filter that uses 2 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_3

Specifies a Daubechies wavelet filter that uses 3 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_3_COMPLEX

Specifies a Daubechies wavelet filter that uses 3 vanishing moments and complex coefficients.
Collapse M_DAUBECHIES_4

Specifies a Daubechies wavelet filter that uses 4 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_5

Specifies a Daubechies wavelet filter that uses 5 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_5_COMPLEX

Specifies a Daubechies wavelet filter that uses 5 vanishing moments and complex coefficients.
Collapse M_DAUBECHIES_6

Specifies a Daubechies wavelet filter that uses 6 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_7

Specifies a Daubechies wavelet filter that uses 7 vanishing moments and real coefficients.
Collapse M_DAUBECHIES_7_COMPLEX

Specifies a Daubechies wavelet filter that uses 7 vanishing moments and complex coefficients.
Collapse M_DAUBECHIES_8

Specifies a Daubechies wavelet filter that uses 8 vanishing moments and real coefficients.
Collapse M_HAAR

Specifies a Haar wavelet filter. Haar uses real coefficients.

(summarize)
Collapse M_SYMLET_1

Specifies a Symlet wavelet filter that uses 1 vanishing moment and real coefficients.
Collapse M_SYMLET_2

Specifies a Symlet wavelet filter that uses 2 vanishing moments and real coefficients.
Collapse M_SYMLET_3

Specifies a Symlet wavelet filter that uses 3 vanishing moments and real coefficients.
Collapse M_SYMLET_4

Specifies a Symlet wavelet filter that uses 4 vanishing moments and real coefficients.
Collapse M_SYMLET_5

Specifies a Symlet wavelet filter that uses 5 vanishing moments and real coefficients.
Collapse M_SYMLET_6

Specifies a Symlet wavelet filter that uses 6 vanishing moments and real coefficients.
Collapse M_SYMLET_7

Specifies a Symlet wavelet filter that uses 7 vanishing moments and real coefficients.
Collapse M_SYMLET_8

Specifies a Symlet wavelet filter that uses 8 vanishing moments and real coefficients.
Combination constant for M_UNDECIMATED (when ContextOrResultImId=Wavelet image processing context ID, and ControlType=M_TRANSFORMATION_MODE, and ControlValue=M_UNDECIMATED).

You can add the following value to the above-mentioned value to specify undecimated wavelet transformations that are centered.

function map For specifying whether undecimated wavelet transformations are centered
CollapseCombination value Description
Collapse M_CENTER

Specifies undecimated wavelet transformations that are centered. Undecimated wavelet transformations that are not centered can appear misaligned (for example, when drawing results).

(summarize)
Combination constants for M_DEFAULT (when ContextOrResultImId=Locate peak 1D image processing result ID, and ControlType=M_SORT_CRITERION, and ControlValue=M_DEFAULT); M_PEAK_INTENSITY (when ContextOrResultImId=Locate peak 1D image processing result ID, and ControlType=M_SORT_CRITERION, and ControlValue=M_PEAK_INTENSITY); M_PEAK_POSITION (when ContextOrResultImId=Locate peak 1D image processing result ID, and ControlType=M_SORT_CRITERION, and ControlValue=M_PEAK_POSITION).

You can add one of the following values to the above-mentioned values to specify the order to sort peaks.

function map For specifying the order to sort peaks
CollapseCombination value Description
Collapse M_SORT_DOWN

Sorts peaks in descending order.
Collapse M_SORT_UP

Sorts peaks in ascending order.
Remark
  • [MIL-Lite]
    Note that some of the values listed above are not available in MIL-Lite. See the value's corresponding operation function for MIL-Lite availability.
Type-specific versions of the function
void MimControlDouble (MIL_ID ContextOrResultImId, MIL_INT64 ControlType, MIL_DOUBLE ControlValue)
Details
Parameters

ContextOrResultImId

See ContextOrResultImId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.
void MimControlInt64 (MIL_ID ContextOrResultImId, MIL_INT64 ControlType, MIL_INT64 ControlValue)
Details
Parameters

ContextOrResultImId

See ContextOrResultImId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.
Compilation information
Header Include mil.h.
Library Use mil.lib; milim.lib.
DLL Requires mil.dll; milim.dll.
BINARIZE ADAPTIVE CONTEXT AVERAGE MODE DEFAULT GAUSSIAN UNIFORM FOREGROUND VALUE DEFAULT FOREGROUND BLACK FOREGROUND WHITE GLOBAL MAX DEFAULT GLOBAL MIN GLOBAL MIN DEFAULT GLOBAL MAX GLOBAL OFFSET DEFAULT GLOBAL OFFSET SECOND PASS DEFAULT HYSTERESIS DEFAULT DISABLE ENABLE LOCAL DIMENSION DEFAULT MINIMUM CONTRAST DEFAULT NIBLACK BIAS DEFAULT NIBLACK BIAS SECOND PASS DEFAULT THRESHOLD MODE DEFAULT BERNSEN LOCAL MEAN NIBLACK PSEUDOMEDIAN BINARIZE ADAPTIVE FROM SEED CONTEXT FOREGROUND VALUE DEFAULT FOREGROUND BLACK FOREGROUND WHITE GLOBAL OFFSET DEFAULT NB ITERATIONS DEFAULT TO IDEMPOTENCE NB SEED ITERATIONS DEFAULT THRESHOLD MODE DEFAULT LEVEL RECONSTRUCT TOGGLE DEAD PIXEL CONTEXT DEAD PIXELS PROC NONE INTERPOLATION MODE DEFAULT AVERAGE DEINTERLACE CONTEXT DEINTERLACE TYPE DEFAULT ADAPTIVE AVERAGE ADAPTIVE BOB ADAPTIVE DISCARD AVERAGE BOB DISCARD DISCARD FIELD DEFAULT EVEN FIELD ODD FIELD FIRST FIELD DEFAULT EVEN FIELD ODD FIELD MOTION DETECT NUM FRAMES DEFAULT MOTION DETECT OUTPUT DEFAULT DISABLE ENABLE MOTION DETECT REFERENCE FRAME DEFAULT CENTER FRAME FIRST FRAME LAST FRAME MOTION DETECT NUM FRAMES MOTION DETECT THRESHOLD SOURCE FIRST IMAGE DEFAULT RESULT OUTPUT UNITS DEFAULT ACCORDING TO CALIBRATION PIXEL WORLD FIND ORIENTATION CONTEXT BORDER ATTENUATION DEFAULT DISABLE ENABLE FREQUENCY CUTOFF RATIO HIGH DEFAULT FREQUENCY CUTOFF RATIO LOW DEFAULT INTERPOLATION MODE DEFAULT AVERAGE BICUBIC BILINEAR INTERPOLATE MAX MIN NEAREST NEIGHBOR MODE DEFAULT CLIP CENTER RESIZE DOWN RESIZE UP FLAT FIELD CONTEXT DARK CONST DARK IMAGE UNSIGNED PROC NONE FLAT CONST FLAT IMAGE UNSIGNED PROC NONE GAIN CONST AUTOMATIC OFFSET CONST OFFSET IMAGE UNSIGNED PROC NONE HISTOGRAM EQUALIZE ADAPTIVE CONTEXT ALPHA VALUE DEFAULT CLIP LIMIT DEFAULT HIST SIZE DEFAULT ACCORDING TO SOURCE NUMBER OF TILES X DEFAULT NUMBER OF TILES Y DEFAULT OPERATION DEFAULT EXPONENTIAL HYPER CUBE ROOT HYPER LOG RAYLEIGH UNIFORM HIST BIN SIZE MODE DEFAULT FIT SRC DATA FIT SRC RANGE FREEDMAN REGULAR HIST SMOOTHING ITERATIONS DEFAULT LOCATE PEAK 1D CONTEXT MINIMUM CONTRAST DEFAULT NUMBER OF PEAKS PEAK INTENSITY RANGE DEFAULT PEAK WIDTH DELTA DEFAULT PEAK WIDTH NOMINAL DEFAULT SCAN LANE DIRECTION DEFAULT HORIZONTAL VERTICAL SORT CRITERION DEFAULT PEAK INTENSITY PEAK POSITION MATCH CONTEXT MASK IMAGE PROC NONE MAX SCORE DEFAULT MAX DEPTH MODE DEFAULT ABS SUM OF DIFFERENCES CORRELATE CORRELATE NORMALIZED MODEL IMAGE UNSIGNED PROC NONE MODEL STEP DEFAULT SCORE TYPE DEFAULT NORM NORM CLIP NORM CLIP SQR SQR NORM STAT MULTIPLE CONTEXT MODE DEFAULT 2D SIZE X SIZE Y TYPE ALL MAX MAX ABS MEAN MIN MIN ABS NUMBER STANDARD DEVIATION SUM SUM ABS SUM OF SQUARES REARRANGE CONTEXT MODE LINES RECTS WAVELET TRANSFORM CONTEXT WAVELET TRANSFORM CUSTOM CONTEXT TRANSFORMATION MODE DEFAULT DYADIC UNDECIMATED WAVELET TYPE DEFAULT DAUBECHIES 1 DAUBECHIES 2 DAUBECHIES 3 DAUBECHIES 3 COMPLEX DAUBECHIES 4 DAUBECHIES 5 DAUBECHIES 5 COMPLEX DAUBECHIES 6 DAUBECHIES 7 DAUBECHIES 7 COMPLEX DAUBECHIES 8 HAAR SYMLET 1 SYMLET 2 SYMLET 3 SYMLET 4 SYMLET 5 SYMLET 6 SYMLET 7 SYMLET 8 CENTER SORT DOWN SORT UP BINARIZE ADAPTIVE CONTEXT BINARIZE ADAPTIVE FROM SEED CONTEXT HISTOGRAM EQUALIZE ADAPTIVE CONTEXT DEAD PIXEL CONTEXT DEINTERLACE CONTEXT FIND ORIENTATION CONTEXT FLAT FIELD CONTEXT LOCATE PEAK 1D CONTEXT MATCH CONTEXT STAT MULTIPLE CONTEXT REARRANGE CONTEXT WAVELET TRANSFORM CONTEXT WAVELET TRANSFORM CUSTOM CONTEXT