EasyImage::HistogramThreshold

Determines an appropriate threshold level based on the histogram contents, using an automatic threshold mode.

Namespace: Euresys::Open_eVision

[C++]

static EHistogramThreshold HistogramThreshold(
   const EBWHistogramVector& histogram,
   OEV_UINT32 threshold,
   float relativeThreshold,
   OEV_UINT32 from,
   OEV_UINT32 to
)

[[deprecated]]
static void HistogramThreshold(
   const EBWHistogramVector* histogram,
   OEV_UINT32& threshold,
   float& averageOfPixelsBelowThreshold,
   float& averageOfPixelsAboveThreshold,
   float relativeThreshold,
   OEV_UINT32 from,
   OEV_UINT32 to
)

Parameters

histogram

Pointer to a vector containing an image histogram.

threshold

reference to the threshold value. Must be set to the appropriate thresholding mode, as defined by EThresholdMode.

relativeThreshold

Relative threshold value, relevant only in the EThresholdMode.Relative mode.

from

Lower bound of the analyzed gray-level range.

to

Upper bound of the analyzed gray-level range.

averageOfPixelsBelowThreshold

Average gray level of the dark pixels (below threshold).

averageOfPixelsAboveThreshold

Average gray level of the light pixels (above threshold).

Remarks

Additionally, returns the average gray levels in the regions below and above the threshold. The threshold level can be computed by analyzing a range of gray levels in the histogram.

EasyImage.HistogramThreshold

Determines an appropriate threshold level based on the histogram contents, using an automatic threshold mode.

Namespace: Euresys.Open_eVision

[C#]

static EHistogramThreshold HistogramThreshold(
   EBWHistogramVector histogram,
   uint threshold,
   float relativeThreshold,
   uint from,
   uint to
)

[Obsolete]
static void HistogramThreshold(
   EBWHistogramVector histogram,
   ref uint threshold,
   out float averageOfPixelsBelowThreshold,
   out float averageOfPixelsAboveThreshold,
   float relativeThreshold,
   uint from,
   uint to
)

Parameters

histogram

Pointer to a vector containing an image histogram.

threshold

reference to the threshold value. Must be set to the appropriate thresholding mode, as defined by EThresholdMode.

relativeThreshold

Relative threshold value, relevant only in the EThresholdMode.Relative mode.

from

Lower bound of the analyzed gray-level range.

to

Upper bound of the analyzed gray-level range.

averageOfPixelsBelowThreshold

Average gray level of the dark pixels (below threshold).

averageOfPixelsAboveThreshold

Average gray level of the light pixels (above threshold).

Remarks

Additionally, returns the average gray levels in the regions below and above the threshold. The threshold level can be computed by analyzing a range of gray levels in the histogram.

EasyImage.HistogramThreshold

Determines an appropriate threshold level based on the histogram contents, using an automatic threshold mode.

Module: open_evision

[Python]

@staticmethod
HistogramThreshold(
    histogram: EBWHistogramVector
    threshold: int
    relativeThreshold: float
    from_: int
    to: int
) -> EHistogramThreshold

@staticmethod
HistogramThreshold(
    histogram: EBWHistogramVector
    threshold: int
    relativeThreshold: float
    from_: int
) -> EHistogramThreshold

@staticmethod
HistogramThreshold(
    histogram: EBWHistogramVector
    threshold: int
    relativeThreshold: float
) -> EHistogramThreshold

@staticmethod
HistogramThreshold(
    histogram: EBWHistogramVector
    threshold: int
) -> EHistogramThreshold

Parameters

histogram

Pointer to a vector containing an image histogram.

threshold

reference to the threshold value. Must be set to the appropriate thresholding mode, as defined by EThresholdMode.

relativeThreshold

Relative threshold value, relevant only in the EThresholdMode.Relative mode.

from_

Lower bound of the analyzed gray-level range.

to

Upper bound of the analyzed gray-level range.

Remarks

Additionally, returns the average gray levels in the regions below and above the threshold. The threshold level can be computed by analyzing a range of gray levels in the histogram.