Objet Region (interface IRegion)

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 <Note> Windows uniquement. </Note>	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 <Note> Windows uniquement. </Note>	Enregistre le contenu de l’objet dans la mémoire globale.

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

Vue d’ensemble

Fonctions

Objet Engine (interface IEngine)

Chargeurs de l’Engine

Objets liés aux images

Objets liés à Layout

Objets relatifs à la langue

Objets relatifs au texte

Objets liés au document

Processeur de traitement par lots

Objets du mécanisme

Objets Parameter

Objets liés à la classification

Objets liés à la gestion des licences

Objets de comparaison de documents

Objets et méthodes complémentaires

Énumérations

Propriétés

Méthodes

Paramètre de sortie

Paramètre d’entrée

Exemples

Voir aussi

Vue d’ensemble

Fonctions

Objet Engine (interface IEngine)

Chargeurs de l’Engine

Objets liés aux images

Objets liés à Layout

Objets relatifs à la langue

Objets relatifs au texte

Objets liés au document

Processeur de traitement par lots

Objets du mécanisme

Objets Parameter

Objets liés à la classification

Objets liés à la gestion des licences

Objets de comparaison de documents

Objets et méthodes complémentaires

Énumérations

​Propriétés

​Méthodes

​Objets associés

​Paramètre de sortie

​Paramètre d’entrée

​Exemples

​Voir aussi

Propriétés

Méthodes

Objets associés

Paramètre de sortie

Paramètre d’entrée

Exemples

Voir aussi