Zum Hauptinhalt springen
Dies ist ein zusätzliches Objekt. Es dient zum Speichern von Informationen über die Region eines Blocks in ABBYY FineReader Engine. Eine Region wird als eine Menge von Rectangles dargestellt:
  • ohne Schnittpunkte oder Überlappungen positioniert
  • in der Reihenfolge von links nach rechts oder von oben nach unten hinzugefügt
Im Folgenden sind einige Beispiele für Regionen in ABBYY FineReader Engine dargestellt: Regions Ein leeres Region-Objekt kann durch Aufrufen der Methode IEngine::CreateRegion erstellt werden; anschließend können ihm durch Aufrufen der Methode IRegion::AddRect Rectangles einzeln hinzugefügt werden. Wir empfehlen, Rectangles in der Reihenfolge von oben nach unten (oder von links nach rechts) hinzuzufügen, da das Region-Objekt dafür optimiert ist und dies die schnellste Möglichkeit ist, Rectangles hinzuzufügen. Das Region-Objekt ist ein persistentes Objekt. Das bedeutet, dass der aktuelle Zustand des Objekts in einem persistenten Speicher abgelegt werden kann. Später kann das Objekt neu erstellt werden, indem sein Zustand aus dem persistenten Speicher gelesen wird. Die folgenden Methoden ermöglichen die Persistenz des Objekts: Linux: SaveToFile und LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory und LoadFromMemory.

Eigenschaften

NameTypBeschreibung
ApplicationEngine, nur lesbarGibt das Engine-Objekt zurück.
Bottomint, nur lesbarGibt die Koordinate der unteren Begrenzung des angegebenen Rectangle zurück.
BoundingRectangleFRRectangle, nur lesbarGibt das kleinste Rectangle zurück, das die gesamte Region enthält.
Countint, nur lesbarEnthält die Anzahl der Rectangles in der Region.
IsEmptyVARIANT_BOOL, nur lesbarGibt an, ob die Region leer ist.
Leftint, nur lesbarGibt die Koordinate der linken Begrenzung des angegebenen Rectangle zurück.
Rightint, nur lesbarGibt die Koordinate der rechten Begrenzung des angegebenen Rectangle zurück.
Topint, nur lesbarGibt die Koordinate der oberen Begrenzung des angegebenen Rectangle zurück.

Methoden

NameBeschreibung
AddRectFügt der Region einen Bereich hinzu.
AddRegionFügt einer vorhandenen Region einen neuen Bereich hinzu.
CopyFromInitialisiert die Eigenschaften des aktuellen Objekts mit den Werten der entsprechenden Eigenschaften eines anderen Objekts.
CutRectSchneidet einen rechteckigen Bereich aus einer Region aus.
HasIntersectionWithRectErmittelt, ob sich die Region mit dem angegebenen Rectangle überschneidet.
HasIntersectionWithRegionErmittelt, ob sich die Region mit der angegebenen Region überschneidet.
IsEqualErmittelt, ob die Region mit der angegebenen Region identisch ist.
IsPointInRegionErmittelt, ob sich der angegebene Point innerhalb der Region befindet.
IsRectInRegionErmittelt, ob das angegebene Rectangle in der Region enthalten ist.
IsRegionInRegionErmittelt, ob die angegebene Region in der Region enthalten ist.
LoadFromFileStellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory <Note> Nur Windows. </Note>Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
MakeEmptyEntfernt alle Rectangles aus der Region.
SaveToFileSpeichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory <Note> Nur Windows. </Note>Speichert den Inhalt des Objekts im globalen Speicher.
Region Objektdiagramm

Output-Parameter

Dieses Objekt ist der Output-Parameter der Methode CreateRegion des Objekts Engine.

Eingabeparameter

Dieses Objekt wird als Eingabeparameter an die folgenden Methoden übergeben:

Beispiele

Dieses Objekt wird im Codebeispiel zur Visitenkartenerkennung (macOS) verwendet.

Siehe auch

Arbeiten mit Eigenschaften