char_thresholdchar_thresholdCharThresholdCharThresholdchar_threshold (Operator)

Name

char_thresholdchar_thresholdCharThresholdCharThresholdchar_threshold — Segmentieren mit Schwellen für Texte.

Signatur

char_threshold(Image, HistoRegion : Characters : Sigma, Percent : Threshold)

Beschreibung

char_thresholdchar_thresholdCharThresholdCharThresholdchar_threshold 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 HistoRegionHistoRegionHistoRegionhistoRegionhisto_region 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_thresholdBinaryThresholdBinaryThresholdbinary_threshold (mit MethodMethodMethodmethodmethod='smooth_histo'"smooth_histo""smooth_histo""smooth_histo""smooth_histo") 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_thresholdCharThresholdCharThresholdchar_threshold annimmt, dass die Schriftzeichen dunkler sind als der Hintergrund, wird der Schwellenwert links vom Maximum gesucht.

Im Vergleich zu binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdbinary_threshold sollte char_thresholdchar_thresholdCharThresholdCharThresholdchar_threshold 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) → object (byte)

Eingabebild.

HistoRegionHistoRegionHistoRegionhistoRegionhisto_region (input_object) region → object

Region, in der das Histogramm berechnet wird.

CharactersCharactersCharacterscharacterscharacters (output_object) region(-array) → object

Dunkle Bereiche des Bildes (Buchstaben).

SigmaSigmaSigmasigmasigma (input_control) number → (real)

Sigma für Glättung des Histogramms.

Default: 2.0

Wertevorschläge: 0.0, 0.5, 1.0, 2.0, 3.0, 4.0, 5.0

Wertebereich: 0.0 ≤ Sigma Sigma Sigma sigma sigma ≤ 50.0 (lin)

Minimale Schrittweite: 0.01

Empfohlene Schrittweite: 0.2

PercentPercentPercentpercentpercent (input_control) number → (real / integer)

Prozentwert für Grauwertunterschied.

Default: 95

Wertevorschläge: 90, 92, 95, 96, 97, 98, 99, 99.5, 100

Wertebereich: 0.0 ≤ Percent Percent Percent percent percent ≤ 100.0 (lin)

Minimale Schrittweite: 0.1

Empfohlene Schrittweite: 0.5

ThresholdThresholdThresholdthresholdthreshold (output_control) integer(-array) → (integer)

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 (C++)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main (int argc, char *argv[])
{
  if (argc != 2)
  {
    cout << "Usage : " << argv[0] << " 'image' " << endl;
    return -1;
  }

  HImage       image(argv[1]);
  HWindow      w;
  HTuple       threshold;

  w.SetDraw("margin");
  w.SetShape("rectangle1");
  w.SetColored(12);

  image.Display(w);

  HRegionArray reg = image.CharThreshold(image,0,5,&threshold);
  HRegionArray con = reg.Connection();

  cout << "Display image after CharThreshold segmentation " << endl;
  con.Display(w);
  w.Click();

  return 0;
}

Beispiel (HDevelop)

read_image (Image, 'letters')
char_threshold (Image, Image, Seg, 0.0, 5.0, Threshold)
connection (Seg, Connected)

Vorgänger

anisotropic_diffusionanisotropic_diffusionAnisotropicDiffusionAnisotropicDiffusionanisotropic_diffusion, median_imagemedian_imageMedianImageMedianImagemedian_image, illuminateilluminateIlluminateIlluminateilluminate

Nachfolger

connectionconnectionConnectionConnectionconnection, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, select_grayselect_graySelectGraySelectGrayselect_gray

Alternativen

binary_thresholdbinary_thresholdBinaryThresholdBinaryThresholdbinary_threshold, auto_thresholdauto_thresholdAutoThresholdAutoThresholdauto_threshold, gray_histogray_histoGrayHistoGrayHistogray_histo, smooth_funct_1d_gausssmooth_funct_1d_gaussSmoothFunct1dGaussSmoothFunct1dGausssmooth_funct_1d_gauss, thresholdthresholdThresholdThresholdthreshold

Modul

Foundation

Operatoren