O Que É o Potrace?
O Potrace (polygon tracer) é um programa gratuito e de código aberto criado por Peter Selinger, distribuído sob a GPL. Ele converte um bitmap em contornos vetoriais suaves. Lê arquivos PBM, PGM, PPM e BMP e grava SVG, EPS, PostScript, PDF, DXF, GeoJSON e outros formatos.
O potrace vetoriza em uma única cor: cada pixel é primeiro plano ou fundo. O Caminho → Vetorizar Bitmap do Inkscape executa o potrace internamente, e seus modos multicoloridos empilham várias passagens do potrace. A ferramenta complementar mkbitmap limpa e amplia uma digitalização em escala de cinza, transformando-a em bitmap antes da vetorização.
O Que É o Limiar do Potrace?
Antes de o potrace rastrear as bordas de uma imagem, ele precisa reduzi-la a apenas duas cores: preto (primeiro plano) e branco (fundo). Isso é chamado de binarização. O parâmetro de limiar (-k) controla onde fica a linha divisória na escala de brilho. Para uma visão geral, veja como funciona a conversão de raster para vetor e quais imagens vetorizam bem.
Cada pixel da imagem de origem tem um valor de brilho. Em uma imagem em escala de cinza, esse valor varia de 0 (preto puro) a 1 (branco puro), sendo 0,5 o cinza médio. O valor do limiar determina o ponto de corte:
- Pixels com brilho abaixo do limiar → tornam-se pretos (incluídos no traçado vetorial)
- Pixels com brilho acima do limiar → tornam-se brancos (ignorados)
O limiar padrão é 0,5, que divide a faixa de brilho exatamente ao meio. Isso funciona bem para a maioria das imagens de alto contraste, mas ajustar o limiar pode melhorar significativamente os resultados para tipos específicos de imagens.
Nota técnica: a entrada colorida é primeiro reduzida a um único valor de brilho por pixel e depois comparada com o limiar. Cores de brilho semelhante caem do mesmo lado do corte, mesmo que pareçam diferentes.
Comparação Visual em Diferentes Limiares
Para entender o impacto das configurações de limiar, considere como a mesma imagem de origem fica ao ser rastreada com diferentes valores. As descrições abaixo se aplicam a uma imagem típica em escala de cinza com uma mistura de elementos claros e escuros:
| Limiar | Resultado Visual | O Que É Capturado |
|---|---|---|
| 0,2 | Muito claro — primeiro plano mínimo | Apenas os pixels absolutamente mais escuros (pretos profundos, sombras densas). A maior parte da imagem aparece como espaço em branco. Útil para extrair apenas os elementos mais marcantes e de maior contraste de uma imagem com muito ruído. |
| 0,3 | Aparência de esboço leve | Áreas escuras e meios-tons fortes. Cinzas claros e tons médios são descartados. Produz um resultado delicado, semelhante a um esboço, que captura os contornos principais, mas não detalhes finos ou sombreamento sutil. |
| 0,5 | Equilibrado (padrão) | Tudo mais escuro que o cinza médio torna-se primeiro plano. Fornece a representação binária mais natural para a maioria das imagens. O ponto de partida ideal para logotipos, arte em linha e gráficos em geral. |
| 0,7 | Mais pesado — mais primeiro plano | A maior parte da imagem torna-se primeiro plano, com apenas as áreas mais claras permanecendo brancas. Bom para recuperar detalhes de imagens de origem com cores claras, documentos desbotados ou esboços a lápis que ficaram muito claros com 0,5. |
| 0,9 | Muito pesado — quase sólido | Quase tudo torna-se primeiro plano preto. Apenas pixels quase brancos permanecem como fundo. Útil para extrair marcas muito tênues de um fundo branco, mas geralmente produz um resultado excessivamente pesado que obscurece os detalhes. |
A percepção-chave: limiares mais baixos produzem saída mais clara com menos detalhe; limiares mais altos produzem saída mais pesada que captura mais da imagem. Não existe um limiar universalmente "correto" — depende inteiramente da distribuição de brilho da sua imagem de origem e do resultado desejado.
Outros Parâmetros do Potrace
Embora o limiar tenha o maior impacto na saída, o potrace oferece vários parâmetros adicionais que ajustam o resultado vetorial com precisão.
Suavização de Cantos (-a alfa)
Controla se os cantos no contorno rastreado são renderizados como ângulos agudos ou suavizados em curvas. O valor varia de 0 a 1,334:
-a 0(cantos agudos) — Cada canto no contorno binário é preservado como um ângulo agudo no SVG. Isso produz saída angular e precisa. Melhor para formas geométricas, pixel art, QR codes e diagramas técnicos onde você deseja ângulos retos exatos.-a 1(padrão) — Suavização moderada. Cantos próximos de 90° são preservados; ângulos obtusos são suavizados em curvas. Isso oferece um bom equilíbrio para a maioria dos casos de uso — texto permanece legível, formas orgânicas ficam naturais.-a 1,334(suavização máxima) — Todos os cantos são arredondados em curvas, mesmo os mais agudos. Produz a saída mais suave e fluida. Ideal para caligrafia, formas orgânicas e interpretações artísticas onde artefatos angulares ficariam antinaturais.
Otimização de Caminho (-O)
Controla a intensidade com que o potrace simplifica as curvas de Bézier que formam cada caminho. Níveis de otimização mais altos produzem arquivos SVG com menos pontos de controle (tamanho de arquivo menor) ao custo de um rastreamento potencialmente menos preciso. O nível padrão oferece um bom equilíbrio entre fidelidade e compacidade.
Na prática, esse parâmetro raramente precisa de ajuste. A otimização padrão produz caminhos compactos e precisos, adequados tanto para exibição quanto para máquinas de corte. Aumentar a otimização pode ajudar se o seu arquivo SVG for excepcionalmente grande (milhares de caminhos complexos vindos da vetorização de uma fotografia), mas para logotipos e arte em linha típicos, o padrão é ideal. Se o seu software de corte precisar de DXF em vez de SVG, converta o SVG para DXF depois da vetorização.
Remoção de Ruído (-t turdsize)
Antes do rastreamento, o potrace remove pequenas regiões isoladas (chamadas de "turds" na documentação do potrace) da imagem binária. O valor de turdsize especifica a área máxima em pixels das regiões a descartar:
-t 0— Manter tudo. Sem remoção de ruído. Até pixels isolados serão rastreados em pequenos caminhos vetoriais.-t 2(padrão) — Remover regiões isoladas de 1-2 pixels. Elimina a maioria dos ruídos de scanner e artefatos de compressão JPG sem afetar o conteúdo real da imagem.-t 10— Remover manchas pequenas de até 10 pixels. Bom para documentos digitalizados com textura de papel visível.-t 50— Remoção agressiva. Elimina artefatos maiores, mas também pode remover pequenos detalhes intencionais, como marcas de pontuação ou elementos decorativos finos.
Dica de turdsize: Se a sua saída SVG tiver muitos fragmentos vetoriais pequenos e espalhados que não fazem parte do design real, aumente o turdsize. Se pequenos detalhes intencionais (pontos, traços finos) estiverem desaparecendo, diminua ou defina como 0.
Melhores Práticas por Tipo de Imagem de Origem
Diferentes tipos de imagens de origem requerem combinações diferentes de configurações do potrace. A tabela abaixo fornece pontos de partida recomendados para os cenários mais comuns:
| Imagem de Origem | Limiar (-k) |
Cantos (-a) |
Turdsize (-t) |
Notas |
|---|---|---|---|---|
| Logotipo limpo (P&B) | 0,5 | 1 (suave) | 2 (baixo) | As configurações padrão funcionam perfeitamente para logotipos de alto contraste em fundos brancos |
| Esboço a lápis | 0,35–0,45 | 1,334 (máx. suave) | 0 (nenhum) | Limiar mais baixo para evitar capturar textura de papel como ruído; suavização máxima para linhas fluidas |
| Carimbo / selo | 0,55–0,65 | 1 (suave) | 10–20 (alto) | Limiar ligeiramente mais alto captura o carimbo completo; turdsize alto remove respingos de tinta |
| Foto de baixo contraste | 0,3–0,4 | 1 (suave) | 10–50 (alto) | Limiar mais baixo preserva a separação; turdsize alto remove ruído das áreas cinzas |
| Arte de alto contraste | 0,5 | 0 (agudo) | 2 (baixo) | Cantos agudos preservam a precisão geométrica; limiar padrão para contraste P&B nítido |
| Documento digitalizado | 0,5–0,6 | 0 (agudo) | 5–15 | Cantos agudos para legibilidade do texto; turdsize moderado para poeira de papel e artefatos de scanner |
| Origem desbotada / clara | 0,65–0,8 | 1 (suave) | 2–5 | Limiar mais alto captura conteúdo de cor clara que seria perdido com 0,5 |
| Pixel art / QR code | 0,5 | 0 (agudo) | 0 (nenhum) | Cantos agudos preservam a geometria perfeita de pixels; sem remoção de ruído para manter cada pixel intencional |
Dicas de Pré-Processamento
Ajustar os parâmetros do potrace ajuda, mas as maiores melhorias vêm da preparação da imagem de origem antes da conversão. Essas etapas de pré-processamento podem ser feitas em qualquer editor de imagens — até mesmo no editor integrado do seu celular. O guia completo para vetorizar uma imagem aborda essas etapas e também a limpeza após a vetorização.
Aumentar o Contraste
A melhoria individual mais eficaz. Abra a imagem em qualquer editor e aumente o contraste. Isso amplia a diferença entre pixels claros e escuros, tornando a detecção de bordas mais limpa e precisa. Para imagens P&B, usar um ajuste de "Níveis" ou "Curvas" para escurecer os pretos e clarear os brancos produz resultados ainda melhores do que um simples controle deslizante de contraste.
Remover Ruído de Fundo
Para documentos digitalizados e fotos de objetos físicos, o fundo raramente é branco puro. Textura de papel, iluminação irregular, sombras e poeira introduzem pixels cinzas que o potrace pode interpretar como primeiro plano. Antes de fazer o upload:
- Use um ajuste de "Níveis" para aproximar o fundo do branco puro
- Aplique um leve desfoque gaussiano (raio de 1-2 pixels) para suavizar a textura do papel sem afetar as bordas principais
- Recorte bem para remover sombras e artefatos de bordas resultantes da digitalização
Use PNG em Vez de JPG
A compressão JPEG cria artefatos em bloco visíveis ao redor de bordas nítidas — exatamente as áreas que o potrace analisa para o rastreamento de bordas. Esses artefatos fazem o rastreador seguir os limites de compressão JPEG em vez das bordas reais da imagem, produzindo caminhos vetoriais irregulares e com ruído. Se você tiver a opção, sempre use uma fonte PNG. Se apenas JPG estiver disponível, use a versão de maior qualidade (menos comprimida).
Use Resolução Maior
O potrace ajusta curvas de Bézier aos limites dos pixels. Mais pixels significa mais pontos de dados para o algoritmo de ajuste de curvas, o que produz curvas mais suaves e precisas. Uma imagem de 2000×2000 pixels produzirá saída SVG visivelmente mais suave do que uma versão de 500×500 do mesmo conteúdo. Sempre que possível, faça o upload da versão maior da sua imagem.
Converter para Escala de Cinza Primeiro
Se a sua imagem de origem for fundamentalmente em preto e branco (um logotipo, digitalização de texto ou desenho em linha), convertê-la para escala de cinza antes do upload remove qualquer ruído de cor que possa afetar o cálculo do limiar. O potrace reduz a entrada colorida a valores de brilho internamente, e elementos coloridos com brilho semelhante podem se fundir ou desaparecer.
Como Instalar e Executar o Potrace
- Linux:
sudo apt install potrace(Debian, Ubuntu) ou o gerenciador de pacotes da sua distribuição. - macOS:
brew install potrace. - Windows: baixe os binários pré-compilados no site do potrace no SourceForge e execute
potrace.exeem um terminal. - Vetorizar um BMP em SVG:
potrace -s input.bmp -o output.svg - Com configurações:
potrace -s -k 0.4 -t 10 -a 1 input.bmp -o output.svg - A partir de um JPG (o potrace não lê JPG, então converta antes):
magick input.jpg -colorspace Gray -threshold 50% bmp:- | potrace -s -o output.svg
| Opção | O que controla | Padrão |
|---|---|---|
-k, --blacklevel |
Corte de brilho entre preto e branco | 0,5 |
-t, --turdsize |
Maior mancha (em pixels) a descartar | 2 |
-a, --alphamax |
Suavização de cantos (0 = agudo, 1,334 = arredondado) | 1 |
-O, --opttolerance |
Tolerância de otimização das curvas | 0,2 |
-s / -b |
Saída SVG / escolher um backend (pdf, eps, dxf…) | EPS |
-i, --invert |
Inverte preto e branco antes da vetorização | Desativado |