Pular para o conteúdo principal
Este objeto corresponde a uma imagem aberta, ou “documento de imagem”. Seus atributos refletem os atributos de uma imagem. O objeto ImageDocument é o objeto raiz de uma coleção de objetos Image, ou “planos de imagem”. Cada documento de imagem inclui 4 “planos de imagem”: preto e branco, cinza, cor e pré-visualização. Eles podem ser acessados por meio das propriedades correspondentes. O objeto contém vários métodos de pré-processamento de imagem. Alguns desses métodos são adequados apenas para fotos, enquanto outros podem ser usados para todos os tipos de documentos. Alguns métodos aumentam a qualidade do reconhecimento; outros apenas melhoram a aparência visual das imagens, mas podem reduzir a qualidade do reconhecimento. Estes últimos devem ser usados somente após o reconhecimento. Leia atentamente a descrição de cada método para descobrir se ele pode ser usado no seu cenário. Abaixo, você encontra a ordem em que recomendamos usar os métodos de pré-processamento de imagem (use apenas os métodos da lista adequados ao seu cenário):
  • Para melhorar a qualidade do reconhecimento:
    1. Recortar a imagem
    2. Aprimorar o contraste local
    3. Corrigir a orientação (use o método Transform com os parâmetros necessários)
    4. Inverter ou espelhar a imagem (use o método Transform com os parâmetros necessários)
    5. Corrigir a inclinação
    6. Dividir páginas duplas (use o método SplitPages do objeto FRDocument)
    7. Remover distorções geométricas
    8. Remover ruído
    9. Remover interferências
    10. Remover desfoque de movimento
    11. Suprimir objetos coloridos
    12. Remover objetos coloridos
  • Para melhorar a aparência da imagem:
    1. Equalizar o brilho e tornar o plano de fundo branco
    2. Suavizar a textura da imagem
    3. Aplicar tramado à imagem
Observe que todos esses métodos de pré-processamento devem ser aplicados a uma imagem aberta. Algumas modificações da imagem podem ser aplicadas antes, durante o processo de abertura. Consulte a descrição dos objetos PrepareImageMode e PagePreprocessingParams para saber mais sobre o pré-processamento de imagem durante a abertura. O objeto ImageDocument é o que se chama de “objeto conectável.” Para Visual Basic no FRE para Windows, ele pode ser declarado com WithEvents. Para C++ (em todos os sistemas operacionais compatíveis), isso significa que ele oferece suporte à interface IConnectionPointContainer. Para receber eventos de notificação durante o processamento, os usuários de C++ devem criar um objeto derivado da interface IImageDocumentEvents e fazer o seguinte:
  • No Linux e no macOS: registrar o objeto no objeto ImageDocument chamando a função global AdviseFREngineObject.
  • No Windows: configurar a conexão entre o objeto e a fonte de eventos implementada no objeto ImageDocument pelos meios padrão do COM.
No Windows: os métodos do objeto ImageDocument informam o andamento do processamento da página por meio de interfaces de saída especiais. Essas interfaces são IImageDocumentEvents (para C++) e a dispinterface DIImageDocumentEvents (para Visual Basic). Observe que os usuários do Visual Basic não precisam se preocupar com os detalhes da implementação das interfaces de eventos, pois essa plataforma de desenvolvimento oferece meios simples para lidar com elas.

Properties

,read-only

Retorna o objeto.

,read-only

Fornece acesso ao plano de imagempreto e brancodo objeto ImageDocument atual.

,read-only

Fornece acesso ao plano de imagem emcordo objeto ImageDocument atual.

,read-only

Fornece acesso ao plano de imagem emcinzado objeto ImageDocument atual.

, read-only

Armazena o ID do documento de imagem.

, read-only

Cada plano de cor do documento de imagem é caracterizado por seu próprio tipo de cor. Esta propriedade especifica o tipo de cor para todo o documento de imagem como o máximo dos valores correspondentes de seus planos de cor (preto e branco, cinza, cor).

