Passer au contenu principal
Cet objet correspond à une image ouverte, ou « document image ». Ses attributs reflètent ceux d’une image. L’objet ImageDocument est à la racine d’une collection d’objets Image, ou « plans d’image ». Chaque document image comprend 4 « plans d’image » : noir et blanc, gris, couleur et aperçu. Ils sont accessibles via les propriétés correspondantes. L’objet contient un certain nombre de méthodes de prétraitement d’image. Certaines de ces méthodes conviennent uniquement aux photos, d’autres peuvent être utilisées pour tous les types de documents. Certaines méthodes améliorent la qualité de la reconnaissance, d’autres améliorent uniquement le rendu visuel des images, mais peuvent réduire la qualité de la reconnaissance. Ces dernières ne doivent être utilisées qu’après la reconnaissance. Veuillez lire attentivement la description de chaque méthode afin de déterminer si elle peut être utilisée dans votre scénario. Vous trouverez ci-dessous l’ordre dans lequel nous recommandons d’utiliser les méthodes de prétraitement d’image (utilisez uniquement les méthodes de la liste qui conviennent à votre scénario) :
  • Pour améliorer la qualité de la reconnaissance :
    1. Recadrer l’image
    2. Améliorer le contraste local
    3. Corriger l’orientation (utilisez la méthode Transform avec les paramètres nécessaires)
    4. Inverser l’image ou la retourner en miroir (utilisez la méthode Transform avec les paramètres nécessaires)
    5. Corriger l’inclinaison
    6. Scinder une double page (utilisez la méthode SplitPages de l’objet FRDocument)
    7. Supprimer les distorsions géométriques
    8. Supprimer les parasites
    9. Supprimer le bruit
    10. Supprimer le flou de mouvement
    11. Atténuer les objets en couleur
    12. Supprimer les objets en couleur
  • Pour améliorer l’apparence de l’image :
    1. Égaliser la luminosité et rendre le fond blanc
    2. Lisser la texture de l’image
    3. Tramer l’image
Notez que toutes ces méthodes de prétraitement doivent être appliquées à une image ouverte. Certaines modifications de l’image peuvent être appliquées plus tôt, lors de son ouverture. Veuillez consulter la description des objets PrepareImageMode et PagePreprocessingParams pour en savoir plus sur le prétraitement d’image pendant l’ouverture. L’objet ImageDocument est ce que l’on appelle un « connectable object ». Pour Visual Basic dans FRE for Windows, il peut être déclaré avec WithEvents. Pour C++ (sur tous les systèmes d’exploitation pris en charge), cela signifie qu’il prend en charge l’interface IConnectionPointContainer. Pour recevoir des événements de notification pendant le traitement, les utilisateurs C++ doivent créer un objet dérivé de l’interface IImageDocumentEvents et effectuer les opérations suivantes :
  • Sous Linux et macOS : rattacher l’objet à l’objet ImageDocument en appelant la fonction globale AdviseFREngineObject.
  • Sous Windows : configurer la connexion entre l’objet et la source d’événements implémentée dans l’objet ImageDocument à l’aide des mécanismes COM standard.
Sous Windows : les méthodes de l’objet ImageDocument transmettent des informations sur la progression du traitement des pages via des interfaces sortantes spéciales. Ces interfaces sont IImageDocumentEvents (pour C++) et la dispinterface DIImageDocumentEvents (pour Visual Basic). Il convient de noter que les utilisateurs de Visual Basic n’ont pas à se soucier des détails de l’implémentation des interfaces d’événements, car cette plateforme de développement fournit des moyens simples de les gérer.

Propriétés

,lecture seule

Retourne l’objet.

,lecture seule

Donne accès au calque d’imagenoir et blancde l’objet ImageDocument courant.

,lecture seule

Donne accès au calque d’imagecouleurde l’objet ImageDocument courant.

,lecture seule

Donne accès au calque d’imagegrisde l’objet ImageDocument courant.

, lecture seule

Stocke l’identifiant du document image.

, lecture seule

