Objet ImageModification (Interface IImageModification)

Objet ImageModification (interface IImageModification) dans l’API ABBYY FineReader Engine — Stocke les paramètres de modification d’image pour IImageDocument.Modify : régions de recadrage, de peinture, d’inversion, de remplacement des pixels noirs, de remplacement des pixels blancs, de suppression des indésirables, ainsi que l’étirement.

Cet objet est utilisé pour stocker les paramètres de modification d’image. La méthode IImageDocument::Modify, qui permet de modifier une image, ainsi que d’autres méthodes, prend une référence à cet objet comme paramètre d’entrée. L’objet ImageModification permet d’effectuer un large éventail d’opérations sur une image, telles que l’étirement, la définition de régions de recadrage, de régions d’inversion, de régions de peinture, de régions de remplacement de pixels et de régions de suppression des indésirables. La modification de l’image s’effectue comme suit :

• La couleur du texte et la taille des indésirables dans les régions sont déterminées.
• La partie de l’image à l’intérieur des régions de recadrage est extraite.
• Les régions « Paint » sont remplies avec la couleur correspondante.
• Les couleurs à l’intérieur des régions « invert » sont inversées.
• Les points noirs à l’intérieur des régions de « remplacement des pixels noirs » sont remplacés par des points de la couleur correspondante.
• Les points blancs à l’intérieur des régions de remplacement des pixels blancs sont remplacés par des points de la couleur correspondante.
• Les indésirables à l’intérieur des régions « remove garbage » sont supprimés. Cette modification ne peut être appliquée qu’au plan d’image noir et blanc.
• L’image est étirée selon le ratio d’étirement défini par la propriété StretchRatio.

Toutes les régions ajoutées dans cet objet ne doivent pas dépasser les limites du Rectangle de l’image.

L’objet ImageModification est un objet persistant. Cela signifie que l’état actuel de l’objet peut être enregistré dans un stockage persistant, puis recréé ultérieurement en lisant cet état depuis ce même stockage. Les méthodes suivantes assurent la persistance de l’objet :

Linux : SaveToFile et LoadFromFile

Windows : SaveToFile, LoadFromFile, SaveToMemory et LoadFromMemory.

​

Properties

Name	Type	Description
Application	Engine, lecture seule	Retourne l’objet Engine.
StretchRatio	double	Spécifie le ratio d’étirement à appliquer à l’image. Par défaut, cette propriété vaut 1.0, ce qui correspond à l’absence d’étirement.

​

Méthodes

Nom	Description
AddClipRegion	Ajoute une nouvelle région de recadrage au tableau interne des régions de recadrage.
AddInvertRegion	Ajoute une nouvelle région d’inversion au tableau interne des régions d’inversion.
AddPaintRegion	Ajoute une nouvelle région de peinture au tableau interne des régions de peinture.
AddReplaceBlackPixelsRegion	Ajoute une nouvelle région de « remplacement des pixels noirs » au tableau interne des régions de « remplacement des pixels noirs ».
AddReplaceWhitePixelsRegion	Ajoute une nouvelle région de « remplacement des pixels blancs » au tableau interne des régions de « remplacement des pixels blancs ».
ClearClipRegions	Efface le tableau interne des régions de recadrage.
ClearInvertRegions	Efface le tableau interne des régions d’inversion.
ClearPaintRegions	Efface le tableau interne des régions de peinture.
ClearReplaceBlackPixelsRegions	Efface le tableau interne des régions de « remplacement des pixels noirs ».
ClearReplaceWhitePixelsRegions	Efface le tableau interne des régions de « remplacement des pixels blancs ».
CopyFrom	Initialise les propriétés de l’objet courant avec les valeurs des propriétés similaires d’un autre objet.
LoadFromFile	Restaure le contenu de l’objet à partir d’un fichier sur le disque.
LoadFromMemory	Restaure le contenu de l’objet depuis la mémoire globale. Windows uniquement.
SaveToFile	Enregistre le contenu de l’objet dans un fichier sur le disque.
SaveToMemory	Enregistre le contenu de l’objet dans la mémoire globale. Windows uniquement.

​

Paramètre de sortie

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

​

Paramètre d’entrée

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

• WriteToFile, EstimateBitmapSize (Win), GetBitmap (Win) de l’objet Image,
• Modify de l’objet ImageDocument.

​

Exemples

Code C#

int splitStartPosition;
int splitEndPosition;
bool isVerticalSplit;
FREngine.IFRDocument frDoc;
FREngine.IFRPage page;
// Diviser l'image d'une page de document en deux pages
// Dimensions de l'image
int width = page.ImageDocument.ColorImage.Width;
int height = page.ImageDocument.ColorImage.Height;
// Dupliquer la page
frDoc.AddPage(page);
FREngine.IFRPage secondPage = frDoc.Pages[frDoc.Pages.Count - 1];
// Rogner la première et la deuxième page
FREngine.IImageModification firstModification = engine.CreateImageModification();
FREngine.IRegion firstClipRegion = engine.CreateRegion();
FREngine.IImageModification secondModification = engine.CreateImageModification();
FREngine.IRegion secondClipRegion = engine.CreateRegion();
if (isVerticalSplit)
{
 firstClipRegion.AddRect(0, 0, splitStartPosition, height - 1 );
 secondClipRegion.AddRect(splitEndPosition, 0, width - 1, height - 1);
}
else
{
 firstClipRegion.AddRect(0, 0, width - 1, splitStartPosition);
 secondClipRegion.AddRect(0, splitEndPosition, width - 1, height - 1);
}
firstModification.AddClipRegion(firstClipRegion);
page.ImageDocument.Modify(firstModification);
secondModification.AddClipRegion(secondClipRegion);
secondPage.ImageDocument.Modify(secondModification);

​

Voir aussi

Utilisation des images

Utilisation des propriétés