Diese Methode fügt dem internen Array von Regionen zum „Ersetzen weißer Pixel“ des Objekts ImageModification eine neue Region zum „Ersetzen weißer Pixel“ hinzu. Um alle zuvor hinzugefügten Regionen zum „Ersetzen weißer Pixel“ zu entfernen, rufen Sie die Methode IImageModification::ClearReplaceWhitePixelsRegions auf. Wenn die Änderung auf nur eine einzelne Farbebene (oder Graustufenebene) des Bildes angewendet werden soll, sollten die Koordinaten der Region auf dieser Farb- bzw. Graustufenebene angegeben werden. Wenn die Änderung auf die gesamte ImageModification angewendet werden soll, sollten die Koordinaten auf der entzerrten Schwarzweiß-Bildebene angegeben werden.
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] Dieser Parameter vom Typ Region gibt die hinzuzufügende „Ersetzen weißer Pixel”-Region an.
Color
[in] Diese Variable gibt die Farbe an, durch die die weißen 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 nach folgender Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Komponente des Tripels ist, der Grünwert die zweite Komponente und der Blauwert die dritte Komponente. Zum Beispiel entspricht der int-Wert der Farbe Weiß 16777215.
StrokesExpansion
[in] Diese Variable gibt die Ausdehnung (in Pixeln) schwarzer Bereiche im Bild vor dem Ersetzen an. Dieser Parameter muss null oder positiv sein.
Diese Methode hat keine spezifischen Rückgabewerte. Sie liefert die Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen zurück.
Weiße Pixel im Bild innerhalb der Regionen „Ersetzen weißer Pixel
ImageModification
ClearReplaceWhitePixelsRegions