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.
HRESULT AddReplaceBlackPixelsRegion(
IRegion* Region,
int Color,
int StrokesExpansion
);
void AddReplaceBlackPixelsRegion(
IRegion Region,
int Color,
int StrokesExpansion
);
Sub AddReplaceBlackPixelsRegion( _
Region As IRegion, _
Color As Integer, _
[StrokesExpansion As Integer = 0] _
)
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.
Diese Methode hat keine spezifischen Rückgabewerte. Sie liefert die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen.
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.
ImageModification
ClearReplaceBlackPixelsRegions