Pular para o conteúdo principal
Este método adiciona uma nova região de “substituição de pixels pretos” ao array interno de regiões de “substituição de pixels pretos” do objeto ImageModification. Para remover todas as regiões de “substituição de pixels pretos” adicionadas anteriormente, chame o método IImageModification::ClearReplaceBlackPixelsRegions. Se a modificação precisar ser aplicada a um único plano de cor (ou cinza) da imagem, as coordenadas da região deverão ser especificadas nesse plano de cor (cinza). Se a modificação precisar ser aplicada ao objeto ImageModification como um todo, as coordenadas deverão ser especificadas no plano da imagem preto e branco com correção de inclinação.

Sintaxe

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

Parâmetros

Region [in] Este parâmetro do tipo Region especifica a região de “substituição de pixels pretos” que será adicionada. Color [in] Esta variável especifica a cor pela qual os pixels pretos são substituídos. O valor desse parâmetro pode ser -1, o que significa que a cor é transparente.
O valor int é calculado a partir da tripla RGB usando a fórmula: ( valor de vermelho ) + (256 x valor de verde ) + (65536 x valor de azul ), em que o valor de vermelho é o primeiro componente da tripla, o valor de verde é o segundo componente da tripla e o valor de azul é o terceiro componente da tripla. Por exemplo, o valor int da cor branca é 16777215.
StrokesExpansion [in] Esta variável especifica a expansão (em pixels) das áreas brancas no plano da imagem em preto e branco antes da substituição. Este parâmetro deve ser maior ou igual a zero.

Valores de retorno

Este método não tem valores de retorno específicos. Ele retorna os valores de retorno padrão das funções do ABBYY FineReader Engine.

Observações

Os pixels pretos da imagem dentro das regiões “substituição de pixels pretos” serão substituídos por pixels da cor especificada quando o método IImageDocument::Modify for aplicado. Essa operação é executada no plano de imagem preto e branco, mas os resultados também serão aplicados aos planos de imagem cinza e cor.

Veja também

ImageModification ClearReplaceBlackPixelsRegions