bin_thresholdbin_thresholdBinThresholdBinThresholdbin_threshold (Operator)
Name
bin_thresholdbin_thresholdBinThresholdBinThresholdbin_threshold — Segment an image using an automatically determined
threshold.
Warning
bin_thresholdbin_thresholdBinThresholdBinThresholdBinThresholdbin_threshold is obsolete and is only provided for
reasons of backward compatibility. New applications should use
the operator binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdBinaryThresholdbinary_threshold instead.
Signature
Herror bin_threshold(const Hobject Image, Hobject* Region)
Herror T_bin_threshold(const Hobject Image, Hobject* Region)
def bin_threshold(image: HObject) -> HObject
Description
bin_thresholdbin_thresholdBinThresholdBinThresholdBinThresholdbin_threshold segments a single-channel gray value image
using an automatically determined threshold. First, the relative
histogram of the gray values is determined. Then, relevant minima
are extracted from the histogram, which are used as parameters for a
thresholding operation. In order to reduce the number of minima,
the histogram is smoothed with a Gaussian, as in
auto_thresholdauto_thresholdAutoThresholdAutoThresholdAutoThresholdauto_threshold. The mask size is enlarged until there
is only one minimum in the smoothed histogram. The selected region
contains the pixels with gray values from 0 to the minimum or for real images
from the smallest value to the respective minimum. This
operator is, for example useful for the segmentation of dark
characters on a light paper.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on internal data level.
Parameters
ImageImageImageImageimageimage (input_object) singlechannelimage(-array) → objectHImageHObjectHImageHobject (byte / uint2 / real)
Input image.
RegionRegionRegionRegionregionregion (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Dark regions of the image.
Example (HDevelop)
read_image (Image, 'letters')
bin_threshold (Image, Seg)
connection (Seg, Connected)
Example (C)
read_image(&Image,"letters");
bin_threshold(Image,&Seg);
connection(Seg,&Connected);
set_shape(WindowHandle,"rectangle1");
set_colored(WindowHandle,6);
disp_region(Connected,WindowHandle);
Example (HDevelop)
read_image (Image, 'letters')
bin_threshold (Image, Seg)
connection (Seg, Connected)
Example (HDevelop)
read_image (Image, 'letters')
bin_threshold (Image, Seg)
connection (Seg, Connected)
Example (HDevelop)
read_image (Image, 'letters')
bin_threshold (Image, Seg)
connection (Seg, Connected)
Module
Foundation