char_thresholdchar_thresholdCharThresholdCharThreshold (Operator)
Name
char_thresholdchar_thresholdCharThresholdCharThreshold — Segmentieren mit Schwellen für Texte.
Signatur
Herror char_threshold(const Hobject Image, const Hobject HistoRegion, Hobject* Characters, double Sigma, double Percent, Hlong* Threshold)
Herror T_char_threshold(const Hobject Image, const Hobject HistoRegion, Hobject* Characters, const Htuple Sigma, const Htuple Percent, Htuple* Threshold)
void CharThreshold(const HObject& Image, const HObject& HistoRegion, HObject* Characters, const HTuple& Sigma, const HTuple& Percent, HTuple* Threshold)
HRegion HImage::CharThreshold(const HRegion& HistoRegion, double Sigma, const HTuple& Percent, HTuple* Threshold) const
HRegion HImage::CharThreshold(const HRegion& HistoRegion, double Sigma, double Percent, Hlong* Threshold) const
static void HOperatorSet.CharThreshold(HObject image, HObject histoRegion, out HObject characters, HTuple sigma, HTuple percent, out HTuple threshold)
HRegion HImage.CharThreshold(HRegion histoRegion, double sigma, HTuple percent, out HTuple threshold)
HRegion HImage.CharThreshold(HRegion histoRegion, double sigma, double percent, out int threshold)
Beschreibung
char_thresholdchar_thresholdCharThresholdCharThresholdCharThreshold ist darauf spezialisiert, in einkanaligen Bildern
dunkle Schriftzeichen von hellem Hintergrund zu segmentieren. Die
Vorgehensweise ist dabei wie folgt: Zuerst wird das Histogramm der Grauwerte
des Bildes ImageImageImageImageimage für die Punkte der Region HistoRegionHistoRegionHistoRegionHistoRegionhistoRegion
ermittelt und zur Rauschunterdrückung mit einer Gaußmaske (Parameter
SigmaSigmaSigmaSigmasigma) geglättet. In diesem Histogramm kennzeichnet das Maximum
den Hintergrund (weißes Papier), während die Schriftzeichen ein kleines
lokales Maximum bei niedrigen Grauwerten verursachen. Im Gegensatz zum
Operator binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdBinaryThreshold wird nun nicht nach dem Minimum zwischen den
beiden Maxima gesucht; der Schwellenwert wird stattdessen in Relation zum
Maximum des Histogramms, also zum Hintergrund, nach folgender Bedingung
bestimmt:
Histogramm[Schwellenwert] * 100.0 < Histogramm[Maximum] * (100.0 - PercentPercentPercentPercentpercent)
Falls z.B. PercentPercentPercentPercentpercent = 95 gewählt wird, sucht der Operator den
Grauwert, dessen Häufigkeit höchstens 5 Prozent der maximalen Häufigkeit
beträgt. Da char_thresholdchar_thresholdCharThresholdCharThresholdCharThreshold annimmt, dass die Schriftzeichen
dunkler sind als der Hintergrund, wird der Schwellenwert links vom
Maximum gesucht.
Im Vergleich zu binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdBinaryThreshold sollte char_thresholdchar_thresholdCharThresholdCharThresholdCharThreshold dann
eingesetzt werden, wenn kein deutliches Minimum zwischen den beiden zu den
Schriftzeichen bzw. zum Hintergrund gehörenden Maxima besteht oder die
Schriftzeichen gar kein lokales Maximum verursachen. Dies tritt z.B. bei
ungleichmäßiger Beleuchtung auf, oder wenn das Bild nur wenige
Schriftzeichen enthält.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf Tupelebene.
- Automatisch parallelisiert auf interner Datenebene.
Parameter
ImageImageImageImageimage (input_object) singlechannelimage(-array) → objectHImageHImageHobject (byte)
Eingabebild.
HistoRegionHistoRegionHistoRegionHistoRegionhistoRegion (input_object) region → objectHRegionHRegionHobject
Region, in der das Histogramm berechnet wird.
CharactersCharactersCharactersCharacterscharacters (output_object) region(-array) → objectHRegionHRegionHobject *
Dunkle Bereiche des Bildes (Buchstaben).
SigmaSigmaSigmaSigmasigma (input_control) number → HTupleHTupleHtuple (real) (double) (double) (double)
Sigma für Glättung des Histogramms.
Defaultwert: 2.0
Wertevorschläge: 0.0, 0.5, 1.0, 2.0, 3.0, 4.0, 5.0
Typischer Wertebereich: 0.0
≤
Sigma
Sigma
Sigma
Sigma
sigma
≤
50.0 (lin)
Minimale Schrittweite: 0.01
Empfohlene Schrittweite: 0.2
PercentPercentPercentPercentpercent (input_control) number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Prozentwert für Grauwertunterschied.
Defaultwert: 95
Wertevorschläge: 90, 92, 95, 96, 97, 98, 99, 99.5, 100
Typischer Wertebereich: 0.0
≤
Percent
Percent
Percent
Percent
percent
≤
100.0 (lin)
Minimale Schrittweite: 0.1
Empfohlene Schrittweite: 0.5
ThresholdThresholdThresholdThresholdthreshold (output_control) integer(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Verwendeter Schwellenwert.
Beispiel (HDevelop)
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
Beispiel (C)
read_image(&Image,"letters");
char_threshold(Image,Image,&Seg,0.0,5.0,&Threshold);
connection(Seg,&Connected);
set_colored(WindowHandle,12);
set_shape(WindowHandle,"rectangle1");
disp_region(Connected,WindowHandle);
Beispiel (HDevelop)
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
Beispiel (HDevelop)
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
Beispiel (HDevelop)
read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)
Vorgänger
anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionAnisotropicDiffusion,
median_imagemedian_imageMedianImageMedianImageMedianImage,
illuminateilluminateIlluminateIlluminateIlluminate
Nachfolger
connectionconnectionConnectionConnectionConnection,
select_shapeselect_shapeSelectShapeSelectShapeSelectShape,
select_grayselect_graySelectGraySelectGraySelectGray
Alternativen
binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdBinaryThreshold,
auto_thresholdauto_thresholdAutoThresholdAutoThresholdAutoThreshold,
gray_histogray_histoGrayHistoGrayHistoGrayHisto,
smooth_funct_1d_gausssmooth_funct_1d_gaussSmoothFunct1dGaussSmoothFunct1dGaussSmoothFunct1dGauss,
thresholdthresholdThresholdThresholdThreshold
Modul
Foundation