Zum Hauptinhalt springen
Diese Methode fügt dem internen Array von „replace black pixels“-Regionen des ImageModification-Objekts eine neue „replace black pixels“-Region hinzu. Um alle zuvor hinzugefügten „replace black pixels“-Regionen zu entfernen, rufen Sie die Methode IImageModification::ClearReplaceBlackPixelsRegions auf. Wenn die Modifikation auf eine einzelne Farb- (oder Graustufen-)Ebene des Bildes angewendet werden soll, sollten die Koordinaten der Region auf dieser Farb- (bzw. Graustufen-)Ebene angegeben werden. Wenn die Modifikation auf das gesamte ImageModification-Objekt angewendet werden soll, sollten die Koordinaten auf der begradigten Schwarzweiß-Bildebene angegeben werden.

Syntax

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] _
)

Parameter

Region [in] Dieser Parameter vom Typ Region gibt die hinzuzufügende „replace black pixels“-Region an. Color [in] Diese Variable gibt die Farbe an, durch die die schwarzen Pixel ersetzt werden. Der Wert dieses Parameters kann -1 sein; das bedeutet, dass die Farbe transparent ist.
Der int-Wert wird aus dem RGB-Tripel anhand der Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Komponente des Tripels ist, der Grünwert die zweite und der Blauwert die dritte Komponente. Beispielsweise beträgt der int-Wert der Farbe Weiß 16777215.
StrokesExpansion [in] Diese Variable gibt die Ausdehnung (in Pixeln) weißer Bereiche auf der Schwarzweiß-Bildebene vor dem Ersetzen an. Dieser Parameter muss größer oder gleich null sein.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie liefert die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen.

Bemerkungen

Schwarze Pixel im Bild innerhalb der Regionen „replace black pixels“ werden durch Pixel der angegebenen Farbe ersetzt, wenn die Methode IImageDocument::Modify angewendet wird. Dieser Vorgang wird auf der Schwarzweiß-Bildebene durchgeführt, die Ergebnisse werden jedoch auch auf die Graustufen-Bildebene und die Farb-Bildebene angewendet.

Siehe auch

ImageModification ClearReplaceBlackPixelsRegions