| MIL 10 Reference
| Customize Help
| Save Settings

McolControl



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
Control a color matching context, its color-samples, or the color-samples of a relative color calibration context.
Syntax
void McolControl(
MIL_ID ContextId, //in
MIL_INT IndexOrLabel, //in
MIL_INT64 ControlType, //in
MIL_DOUBLE ControlValue //in
)
Description

This function sets the specified control type for a color matching context, its color-samples, or the color-samples of a relative color calibration context. These control type settings affect the execution of McolPreprocess(), McolMatch(), McolTransform(), and McolDraw(). Typically, you can inquire the control type setting, using McolInquire().

Changing certain control type settings require you to preprocess the context again, using McolPreprocess(). To know if the context needs to be preprocessed, call McolInquire() with the M_PREPROCESSED inquire type.

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
ContextId

Specifies the identifier of the color matching or relative color calibration context. The context must have been previously allocated on the required system using McolAlloc() with M_COLOR_MATCHING or M_COLOR_CALIBRATION_RELATIVE.

IndexOrLabel

Specifies what to control. Set this parameter to one of the following values. Unless otherwise specified, these values are only available for color matching contexts.

function map For specifying what to control
CollapseValue Description
Collapse M_DEFAULT

Same as M_CONTEXT.

Collapse

Specifies the index of the color-sample to control. This value is available for color matching and relative color calibration contexts.

(summarize)
Parameters

Specifies an index value greater than or equal to 0.

Collapse

Specifies the label of the color-sample to control. This value is available for color matching and relative color calibration contexts.

(summarize)
Parameters

Specifies a label value greater than 0.

Collapse M_ALL

Specifies to control all color-samples within the color matching context. The specified control type setting must be supported by all the color-samples.

(summarize)
Collapse M_CONTEXT

Specifies to control a global setting of the color matching context.

ControlType

Specifies the setting to change.

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

ControlValue

Specifies the setting's new value.

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

The following ControlType and corresponding ControlValue parameter settings are used to control general color matching context settings. In this case, you must set the IndexOrLabel parameter to M_CONTEXT. These values are only available for color matching contexts.

function map For controlling general color matching context settings
CollapseControlType Description
ControlValue
Collapse M_ACCEPTANCE

Sets the acceptance level for the color-sample's score (M_SCORE with McolGetResult()). This score indicates the similarity between the color of the color-sample and the color of the target area. The higher the acceptance, the closer the colors must be for them to match.

For a match, the color-sample must have a score that is greater than or equal to this level. INQ

(summarize)
Collapse M_DEFAULT

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

Collapse 0.0 <= Value <= 100.0

Specifies an acceptable score, as a percentage.

Collapse M_ACCEPTANCE_RELEVANCE

Sets the acceptance level for the target area's relevance score (M_SCORE_RELEVANCE). This score indicates the significance (relevance) of the match score (M_SCORE). In statistics, this is similar to the confidence level; that is, it represents how confident you can be that the best-matched color-sample actually is the best possible match. For example, a high relevance acceptance indicates that the best-matched color-sample must be vastly superior to all other color-samples, while a low relevance acceptance indicates that the best-matched color-sample only needs to be marginally superior to the other color-samples.

A target area can only have a successful matching status (M_STATUS with McolGetResult()) if its relevance score is above the relevance acceptance level. A target area with a successful matching status also requires at least one color-sample score to be above M_ACCEPTANCE. INQ

(summarize)
Collapse M_DEFAULT

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

Collapse 0.0 <= Value <= 100.0

Specifies an acceptable relevance score, as a percentage.

Collapse M_BACKGROUND_DRAW_COLOR

Sets the color to use to draw background pixels when drawing or generating the color images (M_DRAW_..._USING_COLOR), the distance image (M_DRAW_DISTANCE), or the grayscale label images (M_DRAW_..._USING_LABEL), using McolDraw() or McolMatch().

