Questo metodo aggiunge una nuova area “replace black pixels” all’array interno delle aree “replace black pixels” dell’oggetto ImageModification. Per rimuovere tutte le aree “replace black pixels” aggiunte in precedenza, chiamare il metodo IImageModification::ClearReplaceBlackPixelsRegions. Se la modifica deve essere applicata a un singolo piano color (o gray) dell’immagine, le coordinate dell’area devono essere specificate in quel piano colore (o grigio). Se la modifica deve essere applicata all’intero oggetto ImageModification, le coordinate devono essere specificate sul piano dell’immagine black-and-white bianco e nero raddrizzato.
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] Questo parametro di tipo Region specifica la regione “replace black pixels” da aggiungere.
Color
[in] Questa variabile specifica il colore con cui vengono sostituiti i pixel neri. Il valore di questo parametro può essere -1, a indicare che il colore è trasparente.
Il valore int viene calcolato a partire dalla tripletta RGB usando la formula: ( valore del rosso ) + (256 x valore del verde ) + (65536 x valore del blu ), dove il valore del rosso è il primo componente della tripletta, il valore del verde è il secondo componente e il valore del blu è il terzo componente. Ad esempio, il valore int del colore bianco è 16777215.
StrokesExpansion
[in] Questa variabile specifica l’espansione (in pixel) delle aree bianche sul piano dell’immagine in bianco e nero prima della sostituzione. Questo parametro deve essere maggiore o uguale a zero.
Questo metodo non ha valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine.
I pixel neri dell’immagine all’interno delle aree “replace black pixels” verranno sostituiti con pixel del colore specificato quando viene applicato il metodo IImageDocument::Modify. Questa operazione viene eseguita sul piano immagine in bianco e nero, ma i risultati verranno applicati anche ai piani immagine grigio e colore.
ImageModification
ClearReplaceBlackPixelsRegions