segment_charactersT_segment_charactersSegmentCharactersSegmentCharacters (Operator)

Name

segment_charactersT_segment_charactersSegmentCharactersSegmentCharacters — Segmentieren von Zeichen in einem gegebenen Bildbereich.

Signatur

segment_characters(Region, Image : ImageForeground, RegionForeground : Method, EliminateLines, DotPrint, StrokeWidth, CharWidth, CharHeight, ThresholdOffset, Contrast : UsedThreshold)

Herror T_segment_characters(const Hobject Region, const Hobject Image, Hobject* ImageForeground, Hobject* RegionForeground, const Htuple Method, const Htuple EliminateLines, const Htuple DotPrint, const Htuple StrokeWidth, const Htuple CharWidth, const Htuple CharHeight, const Htuple ThresholdOffset, const Htuple Contrast, Htuple* UsedThreshold)

void SegmentCharacters(const HObject& Region, const HObject& Image, HObject* ImageForeground, HObject* RegionForeground, const HTuple& Method, const HTuple& EliminateLines, const HTuple& DotPrint, const HTuple& StrokeWidth, const HTuple& CharWidth, const HTuple& CharHeight, const HTuple& ThresholdOffset, const HTuple& Contrast, HTuple* UsedThreshold)

HImage HRegion::SegmentCharacters(const HImage& Image, HRegion* RegionForeground, const HString& Method, const HString& EliminateLines, const HString& DotPrint, const HString& StrokeWidth, const HTuple& CharWidth, const HTuple& CharHeight, Hlong ThresholdOffset, Hlong Contrast, HTuple* UsedThreshold) const

HImage HRegion::SegmentCharacters(const HImage& Image, HRegion* RegionForeground, const HString& Method, const HString& EliminateLines, const HString& DotPrint, const HString& StrokeWidth, const HTuple& CharWidth, const HTuple& CharHeight, Hlong ThresholdOffset, Hlong Contrast, Hlong* UsedThreshold) const

HImage HRegion::SegmentCharacters(const HImage& Image, HRegion* RegionForeground, const char* Method, const char* EliminateLines, const char* DotPrint, const char* StrokeWidth, const HTuple& CharWidth, const HTuple& CharHeight, Hlong ThresholdOffset, Hlong Contrast, Hlong* UsedThreshold) const

HImage HRegion::SegmentCharacters(const HImage& Image, HRegion* RegionForeground, const wchar_t* Method, const wchar_t* EliminateLines, const wchar_t* DotPrint, const wchar_t* StrokeWidth, const HTuple& CharWidth, const HTuple& CharHeight, Hlong ThresholdOffset, Hlong Contrast, Hlong* UsedThreshold) const   (Nur Windows)

static void HOperatorSet.SegmentCharacters(HObject region, HObject image, out HObject imageForeground, out HObject regionForeground, HTuple method, HTuple eliminateLines, HTuple dotPrint, HTuple strokeWidth, HTuple charWidth, HTuple charHeight, HTuple thresholdOffset, HTuple contrast, out HTuple usedThreshold)

HImage HRegion.SegmentCharacters(HImage image, out HRegion regionForeground, string method, string eliminateLines, string dotPrint, string strokeWidth, HTuple charWidth, HTuple charHeight, int thresholdOffset, int contrast, out HTuple usedThreshold)

HImage HRegion.SegmentCharacters(HImage image, out HRegion regionForeground, string method, string eliminateLines, string dotPrint, string strokeWidth, HTuple charWidth, HTuple charHeight, int thresholdOffset, int contrast, out int usedThreshold)

Beschreibung

Dieser Operator wird verwendet, um Zeichen aus einer RegionRegionRegionRegionregion im Bild ImageImageImageImageimage zu segmentieren. RegionRegionRegionRegionregion wird lediglich zum Einschränken des Verarbeitungsbereiches verwendet. Die segmentierten Zeichen werden in RegionForegroundRegionForegroundRegionForegroundRegionForegroundregionForeground zurückgeliefert.

Es stehen zwei unterschiedliche Methoden zur Verfügung, um die Zeichen zu detektieren. Beide Methoden gehen davon aus, dass die Zeichen dunkler als der Hintergrund sind. Sollte dies nicht zutreffen, dann sollte das Bild mittels invert_imageinvert_imageInvertImageInvertImageInvertImage invertiert werden.

Der Parameter MethodMethodMethodMethodmethod bestimmt den Algorithmus der zur Segmentation des Textes verwendet wird. Die möglichen Werte sind

'local_contrast_best'

Diese Methode extrahiert Text, der lokal von seinem Hintergrund abweicht. Aus diesem Grund eignet er sich für inhomogen beleuchtete Bilder. Die Hervorhebung der Textränder führt zu einer genaueren Bestimmung des Textes. Dies ist vor allem dann nützlich, wenn der Hintergrund sehr texturiert ist. Der Parameter ContrastContrastContrastContrastcontrast definiert den minimalen Kontrast, also die minimale Grauwertdifferenz zwischen dem Text und dem Hintergrund. Das Verhalten dieses Segmentationsverfahrens ist mit dem von var_thresholdvar_thresholdVarThresholdVarThresholdVarThreshold und dem Setzen von LightDark auf 'dark'"dark""dark""dark""dark" identisch.

