Pular para o conteúdo principal
Roberty Studio
IDPConstrutor

Pré-processamento

Filtros de imagem aplicados ao documento antes da extração no template de IDP: escala de cinza, nitidez, brilho/saturação e limiarização, com faixas e valores padrão.

Pré-processamento

O pré-processamento aplica filtros de imagem ao documento antes da extração, para deixar o texto mais legível para o OCR. É uma lista de filtros executados de cima para baixo: cada filtro recebe a imagem já tratada pelo filtro anterior.

Sem nenhum filtro, o documento segue para a extração como foi enviado. Os filtros são adicionados, reordenados, desativados e removidos pelos cartões de camada. Veja Pipeline.

Filtros​

FiltroO que fazConfiguraçãoFaixaPadrão
Escala de cinzaConverte a imagem para tons de cinza.———
NitidezRealça bordas e detalhes do texto.Sigma0,3 a 5 (passo 0,1)1
M1 — realce nas áreas planas0 a 10 (passo 0,5)1
M2 — realce nas áreas irregulares0 a 10 (passo 0,5)2
Brilho/saturaçãoAjusta brilho, saturação e matiz.Brilho — multiplicador0 a 3 (passo 0,05)1
Saturação — multiplicador0 a 3 (passo 0,05)1
Matiz — rotação em graus0 a 3600
Luminosidade−100 a 1000
LimiarizaçãoBinariza a imagem por um valor de corte: o que fica abaixo vira preto e o que fica acima vira branco.Corte0 a 255128
Aplicar em escala de cinza — converte para tons de cinza antes de binarizarLigado ou desligadoLigado

Nos multiplicadores, 1 mantém a imagem como está; valores menores reduzem e maiores aumentam.

Ordem de aplicação​

A ordem dos filtros muda o resultado. Por exemplo, em Escala de cinza → Nitidez → Limiarização você remove a cor, depois realça as letras e, por fim, separa texto e fundo.

Os filtros afetam apenas a imagem entregue à extração. A identificação compara o documento recebido como ele chegou, antes dos filtros.

Pré-visualização​

Para ver o efeito dos filtros, rode o rascunho no Playground. A etapa Pré-processamento do resultado mostra a imagem depois de cada filtro e a imagem final que segue para a extração; um filtro desativado aparece como "imagem inalterada". Veja Playground e Simular API.

Quando usar cada filtro​

Situação do documentoFiltros para testar
Fotos e digitalizações coloridas, em que a cor não importa para a leituraEscala de cinza
Texto borrado ou com contornos fracosNitidez
Imagem escura, apagada ou com pouco contrasteBrilho/saturação
Fundo manchado, sombreado ou com marcas que atrapalham o textoLimiarização, ajustando o Corte

Filtros não são obrigatórios: documentos nítidos, como PDFs gerados por sistemas, podem dispensá-los. Compare o texto extraído no Playground com e sem cada filtro antes de publicar.