A pixel is considered background when it is outside the target areas. For background pixels to exist, you must specify an area identifier image when calling McolMatch(). INQ

(summarize)
Collapse M_DEFAULT

Same as M_TRANSPARENT.

Collapse

Specifies a 24-bit color value (eight bits per band) with which to set the background pixels. The color value is taken as is (no conversion), according to the source color space. Typically, this should be RGB, since the background color is meant for display.

When M_BACKGROUND_DRAW_COLOR is set with M_COLOR888(), only the first component (for example, red) will be used to draw or generate M_DRAW_DISTANCE, which is a grayscale image.

(summarize)
Parameters

Specifies the first component, as a value between 0 and 255.

Specifies the second component, as a value between 0 and 255.

Specifies the third component, as a value between 0 and 255.

Collapse M_TRANSPARENT

Specifies not to change the background. Therefore, the background pixels will be those of the specified destination image.

(summarize)
Collapse Value > 0

Specifies a grayscale value for the background pixels, as a double or integer.

When drawing the distance image (M_DRAW_DISTANCE) in a 32-bit integer buffer, you should keep the M_BACKGROUND_DRAW_COLOR value under 24-bit (that is, less than 16,777,215).

(summarize)
Collapse M_BAND_MODE

Specifies the color bands to use when performing a match. This applies to all color-samples in the context and to the target areas. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ALL_BANDS.

Collapse M_ALL_BANDS

Specifies to use all bands.

Collapse M_COLOR_BAND_0

Specifies to use band 0.

Collapse M_COLOR_BAND_0 + M_COLOR_BAND_1

Specifies to use bands 0 and 1.

Collapse M_COLOR_BAND_0 + M_COLOR_BAND_2

Specifies to use bands 0 and 2.

Collapse M_COLOR_BAND_1

Specifies to use band 1.

Collapse M_COLOR_BAND_1 + M_COLOR_BAND_2

Specifies to use bands 1 and 2.

Collapse M_COLOR_BAND_2

Specifies to use band 2.

Collapse M_CONVERSION_GAMMA

Specifies whether to remove gamma correction when internally converting RGB source colors before the match using McolSetMethod() with the CIELAB conversion mode. Gamma correction refers to color data that has been processed, typically during data acquisition (that is, by the camera doing the grab), to compensate for a non-linear transformation between a pixel's value and its displayed intensity on the display device.

When converting RGB source colors to CIELAB, MIL requires linear color data; that is, data that is uncorrected. Therefore, if gamma correction has been applied on the RGB source color data, you must remove it. Unless you are using the CIELAB conversion mode in an RGB source color space, M_CONVERSION_GAMMA is ignored. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ENABLE.

Collapse M_DISABLE

Specifies not to remove gamma correction. In this case, your RGB color data should not be in a corrected state (it should be linear). For example, the camera capturing the RGB color data has not applied a gamma correction.

(summarize)
Collapse M_ENABLE

Specifies to remove gamma correction. In this case, your RGB color data should be in a corrected state (it should be non-linear). For example, the camera capturing the RGB color data has applied a gamma correction.

MIL assumes that your color data has been corrected according to the standards of the context's reference color space, as specified using McolAlloc() with the ColorSpaceProfileId parameter. MIL uses these standards (for example, sRGB) to remove the gamma correction.

(summarize)
Collapse M_DISTANCE_IMAGE_NORMALIZE

Sets the normalization factor when drawing or generating M_DRAW_DISTANCE, using McolDraw() or McolMatch().

Distance results are always clipped at the distance buffer's maximal possible value, which can occur when specifying M_NO_NORMALIZE or a specific normalization factor. For example, when using an 8-bit unsigned distance buffer, distances higher than 255 will be written as 255. Note that if you specify a distance buffer of type floating-point, distance results would almost never be greater than the buffer's maximal possible value, since its limit is extremely high.

MIL ignores M_DISTANCE_IMAGE_NORMALIZE when using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_NO_NORMALIZE.