'local_auto_shape'

Der minimale Kontrast wird automatisch so geschätzt, dass die Zahl der winzigen Regionen reduziert wird. Dieses Verfahren ist besonders für verrauschte Bilder geeignet. Der Parameter ThresholdOffsetThresholdOffsetThresholdOffsetThresholdOffsetthresholdOffset kann zum Anpassen des Schwellwerts verwendet werden. Sei g(x,y) der Grauwert des Eingabebildes ImageImageImageImageimage an der Position (x,y), dann wird die Schwellwertbedingung bestimmt durch:

g(x,y) <= UsedThresholdUsedThresholdUsedThresholdUsedThresholdusedThreshold + ThresholdOffsetThresholdOffsetThresholdOffsetThresholdOffsetthresholdOffset.

Falls zusätzlich zu den Zeichen horizontale oder vertikale Linien in Richtung der Textzeilen segmentiert werden, so sollte EliminateLinesEliminateLinesEliminateLinesEliminateLineseliminateLines auf 'true'"true""true""true""true" gesetzt werden. Das Entfernen der Linien wird durch den maximalen Wert von CharWidthCharWidthCharWidthCharWidthcharWidth und den maximalen Wert von CharHeightCharHeightCharHeightCharHeightcharHeight beeinflusst. Weitere Informationen findet man in deren Parameterbeschreibungen.

DotPrintDotPrintDotPrintDotPrintdotPrint: Sollte auf 'true'"true""true""true""true" gesetzt werden, wenn Dot-Prints gelesen werden sollen, ansonsten auf 'false'"false""false""false""false".

StrokeWidthStrokeWidthStrokeWidthStrokeWidthstrokeWidth: Spezifiziert die Strichstärke des Textes und wird zur Bestimmung von Filtergrößen für die Zeichendetektion verwendet. Die Filtergrößen werden auch durch die Parameter DotPrintDotPrintDotPrintDotPrintdotPrint, die durchschnittliche Zeichenbreite CharWidthCharWidthCharWidthCharWidthcharWidth und die durchschnittliche Zeichenhöhe CharHeightCharHeightCharHeightCharHeightcharHeight festgelegt.

CharWidthCharWidthCharWidthCharWidthcharWidth: Dieser Parameter kann durch ein Tupel, welches bis zu drei Werten besitzen kann, gesetzt werden. Der erste Wert ist die durchschnittliche Breite, der zweite ist die minimale und der dritte die maximale Zeichenbreite. Wenn die minimale Zeichenbreite auf -1 gesetzt wird, berechnet der Operator den Wert automatisch in Abhängigkeit von der durchschnittlichen Zeichenbreite. Das gleiche gilt für den Fall, dass der maximale Wert nicht gesetzt wird. Einige Beispiele:

[10] setzt die durchschnittliche Zeichenbreite auf 10, die minimale und maximale Zeichenbreite werden vom Operator berechnet.

[10,-1,20] setzt die durchschnittliche Zeichenbreite auf 10, der minimale Wert wird vom Operator bestimmt und der maximale Wert auf 20 gesetzt.

[10,5,20] setzt die durchschnittliche Zeichenbreite auf 10, der minimale Wert wird auf 5 und der maximale Wert auf 20 gesetzt.

CharHeightCharHeightCharHeightCharHeightcharHeight: Dieser Parameter kann durch ein Tupel, welches bis zu drei Werten besitzen kann, gesetzt werden. Der erste Wert ist die durchschnittliche Höhe, der zweite ist die minimale und der dritte die maximale Zeichenhöhe. Wenn die minimale Zeichenhöhe auf -1 gesetzt wird, berechnet der Operator den Wert automatisch in Abhängigkeit von der durchschnittlichen Zeichenhöhe. Das gleiche gilt für den Fall, dass der maximale Wert nicht gesetzt wird. Einige Beispiele:

[10] setzt die durchschnittliche Zeichenhöhe auf 10, die minimale und maximale Zeichenhöhe werden vom Operator berechnet.

[10,-1,20] setzt die durchschnittliche Zeichenhöhe auf 10, der minimale Wert wird vom Operator bestimmt und der maximale Wert auf 20 gesetzt.

[10,5,20] setzt die durchschnittliche Zeichenhöhe auf 10, der minimale Wert wird auf 5 und der maximale Wert auf 20 gesetzt.

ThresholdOffsetThresholdOffsetThresholdOffsetThresholdOffsetthresholdOffset: Hiermit kann der Schwellwert angepasst werden, der verwendet wird, wenn die Segmentierungsmethode MethodMethodMethodMethodmethod auf den Wert 'local_auto_shape'"local_auto_shape""local_auto_shape""local_auto_shape""local_auto_shape" gesetzt wurde.

