Member name	Value	Description
mclrNoAction	0	No mode bits set and no action taken.
mclrmAll	3	Reset all settings, includingMcLookupTables.DisplayTint unless mclrmNoResetDisplayTint is set.
mclrmBCGR	1	Reset everything except black and whitelevels. McLookupTables.DisplayTint will not be reset unless mclrmBW is also set and mclrmNoResetDisplayTint is not set.
mclrmBW	2	Reset black and white levels only.McLookupTables.DisplayTint will not be reset unless mclrmBCGR is also set and mclrmNoResetDisplayTint is not set.
mclrmBWBestFit	4	Set black and white levels totheir best fit values that exclude McLookupTables.BestFitPercent (1% by default) of pixels at either end of the luminance range. The balance between pixels excluded at low and high luminances can be adjusted with the McLookupTables.BestFitBalance property (allowed range from -1 to +1, with zero the default).
mclrmBWTrueRange	8	black and white levels to their true range values.
mclrmSeparateBW	16	If OR'ed with the mclrmBWBestFitor mclrmBWTrueRange, then for color McLookupTables.Reset or McLookupTables.Item(0).Reset, each individual color channel McLookupTable (e.g., McLookupTables.Item 1, 2 and 3) is set to its individual best fit (mclrmBWBestFit) or true range (mclrmBWTrueRange) values, and the luminance lookup table (McLookupTables.Item 0) Black/White Levels are set to the most extreme values from any of the color channels. If this flag is not present, then the best fit or true range is based on either a luminance cast (i.e., the average of all color channels) if the mclrmLuminanceBW flag is set, or on the extremal Black/White values found for any color channel (this is the default); in either case all of the lookup table Black/White Levels are set to the same values.
mclrmLuminanceBW	32	If OR'ed with themclrmBWBestFit or mclrmBWTrueRange, then for color McLookupTables.Reset or McLookupTables.Item(0).Reset, the luminance channel and all color channel McLookupTable BlackLevel WhiteLevel values are set to the same best fit (mclrmBWBestFit) or true range (mclrmBWTrueRange) values based on a luminance cast of the image. If this flag is not present, then the best fit or true range for each channel is based on either the channel's individual histogram if the mclrmSeparateBW flag is set, or on the extremal Black/White values found for any color channel (this is the default).
mclrmActiveFrameOnlyBW	64	If OR'ed with themclrmBWBestFit or mclrmBWTrueRange, then for color McLookupTables.Reset or McLookupTable.Reset, the best fit or absolute range computation is based on only the ActiveFrame of the image. If clear (the default) then computations are based on all frames, which can be slow for images with many frames.
mclrmNoSamplingBW	128	If OR'ed with themclrmBWBestFit or mclrmBWTrueRange, then for McLookupTables.Reset or McLookupTable.Reset, the best fit or absolute range computation is based on only an unsampled image scan, which can be slow for large images with many frames.. If clear (the default) then computations of images with large frames and/or many frames are based on a subsample of the image data. This flag also has the effect of allowing a progress bar to be displayed during the image scan.
mclrmFavorFrameSamplingBW	256	If OR'ed with themclrmBWBestFit or mclrmBWTrueRange, then for McLookupTables.Reset or McLookupTables.Reset, and the mclrmNoSamplingBW bit is clear, so that the best fit or absolute range computation is based on a sampled image scan, then the sampling will favor skipping frames over skipping pixels within frames.
mclrmStartAccumulateBW	512	If OR'ed with the mclrmBWBestFitor mclrmBWTrueRange, then for McLookupTables.Reset or McLookupTables.Item(0).Reset, an "accumulate" reset mode is started with the current mclrmBWBestFit or mclrmBWTrueRange, mclrmSeparateBW, mclrmLuminanceBW and mclrmNoSamplingBW Reset mode flags. The mclrmActiveFrameOnlyBW and mclrmFavorFrameSamplingBW have no effect in "accumulate" mode. When accumulate mode is started, the McLookupTable BlackLevel/WhiteLevel values are set based on the current ancestor McImage.ActiveFrameIndex only. An event handler is set up to track when the ancestor McImage.ActiveFrameIndex changes, and for frames that have not yet been "visited" the histogram of the new active frame is accumulated with all previous frames and the lookup table is realized. When all frames have been accumulated or any other Reset call is made, the mode is stopped and no further automatic resets will occur.
mclrmStopAccumulateBW	1024	Any "accumulate" reset BWmode started by the mclrmStartAccumulateBW flag is immediately stopped.
mclrmNoResetDisplayTint	2048	If this flag is OR'ed in with mclrmAll(mclrmBCGR + mclrmBW) then McLookupTables.DisplayTint will not be reset .

Remarks

mclrmBWBestFit uses McHistogram.BestFitRange to set the black and white levels so that the total of the bin counts outside of this range equals to McLookupTables.BestFitPercent*2 of the Sum of all the bin counts (BestFitPercent lower than BlackLevel and BestFitPercent higher than WhiteLevel). McLookupTables.BestFitPercent is 1% by default, so that 2% of all pixels are excluded. The balance between pixels excluded at low and high luminances can be adjusted with the McLookupTables.BestFitBalance property (allowed range from -1 to +1, with zero the default).

Reference

MediaCy.IQL.Engine Namespace