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
| Filtro | O que faz | Configuração | Faixa | Padrão |
|---|---|---|---|---|
| Escala de cinza | Converte a imagem para tons de cinza. | — | — | — |
| Nitidez | Realça bordas e detalhes do texto. | Sigma | 0,3 a 5 (passo 0,1) | 1 |
| M1 — realce nas áreas planas | 0 a 10 (passo 0,5) | 1 | ||
| M2 — realce nas áreas irregulares | 0 a 10 (passo 0,5) | 2 | ||
| Brilho/saturação | Ajusta brilho, saturação e matiz. | Brilho — multiplicador | 0 a 3 (passo 0,05) | 1 |
| Saturação — multiplicador | 0 a 3 (passo 0,05) | 1 | ||
| Matiz — rotação em graus | 0 a 360 | 0 | ||
| Luminosidade | −100 a 100 | 0 | ||
| Limiarização | Binariza a imagem por um valor de corte: o que fica abaixo vira preto e o que fica acima vira branco. | Corte | 0 a 255 | 128 |
| Aplicar em escala de cinza — converte para tons de cinza antes de binarizar | Ligado ou desligado | Ligado |
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 documento | Filtros para testar |
|---|---|
| Fotos e digitalizações coloridas, em que a cor não importa para a leitura | Escala de cinza |
| Texto borrado ou com contornos fracos | Nitidez |
| Imagem escura, apagada ou com pouco contraste | Brilho/saturação |
| Fundo manchado, sombreado ou com marcas que atrapalham o texto | Limiarizaçã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.