, read-only

Especifica se o documento de imagem está armazenado apenas na memória ou se também está representado como uma pasta no disco.

Após a chamada ao métodoSaveTo, o valor desta propriedade não é alterado. É necessário recarregar o documento de imagem por meio da chamada ao métodoLoadImageDoc.

, read-only

Armazena o caminho para a pasta com a representação interna do objeto no disco. A propriedade contém uma string vazia se o valor da propriedade IsInMemory for TRUE.

Após a chamada ao métodoSaveTo, o valor desta propriedade não é alterado. É necessário recarregar o documento de imagem por meio da chamada ao métodoLoadImageDoc.

,somente leitura

Retorna o objetoque contém informações sobre as coordenadas de pixel no estado de modificação atual.

Esta propriedade é útil sempre que for necessário converter coordenadas entre dois estados durante o processamento de imagem.

, somente leitura

Indica se alguma modificação foi feita no objeto ImageDocument desde que ele foi carregado na memória ou desde a última chamada do método.

, somente leitura

Indica a rotação aplicada à imagem desde a abertura.

, somente leitura

Quando definida como TRUE, esta propriedade indica que as cores da imagem foram invertidas desde a abertura.

, somente leitura

Quando definida como TRUE, esta propriedade indica que a imagem foi espelhada em torno do eixo vertical desde a abertura.

, somente leitura

Esta propriedade indica se a inclinação da imagem foi totalmente corrigida durante a abertura, o pré-processamento ou a chamada do método.

A tangente do ângulo de inclinação corrigido é armazenada na propriedade SkewAngle.

, somente leitura

Armazena a tangente do ângulo de inclinação detectado na imagem e corrigido durante a abertura, o pré-processamento ou a chamada do método. Se o ângulo de inclinação for negativo, a imagem é rotacionada no sentido horário; se for positivo, é rotacionada no sentido anti-horário. A imagem pode ser rotacionada em torno de qualquer ponto. O tamanho da imagem corrigida quanto à inclinação é sempre maior que o da imagem original.

Ao realizar modificações adicionais na imagem, o valor desta propriedade é redefinido para 0. Salve o valor do ângulo de inclinação corrigido, se necessário, antes de chamar qualquer outro método para editar a imagem.

, somente leitura

Indica se o objeto ImageDocument foi criado a partir de um arquivo que contém texto. Por exemplo, arquivos PDF podem ter uma camada de texto.

, somente leitura

Indica se o objeto ImageDocument foi criado a partir de um arquivo que é uma foto.

, somente leitura

Fornece informações sobre o formato do arquivo de imagem de origem do objeto ImageDocument atual. Se essas informações não estiverem disponíveis ou a imagem tiver sido recebida do scanner, o valor desta propriedade será IFF_UnknownFormat.

, somente leitura

Fornece informações sobre o scanner utilizado para capturar a imagem. Se as informações sobre os parâmetros da imagem de origem não estiverem disponíveis ou a imagem tiver sido recebida de um arquivo, o valor desta propriedade será uma string vazia.

, somente leitura

Fornece informações sobre o limiar de intensidade de digitalização do objeto ImageDocument atual. Se as informações sobre os parâmetros da imagem de origem não estiverem disponíveis ou a imagem tiver sido obtida de um arquivo, o valor desta propriedade será -1.

, somente leitura

Fornece informações sobre a resolução horizontal da imagem de origem do objeto ImageDocument atual. Se as informações sobre os parâmetros da imagem de origem não estiverem disponíveis, o valor desta propriedade será 0.

, somente leitura

Fornece informações sobre a resolução vertical da imagem de origem do objeto ImageDocument atual. Se as informações sobre os parâmetros da imagem de origem não estiverem disponíveis, o valor desta propriedade será 0.

Métodos