Collapse M_MAX_NORMALIZE

Specifies to normalize distance values according to the greatest calculated distance. This value corresponds to the result M_MAX_DISTANCE (McolGetResult()). The normalization performed is:

  • (Distance/GreatestCalculatedDistance) x MaximumPossibleValueOfDistBuf (for distance buffer's of type integer).

  • (Distance/GreatestCalculatedDistance) (for distance buffer's of type floating-point).

    Note that if the distance buffer is of type floating-point, you would typically not normalize the distance results, since all this will do is return a value between 0.0 and 1.0.

(summarize)
Collapse M_NO_NORMALIZE

Specifies no normalization. For distance buffers of type integer, distance values are truncated (no decimals). For distance buffers of type floating-point, distance values are complete (with decimals).

(summarize)
Collapse Value > 0.0

Specifies to normalize distance values according to the specified normalization value. The normalization performed is:

  • (Distance/NormalizationValue) x MaximumPossibleValueOfDistBuf (for distance buffer's of type integer).

  • (Distance/NormalizationValue) (for distance buffer's of type floating-point).

    Note that if the distance buffer is of type floating-point, you would typically not normalize the distance results, since all this will do is return a value between 0.0 and 1.0.

(summarize)
Collapse M_DISTANCE_TOLERANCE_MODE

Sets the strategy with which to use the tolerance value (M_DISTANCE_TOLERANCE) to calculate the acceptable (matching) color distance (tolerance) between the color-sample and a target area.

When using an M_HISTOGRAM_MATCHING operation mode (McolSetMethod()), you must set M_DISTANCE_TOLERANCE_MODE to M_ABSOLUTE. When using an M_HISTOGRAM_VOTE operation mode, MIL ignores M_DISTANCE_TOLERANCE_MODE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_ABSOLUTE.

Collapse M_ABSOLUTE

Specifies that the M_DISTANCE_TOLERANCE value will be untouched and used as the acceptable distance tolerance.

Collapse M_RELATIVE

Specifies a tolerance strategy based on the relative distances between pairs of color-samples. In this case, MIL establishes the smallest distance between any given color-sample and every other color-sample. Half this value is then multiplied by the M_DISTANCE_TOLERANCE value, and the resulting value serves as the acceptable distance tolerance for the color-sample in question. This process is repeated for each color-sample.

(summarize)
Collapse M_SAMPLE_STDDEV

Specifies a tolerance strategy based on the color-sample's standard deviation.

For color-samples that come from an image (McolDefine() with M_IMAGE), the color-sample's standard deviation is computed as the distance between each pixel in the color-sample and the average color of the color-sample. MIL calculates this distance according to the current distance type set with McolSetMethod(). The resulting distance, which in this case is considered to be the color-sample's standard deviation, is multiplied by M_DISTANCE_TOLERANCE and is used as the acceptable distance tolerance. If the computed color-sample's standard deviation is less than 1.0, MIL uses 1.0 as the standard deviation.

For triplet color-samples (McolDefine() with M_TRIPLET), MIL uses 1.0 as the standard deviation. In this case, M_DISTANCE_TOLERANCE remains unchanged and is used as the acceptable distance tolerance.

(summarize)
Collapse M_GENERATE_DISTANCE_IMAGE

Sets whether to generate the distance image and store it in the result buffer. This image contains the difference between the color of the target area and the color of its best-matched color-sample.

MIL ignores M_GENERATE_DISTANCE_IMAGE when using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies not to generate the image.

Collapse M_ENABLE

Specifies to generate the image.

Collapse M_GENERATE_PIXEL_MATCH

Sets whether to generate the image containing the label of the color-sample for which each pixel voted. This image is only available if you use McolSetMethod() with M_MIN_DIST_VOTE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies not to generate the image.

Collapse M_ENABLE

Specifies to generate the image.

Collapse M_GENERATE_SAMPLE_COLOR_LUT

Sets whether to generate the color-sample label LUT and store it in the result buffer. This LUT contains the label value of each color-sample and its associated average color. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies not to generate the LUT.

Collapse M_ENABLE

Specifies to generate the LUT.

Collapse M_NB_BINS_BAND_0

Sets the number of histogram bins for color band 0. Relevant only when matching colors using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE.

The number of bins situated along the axis of band 0 determine the size of the bins for that band. If you multiply the number of bins situated along the axis of each band (M_NB_BINS_BAND_0, M_NB_BINS_BAND_1, and M_NB_BINS_BAND_2) you obtain the total number of bins. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 10.

Collapse Value > 0

Specifies the number of histogram bins for color band 0.

Collapse M_NB_BINS_BAND_1

Sets the number of histogram bins for color band 1. Relevant only when matching colors using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE.

The number of bins situated along the axis of band 1 determine the size of the bins for that band. If you multiply the number of bins situated along the axis of each band (M_NB_BINS_BAND_0, M_NB_BINS_BAND_1, and M_NB_BINS_BAND_2) you obtain the total number of bins. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 10.

Collapse Value > 0

Number of histogram bins for color band 1.

Collapse M_NB_BINS_BAND_2

Sets the number of histogram bins for color band 2. Relevant only when matching colors using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE.

The number of bins situated along the axis of band 2 determine the size of the bins for that band. If you multiply the number of bins situated along the axis of each band (M_NB_BINS_BAND_0, M_NB_BINS_BAND_1, and M_NB_BINS_BAND_2) you obtain the total number of bins. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 10.

Collapse Value > 0

Number of histogram bins for color band 2.

Collapse M_OUTLIER_DRAW_COLOR

Sets the color to use to draw outlier pixels when drawing or generating the color images (M_DRAW_..._USING_COLOR) or the distance image (M_DRAW_DISTANCE), using McolDraw() or McolMatch().

Outlier pixels are pixels inside a target area that do not match with any color-sample. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.

Collapse

Specifies a 24-bit color value (eight bits per band) with which to set the outlier pixels. The color value is taken as is (no conversion), according to the source color space. Typically, this should be RGB, since the outlier color is meant for display.

When M_OUTLIER_DRAW_COLOR is set with M_COLOR888(), only the first component (for example, red) will be used to draw or generate M_DRAW_DISTANCE, which is a grayscale image.

(summarize)
Parameters

Specifies the first component, as a value between 0 and 255.

Specifies the second component, as a value between 0 and 255.

Specifies the third component, as a value between 0 and 255.

Collapse M_TRANSPARENT

Specifies not to change the value of the outlier pixels. Therefore, the outlier pixels will be those of the specified image.

(summarize)
Collapse Value > 0

Specifies a grayscale value for the outlier pixels, as a double or integer.

When drawing the distance image (M_DRAW_DISTANCE) in a 32-bit integer buffer, you should keep the M_OUTLIER_DRAW_COLOR value under 24-bit (that is, less than 16,777,215).

(summarize)
Collapse M_OUTLIER_LABEL

Sets the label to use for outlier pixels when drawing or generating the label images (M_DRAW_..._USING_LABEL) using McolDraw() or McolMatch().

Outlier pixels are pixels inside a target area that do not match with any color-sample.

Note that the M_OUTLIER_LABEL setting does not represent a valid color-sample and you cannot pass it as a color-sample label to McolInquire(), McolGetResult(), or McolDraw(). INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 0.

Collapse Value > 0

Specifies the label of the outlier pixels, as an integer. The label must be unique among existing labels, and must be less than 224 .

(summarize)
Collapse M_SAVE_AREA_IMAGE

Sets whether to save the area identifier image in the result buffer. INQ

(summarize)
Collapse M_DEFAULT

Same as M_DISABLE.

Collapse M_DISABLE

Specifies not to save the image.

Collapse M_ENABLE

Specifies to save the image.

The following ControlType and corresponding ControlValue parameter settings are used to control color space encoding, according to the actual dynamic range of your color data. In this case, you must set the IndexOrLabel parameter to M_CONTEXT. These values are only available for color matching contexts.

Color space encoding defines how color is transformed from the range represented in an image buffer to its native (theoretical) range. For example, RGB color space data is represented in an image buffer as values between 0 and 255 (8-bit); these values are then mapped to their native data range, which consists of all real numbers between 0 and 1.

The Color Analysis module allows you to perform this transformation automatically, using M_ENCODING with M_nBIT, which is typically sufficient. You can also use M_USER_DEFINED to explicitly control the transformation according to offset (M_OFFSET_BAND_n) and scale (M_SCALE_BAND_n) values. For more information, see the Color space encoding subsection of the Advanced color matching settings and concepts section of Chapter 16: Color processing and analysis.

function map For controlling color matching context settings that are used for color space encoding
CollapseControlType Description
ControlValue
Collapse M_ENCODING

Sets the color space encoding, which defines how color is transformed from the range represented in an image buffer to its native (theoretical) range. INQ

(summarize)
Collapse M_DEFAULT

Same as M_8BIT.

Collapse M_8BIT

Specifies an internally defined color space encoding for 8-bit images.

Collapse M_10BIT

Specifies an internally defined color space encoding for 10-bit images.

Collapse M_12BIT

Specifies an internally defined color space encoding for 12-bit images.

Collapse M_14BIT

Specifies an internally defined color space encoding for 14-bit images.

Collapse M_16BIT

Specifies an internally defined color space encoding for 16-bit images.

Collapse M_USER_DEFINED

Specifies that the color space encoding is defined using M_OFFSET_BAND_n and M_SCALE_BAND_n.

Collapse M_OFFSET_BAND_0

Sets the offset for the color space encoding, for band 0.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the offset, as a double.

Collapse M_OFFSET_BAND_1

Sets the offset for the color space encoding, for band 1.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the offset, as a double.

Collapse M_OFFSET_BAND_2

Sets the offset for the color space encoding, for band 2.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the offset, as a double.

Collapse M_SCALE_BAND_0

Sets the scale for the color space encoding, for band 0.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the scale, as a double.

Collapse M_SCALE_BAND_1

Sets the scale for the color space encoding, for band 1.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the scale, as a double.

Collapse M_SCALE_BAND_2

Sets the scale for the color space encoding, for band 2.

This only applies if M_ENCODING is set to M_USER_DEFINED. INQ

(summarize)
Collapse Value

Specifies the scale, as a double.

The following ControlType and corresponding ControlValue parameter settings are used to control color-samples defined in the context. In this case, you must set the IndexOrLabel parameter to M_SAMPLE_INDEX() or M_SAMPLE_LABEL(). Unless otherwise specified, these values are only available for color matching contexts.

function map For controlling color-samples
CollapseControlType Description
ControlValue
Collapse M_DISTANCE_TOLERANCE

Sets the acceptable tolerance for the color distance between the color-sample and a target area. The tolerance ranges from no color difference to M_DISTANCE_TOLERANCE. The greater the tolerance, the greater the distance (difference) between the colors can be, for them to match.

MIL ignores M_DISTANCE_TOLERANCE when using McolSetMethod() with M_HISTOGRAM_VOTE. INQ

(summarize)
Collapse M_DEFAULT

Same as M_AUTO.

Collapse M_AUTO

Specifies the tolerance automatically.

If you set M_DISTANCE_TOLERANCE_MODE to M_ABSOLUTE, M_AUTO specifies an infinite (M_INFINITE) tolerance.

If you set M_DISTANCE_TOLERANCE_MODE to M_RELATIVE, M_AUTO specifies a tolerance of 1.

If you set M_DISTANCE_TOLERANCE_MODE to M_SAMPLE_STDDEV, M_AUTO specifies a tolerance of 3.

(summarize)
Collapse M_INFINITE

Specifies an infinite tolerance.

Collapse Value >= 0.0

Specifies the tolerance value.

Set the tolerance according to the specified tolerance mode (M_DISTANCE_TOLERANCE_MODE) and distance type (McolSetMethod()). For example, a tolerance value of 1 when using an M_MAHALANOBIS distance type is not the same as when using an M_MANHATTAN distance type, even if the tolerance mode is M_ABSOLUTE.

(summarize)
Collapse M_HISTOGRAM_FREQUENCY_THRESHOLD

Sets the minimal frequency, in pixels, for a histogram bin to count in the matching process. This setting is only valid when using McolSetMethod() with M_HISTOGRAM_MATCHING or M_HISTOGRAM_VOTE.

Increasing the minimal frequency can lead to a faster match while discarding noise in the sample histogram. Bins with a frequency less than the threshold are considered empty. When using triplet color-samples with M_HISTOGRAM_VOTE, it is not recommended to set the frequency threshold to a value other than 1, which is the default. INQ

(summarize)
Collapse M_DEFAULT

Specifies the default value; the default value is 1 pixel.

Collapse Value > 0

Specifies the minimal frequency, as an integer.

Collapse M_SAMPLE_LABEL_VALUE

Sets the color-sample's label. This value is available for color matching and relative color calibration contexts.

Initially, you specify a color-sample's label value when adding a color-sample to the context, using McolDefine(). You can use M_SAMPLE_LABEL_VALUE to change the label afterward. INQ

(summarize)
Collapse Value > 0

Specifies the label, as an integer. The label must be unique among existing labels, and must be less than 224 .

(summarize)
Type-specific versions of the function
void McolControlInt64 (MIL_ID ContextId, MIL_INT IndexOrLabel, MIL_INT64 ControlType, MIL_INT64 ControlValue)
Parameters

ContextId

See ContextId of the main function for a description.

IndexOrLabel

See IndexOrLabel 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; milcolor.lib.
DLL Requires mil.dll; milcolor.dll.
DEFAULT ALL CONTEXT ACCEPTANCE DEFAULT ACCEPTANCE RELEVANCE DEFAULT BACKGROUND DRAW COLOR DEFAULT TRANSPARENT BAND MODE DEFAULT ALL BANDS COLOR BAND 0 COLOR BAND 0 M COLOR BAND 1 COLOR BAND 0 M COLOR BAND 2 COLOR BAND 1 COLOR BAND 1 M COLOR BAND 2 COLOR BAND 2 CONVERSION GAMMA DEFAULT DISABLE ENABLE DISTANCE IMAGE NORMALIZE DEFAULT MAX NORMALIZE NO NORMALIZE DISTANCE TOLERANCE MODE DEFAULT ABSOLUTE RELATIVE SAMPLE STDDEV GENERATE DISTANCE IMAGE DEFAULT DISABLE ENABLE GENERATE PIXEL MATCH DEFAULT DISABLE ENABLE GENERATE SAMPLE COLOR LUT DEFAULT DISABLE ENABLE NB BINS BAND 0 DEFAULT NB BINS BAND 1 DEFAULT NB BINS BAND 2 DEFAULT OUTLIER DRAW COLOR DEFAULT TRANSPARENT OUTLIER LABEL DEFAULT SAVE AREA IMAGE DEFAULT DISABLE ENABLE ENCODING DEFAULT 8BIT 10BIT 12BIT 14BIT 16BIT USER DEFINED OFFSET BAND 0 OFFSET BAND 1 OFFSET BAND 2 SCALE BAND 0 SCALE BAND 1 SCALE BAND 2 DISTANCE TOLERANCE DEFAULT AUTO INFINITE HISTOGRAM FREQUENCY THRESHOLD DEFAULT SAMPLE LABEL VALUE CONTEXT ALL CONTEXT DEFAULT ALL CONTEXT DEFAULT