Region-Objekt (IRegion-Schnittstelle)

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:

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

Name	Typ	Beschreibung
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.
Bottom	int, nur lesbar	Gibt die Koordinate der unteren Begrenzung des angegebenen Rectangle zurück.
BoundingRectangle	FRRectangle, nur lesbar	Gibt das kleinste Rectangle zurück, das die gesamte Region enthält.
Count	int, nur lesbar	Enthält die Anzahl der Rectangles in der Region.
IsEmpty	VARIANT_BOOL, nur lesbar	Gibt an, ob die Region leer ist.
Left	int, nur lesbar	Gibt die Koordinate der linken Begrenzung des angegebenen Rectangle zurück.
Right	int, nur lesbar	Gibt die Koordinate der rechten Begrenzung des angegebenen Rectangle zurück.
Top	int, nur lesbar	Gibt die Koordinate der oberen Begrenzung des angegebenen Rectangle zurück.

Methoden

Name	Beschreibung
AddRect	Fügt der Region einen Bereich hinzu.
AddRegion	Fügt einer vorhandenen Region einen neuen Bereich hinzu.
CopyFrom	Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten der entsprechenden Eigenschaften eines anderen Objekts.
CutRect	Schneidet einen rechteckigen Bereich aus einer Region aus.
HasIntersectionWithRect	Ermittelt, ob sich die Region mit dem angegebenen Rectangle überschneidet.
HasIntersectionWithRegion	Ermittelt, ob sich die Region mit der angegebenen Region überschneidet.
IsEqual	Ermittelt, ob die Region mit der angegebenen Region identisch ist.
IsPointInRegion	Ermittelt, ob sich der angegebene Point innerhalb der Region befindet.
IsRectInRegion	Ermittelt, ob das angegebene Rectangle in der Region enthalten ist.
IsRegionInRegion	Ermittelt, ob die angegebene Region in der Region enthalten ist.
LoadFromFile	Stellt den Inhalt des Objekts aus einer Datei auf dem Datenträger wieder her.
LoadFromMemory Hinweis: Nur Windows.	Stellt den Inhalt des Objekts aus dem globalen Speicher wieder her.
MakeEmpty	Entfernt alle Rectangles aus der Region.
SaveToFile	Speichert den Inhalt des Objekts in einer Datei auf dem Datenträger.
SaveToMemory Hinweis: Nur Windows.	Speichert den Inhalt des Objekts im globalen Speicher.

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:

AnalyzeRegion, SynthesizeBusinessCard, SynthesizeBusinessCardEx Methoden des FRPage-Objekts
RemoveColorObjects, RemoveMotionBlur, RemoveGarbage, SmoothImage, SaveImageRegionTo Methoden des ImageDocument-Objekts
AddNew Methode des CheckmarkGroup-Objekts
AddNew Methode des SeparatorGroup-Objekts
Add, InsertAt Methoden des RegionsCollection-Objekts
SetImageData Methode des TrainingImage-Objekts
AddClipRegion, AddInvertRegion, AddPaintRegion, AddReplaceBlackPixelsRegion, AddReplaceWhitePixelsRegion Methoden des ImageModification-Objekts
Für Windows Visual Components:
- OnAnalyzeRegion, OnToolChangeBlockRegion Methoden der IImageViewerEvents-Schnittstelle
- OnAnalyzeRegion, OnToolChangeBlockRegion Methoden der IZoomViewerEvents-Schnittstelle

Beispiele

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

Siehe auch

Arbeiten mit Eigenschaften

Overview

Functions

Engine Object (IEngine Interface)

Engine Loaders

Image-Related Objects

Layout-Related Objects

Language-Related Objects

Text-Related Objects

Document-Related Objects

Batch Processor

Mechanism Objects

Parameter Objects

Classification-Related Objects

License-Related Objects

Document Comparison Objects

Supplementary Objects and Methods

Enumerations

Region-Objekt (IRegion-Schnittstelle)

Eigenschaften

Methoden

Output-Parameter

Eingabeparameter

Beispiele

Siehe auch

​Eigenschaften

​Methoden

​Zugehörige Objekte

​Output-Parameter

​Eingabeparameter

​Beispiele

​Siehe auch

Eigenschaften

Methoden

Zugehörige Objekte

Output-Parameter

Eingabeparameter

Beispiele

Siehe auch