NameDescription
ApplySigmaFilterEste method aplica um filtro de redução de ruído à imagem. É especialmente útil para fotografias.
ChangeResolutionAltera a resolução da imagem.
CorrectShadowsAndHighlightsCorrige o excesso de sombras e realces na imagem.
CorrectSkewCorrige a inclinação da imagem.
CropImageDetecta as bordas de um documento na imagem e, em seguida, recorta a imagem.
DitherImageAplica pontilhamento à imagem usando o algoritmo de pontilhamento Floyd–Steinberg ou Bayer (ordenado).
EnhanceLocalContrastAumenta o contraste local da imagem.
EqualizeBrightnessEqualiza o brilho da imagem. Este método pode ser usado somente para imagens em cinza e em cor.
FindBlackSquaresLocaliza quadrados pretos na imagem.
GetPreviewImageFornece acesso ao plano de imagem de pré-visualização de 94 * 60 do objeto ImageDocument atual. Se a pré-visualização nesse tamanho ainda não tiver sido criada, ela será criada durante esta chamada, o que levará algum tempo.
GetPreviewImageSpecificSizeFornece acesso ao plano de imagem de pré-visualização do objeto ImageDocument atual e permite especificar o tamanho. Se a pré-visualização nesse tamanho ainda não tiver sido criada, ela será gerada durante esta chamada, o que pode levar algum tempo.
GetTextBackgroundColorDetecta as cores do texto e do plano de fundo no retângulo especificado da imagem.
ModifyPermite modificar a imagem. Este método oferece modificações mais avançadas do que o método Transform.
RemoveColorObjectsRemove os objetos coloridos especificados da imagem inteira ou de partes dela. Este método pode ser usado somente com imagens coloridas.
RemoveColorObjectsExRemove todos os objetos coloridos dos tons especificados da imagem e os substitui pela cor especificada. Os objetos removidos podem ser salvos em uma imagem separada.
RemoveGarbageRemove o ruído (pontos excedentes menores do que um determinado tamanho) da imagem.
RemoveGeometricalDistortionsRemove as distorções geométricas da imagem (como linhas curvas próximas à borda de uma página).
RemoveMotionBlurRemove o desfoque de movimento da imagem.
RemoveNoiseReduz o ruído da imagem.
SaveImageRegionToSalva partes da imagem em uma pasta no disco. A imagem salva fica no formato interno do ABBYY FineReader Engine.
SaveModifiedSalva todas as modificações feitas no objeto ImageDocument atual em uma pasta no disco.
SaveToSalva o conteúdo do objeto ImageDocument em uma pasta no disco. A imagem é salva no formato interno do ABBYY FineReader Engine.
SaveToFileSalva o conteúdo do objeto ImageDocument em um arquivo.
SaveToMemory <Note> Somente para Windows. </Note>Salva o conteúdo do objeto ImageDocument na memória global.
SmoothImagePermite suavizar a imagem. Este método só pode ser usado com imagens em tons de cinza e coloridas.
SmoothTextureSuaviza a imagem usando um filtro não linear. Útil para imagens com textura. Esse método só pode ser usado em imagens em escala de cinza e coloridas com pelo menos 3 pixels em cada dimensão.
TransformAplica um conjunto limitado de transformações na imagem.
ImageDocument Diagrama de objetos

Parâmetro de saída

Este objeto é o parâmetro de saída dos seguintes métodos LoadImageDocFromFile, LoadImageDocFromMemory (somente no Windows), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory do objeto Engine.

Parâmetro de entrada

Este objeto é usado como parâmetro de entrada nos seguintes métodos:

Exemplos

O objeto é usado nos exemplos de código: Linux: CommandLineInterface e BCR macOS: Reconhecimento de Cartões de Visita Windows: CommandLineInterface; e Demo Tools: Perfis de Processamento Predefinidos do Engine

Veja também

IImageDocumentEvents Trabalhando com imagens Trabalhando com objetos conectáveis Trabalhando com Properties