ContrastContrastContrastContrastcontrast: Definiert den minimalen Kontrast zwischen dem Text und dem Hintergrund. Dieser Parameter wird verwendet, wenn MethodMethodMethodMethodmethod auf 'local_contrast_best'"local_contrast_best""local_contrast_best""local_contrast_best""local_contrast_best" gesetzt wurde.

UsedThresholdUsedThresholdUsedThresholdUsedThresholdusedThreshold: Dieser Parameter enthält nach der Ausführung den Schwellwert, der zur Segmentierung der Zeichen verwendet wurde.

ImageForegroundImageForegroundImageForegroundImageForegroundimageForeground enthält das Bild, das intern für die Segmentierung verwendet wurde.

Ausführungsinformationen

Parameter

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHobject

Bildbereich mit den Textzeilen.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / uint2)

Eingabebild.

ImageForegroundImageForegroundImageForegroundImageForegroundimageForeground (output_object)  image(-array) objectHImageHImageHobject * (byte / uint2)

Zur Segmentierung verwendetes Bild.

RegionForegroundRegionForegroundRegionForegroundRegionForegroundregionForeground (output_object)  singlechannelregion(-array) objectHRegionHRegionHobject *

Region der Zeichen.

MethodMethodMethodMethodmethod (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Methode zum Segmentieren der Textzeichen.

Defaultwert: 'local_auto_shape' "local_auto_shape" "local_auto_shape" "local_auto_shape" "local_auto_shape"

Werteliste: 'local_auto_shape'"local_auto_shape""local_auto_shape""local_auto_shape""local_auto_shape", 'local_contrast_best'"local_contrast_best""local_contrast_best""local_contrast_best""local_contrast_best"

EliminateLinesEliminateLinesEliminateLinesEliminateLineseliminateLines (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Entfernen von horizontalen and vertikalen Linien?

Defaultwert: 'false' "false" "false" "false" "false"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

DotPrintDotPrintDotPrintDotPrintdotPrint (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Sollen Dot-Print-Zeichen detektiert werden?

Defaultwert: 'false' "false" "false" "false" "false"

Werteliste: 'false'"false""false""false""false", 'true'"true""true""true""true"

StrokeWidthStrokeWidthStrokeWidthStrokeWidthstrokeWidth (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Strichstärke der Zeichen.

Defaultwert: 'medium' "medium" "medium" "medium" "medium"

Werteliste: 'bold'"bold""bold""bold""bold", 'light'"light""light""light""light", 'medium'"medium""medium""medium""medium", 'ultra_light'"ultra_light""ultra_light""ultra_light""ultra_light"

CharWidthCharWidthCharWidthCharWidthcharWidth (input_control)  integer-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Breite eines Zeichens.

Defaultwert: 25

Typischer Wertebereich: 1 ≤ CharWidth CharWidth CharWidth CharWidth charWidth

Restriktion: CharWidth >= 1

CharHeightCharHeightCharHeightCharHeightcharHeight (input_control)  integer-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Höhe eines Zeichens.

Defaultwert: 25

Typischer Wertebereich: 1 ≤ CharHeight CharHeight CharHeight CharHeight charHeight

Restriktion: CharHeight >= 1

ThresholdOffsetThresholdOffsetThresholdOffsetThresholdOffsetthresholdOffset (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Wert zur Anpassung der Segmentierung.

Defaultwert: 0

ContrastContrastContrastContrastcontrast (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Minimale Grauwertdifferenz zwischen Text und Hintergrund.

Defaultwert: 10

Typischer Wertebereich: 1 ≤ Contrast Contrast Contrast Contrast contrast

Restriktion: Contrast >= 1

UsedThresholdUsedThresholdUsedThresholdUsedThresholdusedThreshold (output_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Verwendete Schwellwert zur Segmentierung der Zeichen.

Beispiel (HDevelop)

for Index := 1 to 5 by 1
  read_image (Image, 'dot_print_rotated/dot_print_rotated_'+Index$'02d')
  text_line_orientation (Image, Image, 50, rad(-30), rad(30), OrientationAngle)
  rotate_image (Image, ImageRotate, deg(-OrientationAngle), 'constant')
  segment_characters (ImageRotate, ImageRotate, ImageForeground, \
                      RegionForeground, 'local_auto_shape', 'false', 'false', 'medium', \
                      25, 25, 0, 10, UsedThreshold)
endfor

Ergebnis

Sind die Eingabeparameter korrekt besetzt, dann liefert segment_characterssegment_charactersSegmentCharactersSegmentCharactersSegmentCharacters den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

text_line_orientationtext_line_orientationTextLineOrientationTextLineOrientationTextLineOrientation

Nachfolger

select_charactersselect_charactersSelectCharactersSelectCharactersSelectCharacters, connectionconnectionConnectionConnectionConnection

Alternativen

thresholdthresholdThresholdThresholdThreshold

Modul

Foundation