Cette méthode ajoute une nouvelle région de « remplacement des pixels blancs » au tableau interne des régions de « remplacement des pixels blancs » de l’objet ImageModification. Pour supprimer toutes les régions de « remplacement des pixels blancs » précédemment ajoutées, appelez la méthode IImageModification::ClearReplaceWhitePixelsRegions. Si la modification doit être appliquée à un seul plan couleur (ou gris) de l’image, les coordonnées de la région doivent être spécifiées dans ce plan couleur (ou gris). Si la modification doit être appliquée à l’ensemble de ImageModification, les coordonnées doivent être spécifiées dans le plan de l’image noir et blanc redressée.
HRESULT AddReplaceWhitePixelsRegion(
IRegion* Region,
int Color,
int StrokesExpansion
);
void AddReplaceWhitePixelsRegion(
IRegion Region,
int Color,
int StrokesExpansion
);
Sub AddReplaceWhitePixelsRegion( _
Region As IRegion, _
Color As Integer, _
[StrokesExpansion As Integer = 0] _
)
Region
[in] Ce paramètre de type Region spécifie la région « remplacement des pixels blancs » à ajouter.
Color
[in] Cette variable spécifie la couleur par laquelle les pixels blancs sont remplacés. La valeur de ce paramètre peut être -1, ce qui signifie que la couleur est transparente.
La valeur int est calculée à partir du triplet RGB à l’aide de la formule : ( red value ) + (256 x green value ) + (65536 x blue value ), où red value est la première composante du triplet, green value la deuxième et blue value la troisième. Par exemple, la valeur int de la couleur blanche est égale à 16777215.
StrokesExpansion
[in] Cette variable spécifie l’extension (en pixels) des zones noires de l’image avant le remplacement. Ce paramètre doit être positif ou nul.
Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions d’ABBYY FineReader Engine.
Les pixels blancs de l’image situés dans les régions « remplacement des pixels blancs » seront remplacés par des pixels de la couleur spécifiée lors de l’application de la méthode IImageDocument::Modify. Cette opération est effectuée sur le plan d’image noir et blanc, mais les résultats seront également appliqués aux plans d’image gris et couleur.
ImageModification
ClearReplaceWhitePixelsRegions