> ## Documentation Index > Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method), 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](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white). * 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](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) et [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method) Windows : [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method), [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method), [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) et [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method).
## Properties
| Name | Type | Description | | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | Application | [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface), [lecture seule](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Retourne l'objet Engine. | | StretchRatio | [double](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) | 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](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addclipregion-method) | Ajoute une nouvelle région de recadrage au tableau interne des régions de recadrage. | | [AddInvertRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addinvertregion-method) | Ajoute une nouvelle région d'inversion au tableau interne des régions d'inversion. | | [AddPaintRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addpaintregion-method) | Ajoute une nouvelle région de peinture au tableau interne des régions de peinture. | | [AddReplaceBlackPixelsRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplaceblackpixelsregion-method) | Ajoute une nouvelle région de « remplacement des pixels noirs » au tableau interne des régions de « remplacement des pixels noirs ». | | [AddReplaceWhitePixelsRegion](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/addreplacewhitepixelsregion-method) | Ajoute une nouvelle région de « remplacement des pixels blancs » au tableau interne des régions de « remplacement des pixels blancs ». | | [ClearClipRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearclipregions-method) | Efface le tableau interne des régions de recadrage. | | [ClearInvertRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearinvertregions-method) | Efface le tableau interne des régions d'inversion. | | [ClearPaintRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearpaintregions-method) | Efface le tableau interne des régions de peinture. | | [ClearReplaceBlackPixelsRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplaceblackpixelsregions-method) | Efface le tableau interne des régions de « remplacement des pixels noirs ». | | [ClearReplaceWhitePixelsRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method) | Efface le tableau interne des régions de « remplacement des pixels blancs ». | | [CopyFrom](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialise les propriétés de l'objet courant avec les valeurs des propriétés similaires d'un autre objet. | | [LoadFromFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfromfile-method) | Restaure le contenu de l'objet à partir d'un fichier sur le disque. | | [LoadFromMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/loadfrommemory-method) | Restaure le contenu de l'objet depuis la mémoire globale. *Windows uniquement.* | | [SaveToFile](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetofile-method) | Enregistre le contenu de l'objet dans un fichier sur le disque. | | [SaveToMemory](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/savetomemory-method) | 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](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) de l'objet [Engine](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface).
## Paramètre d'entrée
Cet objet est passé en tant que paramètre d'entrée aux méthodes suivantes : * [WriteToFile](/fr/fine-reader/engine/api-reference/image-related-objects/image/writetofile-method), [EstimateBitmapSize](/fr/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method) (Win), [GetBitmap](/fr/fine-reader/engine/api-reference/image-related-objects/image/getbitmap-method) (Win) de l'objet [Image](/fr/fine-reader/engine/api-reference/image-related-objects/image), * [Modify](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method) de l'objet [ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument).
## Exemples
```csharp theme={null} 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](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images) [Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)