Region-Objekt (IRegion-Schnittstelle)

Region-Objekt (IRegion-Schnittstelle) in der ABBYY FineReader Engine API — zusätzliches Objekt zum Speichern der Region eines FineReader Engine-Blocks als Menge nicht überlappender Rectangles in der Reihenfolge von links nach rechts oder von oben nach unten.

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.

​

Zugehörige Objekte

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