Chaque calque de couleur du document image est caractérisé par son propre type de couleur. Cette propriété définit le type de couleur pour l’ensemble du document image comme le maximum des valeurs correspondantes de ses calques de couleur (noir et blanc, gris, couleur).

, lecture seule

Indique si le document image est stocké uniquement en mémoire ou s’il est également représenté sous forme de dossier sur le disque.

Après l’appel à la méthodeSaveTo, la valeur de cette propriété n’est pas modifiée. Vous devez recharger le document image en appelant la méthodeLoadImageDoc.

, lecture seule

Stocke le chemin vers le dossier contenant la représentation interne de l’objet sur le disque. La propriété contient une chaîne vide si la valeur de la propriété IsInMemory est TRUE.

Après l’appel à la méthodeSaveTo, la valeur de cette propriété n’est pas modifiée. Vous devez recharger le document image en appelant la méthodeLoadImageDoc.

,lecture seule

Retourne l’objetcontenant des informations sur les coordonnées en pixels dans l’état de modification actuel.

Cette propriété est utile lorsque vous devez convertir des coordonnées entre deux états au cours du traitement d’image.

, lecture seule

Indique si des modifications ont été apportées à l’objet ImageDocument depuis son chargement en mémoire ou depuis le dernier appel de la méthode.

, lecture seule

Indique la rotation appliquée à l’image depuis son ouverture.

, lecture seule

Lorsque cette propriété est définie sur TRUE, elle indique que les couleurs de l’image ont été inversées depuis l’ouverture.

, lecture seule

Lorsque cette propriété est définie sur TRUE, elle indique que l’image a été mise en miroir par rapport à l’axe vertical depuis l’ouverture.

, lecture seule

Cette propriété indique si l’inclinaison de l’image a été entièrement corrigée lors de l’ouverture, du prétraitement ou de l’appel de la méthode.

La tangente de l’angle d’inclinaison corrigé est stockée dans la propriété SkewAngle.

, lecture seule

Stocke la tangente de l’angle d’inclinaison détecté pour l’image et corrigé lors de l’ouverture, du prétraitement ou de l’appel de la méthode. Si l’angle d’inclinaison est négatif, l’image est pivotée dans le sens des aiguilles d’une montre ; si l’angle est positif, elle est pivotée dans le sens inverse. L’image peut être pivotée autour de n’importe quel point. La taille de l’image redressée est toujours supérieure à celle de l’image d’origine.

Lorsque vous effectuez d’autres modifications sur l’image, la valeur de cette propriété est réinitialisée à 0. Si vous en avez besoin, enregistrez la valeur de l’angle d’inclinaison corrigé avant d’appeler toute autre méthode de modification de l’image.

, lecture seule

Indique si l’objet ImageDocument a été créé à partir d’un fichier contenant du texte. Par exemple, les fichiers PDF peuvent comporter un calque de texte.

, lecture seule

Indique si l’objet ImageDocument a été créé à partir d’un fichier de type photo.

, lecture seule

Fournit des informations sur le format du fichier image source de l’objet ImageDocument actuel. Si ces informations ne sont pas disponibles ou si l’image provient d’un scanner, la valeur de cette propriété est IFF_UnknownFormat.

, lecture seule

Fournit des informations sur le scanner utilisé pour acquérir l’image. Si les informations sur les paramètres de l’image source ne sont pas disponibles ou si l’image provient d’un fichier, la valeur de cette propriété est une chaîne vide.

, lecture seule

Fournit des informations sur le seuil d’intensité de numérisation de l’objet ImageDocument actuel. Si les informations sur les paramètres de l’image source ne sont pas disponibles ou si l’image a été obtenue à partir d’un fichier, la valeur de cette propriété est -1.

, lecture seule

Fournit des informations sur la résolution horizontale de l’image source de l’objet ImageDocument actuel. Si les informations sur les paramètres de l’image source ne sont pas disponibles, la valeur de cette propriété est 0.

, lecture seule

Fournit des informations sur la résolution verticale de l’image source de l’objet ImageDocument actuel. Si les informations sur les paramètres de l’image source ne sont pas disponibles, la valeur de cette propriété est 0.

Méthodes

