Objet Region (interface IRegion)

Objet Region (interface IRegion) dans l’API ABBYY FineReader Engine — Objet auxiliaire stockant la région d’un bloc FineReader Engine sous la forme d’un ensemble de rectangles sans chevauchement dans l’ordre de gauche à droite ou de haut en bas.

Il s’agit d’un objet auxiliaire. Il est conçu pour stocker les informations relatives à la région d’un bloc ABBYY FineReader Engine.

Une région est représentée par un ensemble de rectangles :

• placés sans intersections ni chevauchements
• ajoutés de gauche à droite ou de haut en bas

Quelques exemples de régions dans ABBYY FineReader Engine sont présentés ci-dessous :

Un objet Region vide peut être créé en appelant la méthode IEngine::CreateRegion, puis des rectangles peuvent y être ajoutés un par un en appelant la méthode IRegion::AddRect. Nous vous recommandons d’ajouter les rectangles de haut en bas (ou de gauche à droite), car l’objet Region est optimisé pour cet ordre, et c’est le moyen le plus rapide d’y ajouter des rectangles.

L’objet Region est un objet persistant. Cela signifie que l’état actuel de l’objet peut être enregistré dans un stockage persistant. L’objet peut ensuite être recréé en lisant son état depuis ce stockage persistant. Les méthodes suivantes assurent la persistance de l’objet :

Linux : SaveToFile, et LoadFromFile

Windows : SaveToFile, LoadFromFile, SaveToMemory, et LoadFromMemory.

​

Propriétés

Nom	Type	Description
Application	Engine, lecture seule	Retourne l’objet Engine.
Bottom	int, lecture seule	Retourne la coordonnée du bord inférieur du rectangle spécifié.
BoundingRectangle	FRRectangle, lecture seule	Retourne le plus petit rectangle contenant l’intégralité de la région.
Count	int, lecture seule	Indique le nombre de rectangles dans la région.
IsEmpty	VARIANT_BOOL, lecture seule	Indique si la région est vide.
Left	int, lecture seule	Retourne la coordonnée du bord gauche du rectangle spécifié.
Right	int, lecture seule	Retourne la coordonnée du bord droit du rectangle spécifié.
Top	int, lecture seule	Retourne la coordonnée du bord supérieur du rectangle spécifié.

​

Méthodes

Nom	Description
AddRect	Ajoute une zone à la région.
AddRegion	Ajoute une nouvelle zone à une région existante.
CopyFrom	Initialise les propriétés de l’objet actuel avec les valeurs des propriétés correspondantes d’un autre objet.
CutRect	Découpe une zone rectangulaire de la région.
HasIntersectionWithRect	Détermine si la région est en intersection avec le rectangle spécifié.
HasIntersectionWithRegion	Détermine si la région est en intersection avec la région spécifiée.
IsEqual	Détermine si la région est égale à la région spécifiée.
IsPointInRegion	Détermine si le point spécifié se trouve dans la région.
IsRectInRegion	Détermine si le rectangle spécifié est contenu dans la région.
IsRegionInRegion	Détermine si la région spécifiée est contenue dans la région.
LoadFromFile	Restaure le contenu de l’objet à partir d’un fichier sur le disque.
LoadFromMemory Remarque : Windows uniquement.	Restaure le contenu de l’objet à partir de la mémoire globale.
MakeEmpty	Supprime tous les rectangles de la région.
SaveToFile	Enregistre le contenu de l’objet dans un fichier sur le disque.
SaveToMemory Remarque : Windows uniquement.	Enregistre le contenu de l’objet dans la mémoire globale.

​

Objets associés

Diagramme des objets

​

Paramètre de sortie

Cet objet constitue le paramètre de sortie de la méthode CreateRegion de l’objet Engine.

​

Paramètre d’entrée

Cet objet est passé comme paramètre d’entrée aux méthodes suivantes :

• méthodes AnalyzeRegion, SynthesizeBusinessCard, SynthesizeBusinessCardEx de l’objet FRPage
• méthodes RemoveColorObjects, RemoveMotionBlur, RemoveGarbage, SmoothImage, SaveImageRegionTo de l’objet ImageDocument
• méthode AddNew de l’objet CheckmarkGroup
• méthode AddNew de l’objet SeparatorGroup
• méthodes Add, InsertAt de l’objet RegionsCollection
• méthode SetImageData de l’objet TrainingImage
• méthodes AddClipRegion, AddInvertRegion, AddPaintRegion, AddReplaceBlackPixelsRegion, AddReplaceWhitePixelsRegion de l’objet ImageModification
• Pour les composants visuels Windows :
  • méthodes OnAnalyzeRegion, OnToolChangeBlockRegion de l’interface IImageViewerEvents
  • méthodes OnAnalyzeRegion, OnToolChangeBlockRegion de l’interface IZoomViewerEvents

​

Exemples

Cet objet est utilisé dans l’exemple de code Reconnaissance des cartes de visite (macOS).

​

Voir aussi

Utiliser les propriétés