Este método agrega una nueva región de “reemplazar píxeles negros” al arreglo interno de regiones de “reemplazar píxeles negros” del objeto ImageModification. Para eliminar todas las regiones de “reemplazar píxeles negros” agregadas anteriormente, llame al método IImageModification::ClearReplaceBlackPixelsRegions. Si la modificación debe aplicarse a un único plano color (o gris) de la imagen, las coordenadas de la región deben especificarse en ese plano de color (gris). Si la modificación debe aplicarse a todo el objeto ImageModification, las coordenadas deben especificarse en el plano de imagen blanco y negro con la inclinación corregida.
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] Este parámetro del tipo Region especifica la región “reemplazar píxeles negros” que se va a añadir.
Color
[in] Esta variable especifica el color con el que se sustituyen los píxeles negros. El valor de este parámetro puede ser -1, lo que significa que el color es transparente.
El valor int se calcula a partir de la terna RGB mediante la fórmula: ( valor de rojo ) + (256 x valor de verde ) + (65536 x valor de azul ), donde valor de rojo es el primer componente de la terna, valor de verde es el segundo componente y valor de azul es el tercer componente. Por ejemplo, el valor int del color blanco es 16777215.
StrokesExpansion
[in] Esta variable especifica la expansión (en píxeles) de las áreas blancas del plano de imagen en blanco y negro antes de la sustitución. Este parámetro debe ser no negativo.
Este método no tiene valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.
Los píxeles negros de la imagen que se encuentren dentro de las regiones “reemplazar píxeles negros” se sustituirán por píxeles del color especificado cuando se aplique el método IImageDocument::Modify. Esta operación se realiza en el plano de imagen blanco y negro, pero los resultados también se aplicarán a los planos de imagen gris y color.
ImageModification
ClearReplaceBlackPixelsRegions