Objet PrepareImageMode (interface IPrepareImageMode)

Objet PrepareImageMode (interface IPrepareImageMode) dans l’API ABBYY FineReader Engine — Attributs contrôlant la manière dont une image est préparée lors de la conversion au format interne (rotation d’abord, puis mise en miroir) ; objet persistant pouvant être enregistré dans un fichier ou en mémoire.

Cet objet contient différents attributs qui définissent comment une image sera préparée lors de la conversion au format interne. Toutes les propriétés d’un objet de ce type nouvellement créé sont définies sur des valeurs par défaut appropriées. Pour connaître la valeur par défaut de telle ou telle propriété, consultez sa description. La séquence des transformations appliquées à l’image préparée est la suivante : la rotation est d’abord effectuée, puis l’image est mise en miroir.

L’objet PrepareImageMode 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 relisant son état à partir de 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	Renvoie l’objet Engine.
CompressImageMode	CompressImageModeEnum	Indique si l’image doit être compressée lors de sa conversion au format interne. S’applique uniquement aux images en couleur et en gris ; les images en noir et blanc sont toujours compressées sans perte. Par défaut, cette propriété est définie sur CIM_Auto, ce qui signifie actuellement que les images nativement numériques (par ex. issues de fichiers PDF) utiliseront une compression sans perte, tandis que les autres images utiliseront la compression maximale.
DocumentType	DocumentTypeEnum	Indique le type du document présent sur l’image. Si vous connaissez avec certitude le type de document, vous pouvez définir cette propriété pour contourner le classificateur de documents et gagner du temps. Par défaut, cette propriété est DT_Auto, ce qui signifie que FineReader Engine doit exécuter le classificateur de documents pour déterminer le type de document.
ImageSourceType	ImageSourceTypeEnum	Indique l’origine de l’image. Par exemple, une photo et une capture d’écran contenant du texte nécessitent des techniques de prétraitement différentes. Par défaut, cette propriété est IST_Auto, ce qui signifie que FineReader Engine doit détecter automatiquement l’origine de l’image.
OfficeConversionSettings	OfficeConversionSettings, lecture seule	Donne accès aux paramètres d’importation des documents numériques à l’aide des mêmes méthodes que celles utilisées pour ouvrir les images. Linux et Windows uniquement.
EnforceOwnerRestrictions	VARIANT_BOOL	Indique si les restrictions du propriétaire (autorisations) déclarées dans un document PDF sont appliquées. Les documents PDF peuvent contenir des indicateurs d’autorisation qui limitent certaines opérations sans nécessiter de mot de passe pour ouvrir le fichier. Lorsqu’elle est définie sur TRUE (par défaut), l’Engine applique ces restrictions et renvoie une erreur si elles sont présentes. Lorsqu’elle est définie sur FALSE, les restrictions sont ignorées et le document est traité normalement. Définissez cette propriété sur FALSE uniquement si votre application est déjà autorisée à traiter les fichiers soumis.
RasterizeFreeText	VARIANT_BOOL	Indique si les annotations Free Text du document PDF d’entrée doivent être conservées. Par défaut, cette propriété est définie sur TRUE. Linux et Windows uniquement. Sous Linux, avant d’utiliser cette propriété, assurez-vous que la police Arial ou Liberation Sans est disponible sur votre poste de travail.

​

Méthodes

Nom	Description
CopyFrom	Initialise les propriétés de l’objet courant avec les valeurs des propriétés correspondantes d’un autre objet.
LoadFromFile	Restaure le contenu de l’objet à partir d’un fichier sur disque.
LoadFromMemory	Restaure le contenu de l’objet à partir de la mémoire globale. Windows uniquement.
SaveToFile	Enregistre le contenu de l’objet dans un fichier sur disque.
SaveToMemory	Enregistre le contenu de l’objet dans la mémoire globale. Windows uniquement.

​

Objets associés

​

Linux et Windows

Diagramme d’objets

​

Paramètre de sortie

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

​

Paramètre d’entrée

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

• les méthodes AddImageFile, AddImageFileFromAttachment, AddImageFileWithPassword, AddImageFileWithPasswordCallback, AddImageFileFromMemory de l’objet FRDocument
• les méthodes CreateFRDocumentFromImage, PrepareBitmapBits, OpenImageFileFromMemory, OpenBitmapBits, OpenBitmap, OpenDib, PrepareBitmap, PrepareDib, InjectTextLayer de l’objet Engine
• la méthode Start de l’objet BatchProcessor sous Linux et Windows

​

Exemples

L’objet est utilisé dans les exemples de code suivants :

• Linux : CommandLineInterface
• Windows : CommandLineInterface ; ainsi que dans Demo Tools : Engine Predefined Processing Profiles

​

Voir aussi

Utilisation des images

Utilisation des propriétés