NomDescription
ApplySigmaFilterCette méthode applique à l’image un filtre de réduction du bruit. Elle est particulièrement utile pour les photographies.
ChangeResolutionModifie la résolution de l’image.
CorrectShadowsAndHighlightsCorrige les ombres excessives et les zones trop lumineuses de l’image.
CorrectSkewCorrige l’inclinaison de l’image.
CropImageDétecte les contours d’un document dans l’image, puis recadre l’image.
DitherImageApplique à l’image un tramage à l’aide de l’algorithme de Floyd–Steinberg ou de Bayer (ordonné).
EnhanceLocalContrastAugmente le contraste local de l’image.
EqualizeBrightnessÉgalise la luminosité de l’image. Cette méthode ne peut être utilisée qu’avec des images en niveaux de gris et en couleur.
FindBlackSquaresDétecte les carrés noirs dans l’image.
GetPreviewImageDonne accès au plan d’image d’aperçu de 94 * 60 de l’objet ImageDocument actuel. Si l’aperçu de cette taille n’a pas encore été créé, il sera créé lors de cet appel, ce qui prendra un certain temps.
GetPreviewImageSpecificSizeDonne accès au plan d’image d’aperçu de l’objet ImageDocument actuel et permet d’en spécifier la taille. Si l’aperçu de cette taille n’a pas encore été créé, il le sera lors de cet appel, ce qui peut prendre un certain temps.
GetTextBackgroundColorDétecte les couleurs du texte et de l’arrière-plan dans le rectangle spécifié sur l’image.
ModifyPermet de modifier l’image. Cette méthode offre des options de modification plus avancées que la méthode Transform.
RemoveColorObjectsSupprime les objets colorés spécifiés de l’image entière ou de certaines de ses parties. Cette méthode peut être utilisée uniquement pour les images en couleur.
RemoveColorObjectsExSupprime tous les objets colorés des teintes spécifiées de l’image et les remplace par la couleur spécifiée. Les objets supprimés peuvent être enregistrés dans une image distincte.
RemoveGarbageSupprime de l’image les parasites (points superflus inférieurs à une certaine taille).
RemoveGeometricalDistortionsSupprime les distorsions géométriques de l’image (comme les lignes incurvées en bord de page).
RemoveMotionBlurSupprime le flou de bougé de l’image.
RemoveNoiseRéduit le bruit de l’image.
SaveImageRegionToEnregistre les parties de l’image dans un dossier sur le disque. L’image enregistrée est au format interne d’ABBYY FineReader Engine.
SaveModifiedEnregistre toutes les modifications apportées à l’objet ImageDocument actuel dans un dossier du disque.
SaveToEnregistre le contenu de l’objet ImageDocument dans un dossier sur le disque. L’image est enregistrée au format interne de ABBYY FineReader Engine.
SaveToFileEnregistre le contenu de l’objet ImageDocument dans un fichier.
SaveToMemory <Note> Windows uniquement. </Note>Enregistre le contenu de l’objet ImageDocument dans la mémoire globale.
SmoothImagePermet de lisser l’image. Cette méthode s’utilise uniquement avec des images en niveaux de gris et en couleur.
SmoothTextureLisse l’image à l’aide d’un filtre non linéaire. Utile pour les images texturées. Cette méthode ne peut être utilisée que pour les images en niveaux de gris et en couleur mesurant au moins 3 pixels dans chaque dimension.
TransformApplique un nombre limité de transformations à l’image.
ImageDocument Diagramme d’objets

Paramètre de sortie

Cet objet est le paramètre de sortie des méthodes suivantes de l’objet Engine : LoadImageDocFromFile, LoadImageDocFromMemory (Windows uniquement), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory.

Paramètre d’entrée

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

Exemples

L’objet est utilisé dans les exemples de code : Linux : CommandLineInterface et BCR macOS : Reconnaissance de cartes de visite Windows : CommandLineInterface ; et outils de démonstration : Profils de traitement prédéfinis d’Engine

Voir aussi

IImageDocumentEvents Utilisation des images Utilisation des objets connectables Utilisation des propriétés