Passer au contenu principal
Cette méthode ajoute une nouvelle région de « remplacement des pixels noirs » au tableau interne des régions de « remplacement des pixels noirs » de l’objet ImageModification. Pour supprimer toutes les régions de « remplacement des pixels noirs » ajoutées précédemment, appelez la méthode IImageModification::ClearReplaceBlackPixelsRegions. 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 sur ce plan couleur (ou gris). Si la modification doit être appliquée à l’ensemble de l’objet ImageModification, les coordonnées doivent être spécifiées sur le plan de l’image noir et blanc redressée.

Syntaxe

C++

HRESULT AddReplaceBlackPixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);

C#

void AddReplaceBlackPixelsRegion(
  IRegion Region,
  int    Color,
  int    StrokesExpansion
);

Visual Basic .NET

Sub AddReplaceBlackPixelsRegion( _
  Region As IRegion, _
  Color As Integer, _
  [StrokesExpansion As Integer = 0] _
)

Paramètres

Region [in] Ce paramètre de type Region spécifie la région « remplacement des pixels noirs » à ajouter. Color [in] Cette variable spécifie la couleur utilisée pour remplacer les pixels noirs. La valeur de ce paramètre peut être -1, ce qui signifie que la couleur est transparente.
La valeur entière 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 le premier composant du triplet, green value le deuxième composant et blue value le troisième composant. Par exemple, la valeur int de la couleur blanche est égale à 16777215.
StrokesExpansion [in] Cette variable spécifie l’extension (en pixels) des zones blanches dans le plan de l’image en noir et blanc avant le remplacement. Ce paramètre doit être non négatif.

Valeurs de retour

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.

Remarques

Les pixels noirs de l’image situés dans les zones « remplacement des pixels noirs » 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 ses résultats seront également appliqués aux plans d’image gris et couleur.

Voir aussi

ImageModification ClearReplaceBlackPixelsRegions