MaxThresholdPhases Property

Description

The maximum number of threshold Phases supported by a given thresholding method.

Property type

A Long value.

[out,retval]

Syntax

object.MaxThresholdPhases([Method])

The MaxThresholdPhases Property syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McHistogram.
Method	Optional. A mcHistThresholdsMethod enumeration, as described in settings. The method for which you want the maximum number of supported phases. By default this is mchmCurrentMethod, which specifies whichever method is currently set (see SetThresholdParameters).

Settings

The settings for Method are:

Constant		Value	Description
	mchmCurrentMethod	0	Whatever method was already set.
	mchmMinimumVarianceMethod	1	The ratio of between-phase to total variance is minimized (method of Otsu). Works with either two or three phases. This is the default method if SetThresholdParameters has not been called.
	mchmLegacyIPP4Method	2	A version of MinimumVariant with a bias towards low values. works with two phases only.
	mchmTrimmedHistogramMethod	3	Three phases are computed, based on the TrimLeftPercent and TrimRightPercent arguments to SetThresholdParameters. Phase 0 is the leftmost, trimmed section of the histogram, Phase 1 is the middle section between the trimmed portions, and Phase 2 is the rightmost, trimmed section of the histogram. If only two phases are set as the NumberOfPhases, then only the left two are available.
	mchmMaskMethods	255	mask for the mchtmXxxxMethod values
	mchmIgnoreBlack	4096	Pixels in the leftmost bin are not included in the threshold computations, allowing you to ignore under illuminanted regions.
	mchmIgnoreWhite	8192	Pixels in the rightmost bin are not included in the threshold computations, allowing you to ignore oversaturated regions.

Remarks

Each thresholding Method (set via a call to the SetThresholdParameters) can support a maximum number of “Phases”. A Phase is a segment of the luminance range to be thresholded. All Methods support at least two Phases (dark and bright); several support three (dark, middling and bright), and some support many Phases.