> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions. # ImageMagick de PNG para SVG: confira o motor de traçado > Descubra se o comando ImageMagick PNG-to-SVG cria caminhos, qual delegado de rastreamento ele usa e por que uma imagem colorida pode se tornar um rastreamento SVG monocromático. Source: https://perfectvector.com/pt-BR/blog/imagemagick-png-to-svg Language: pt-BR Author: Irene Kim Published: 2026-11-03T08:00:00+09:00 O ImageMagick pode produzir caminhos vetoriais SVG a partir de um PNG quando sua construção e configuração fornecem uma rota de rastreamento. Em nossa configuração instalada do ImageMagick 7.1.2-32, `magick color-regions.png traced.svg` usou Potrace 1.16 e produziu caminhos pretos, em vez de um PNG incorporado. Também perdeu as cores originais e uma região de cor clara. Verifique o delegado instalado e o arquivo salvo antes de decidir se esse comando atende às suas necessidades. Se você deseja uma rota de rastreamento on-line para o mesmo PNG, [comece gratuitamente com PerfectVector](https://perfectvector.com/pt-BR/convert-png-to-svg) e inspecione as regiões coloridas e aberturas da visualização. A edição e a exportação requerem um resultado desbloqueado. Este guia diagnostica a rota local do ImageMagick; não compara a qualidade de saída das ferramentas. ## Comece com o sintoma e depois inspecione o pipeline Um SVG que abre com sucesso ainda pode ser inadequado: pode ser monocromático quando você precisa de cores ou conter uma imagem raster quando você precisa de caminhos. Um comando com falha é um sintoma diferente e precisa de sua mensagem de erro real. A extensão do nome do arquivo por si só não pode resolver nenhuma dessas questões. Um **delegado** é um programa externo que o ImageMagick chama para uma tarefa. Sua [documentação de recursos](https://imagemagick.org/resources/) descreve a configuração do delegado. Registre a configuração real em sua máquina; um comando copiado de outra instalação pode seguir um caminho diferente. Para esta verificação, você precisa de uma cópia do seu PNG, ImageMagick instalado, um terminal, um editor de texto simples e um visualizador SVG. Mantenha a fonte inalterada e atribua a cada saída de teste um novo nome de arquivo. Nosso exemplo também teve o Potrace instalado; isso faz parte do ambiente testado, não é uma dependência que toda instalação do ImageMagick necessariamente compartilha. **Ilustração** ![Ilustração de uma fonte PNG passando por um delegado de rastreamento configurado antes da inspeção do SVG salvo](https://perfectvector.com/blog/imagemagick-png-to-svg/delegate-output.webp) *Inspecione a origem, o rastreador configurado e o SVG salvo como estágios separados.* ## 1. Grave a versão instalada e delegue Execute estes comandos em seu terminal: ```bash magick -version magick -list delegate magick -list format ``` Leia a lista de delegados para uma entrada `trace` e anote o programa que ela nomeia. Nossa lista continha esta linha: ```text pnm<= trace "'potrace' --svg --output '%o' '%i'" ``` Essa é uma entrada de configuração, não um comando para colar em seu shell. Ele nomeia Potrace como o programa de rastreamento externo. O SVG que salvamos também continha metadados `Created by potrace 1.16`, vinculando essa configuração à saída observada. A [lista de formatos do ImageMagick](https://imagemagick.org/formats/) é útil para verificar o suporte ao formato, mas leia atentamente suas notas de renderização SVG: as informações de entrada/renderização do Inkscape, RSVG e MSVG não provam qual programa rastreou um PNG em um SVG. Ler SVG e escrever um traço são direções diferentes. ### Por que outra máquina pode se comportar de maneira diferente O [escritor SVG na fonte oficial 7.1.2-32](https://github.com/ImageMagick/ImageMagick/blob/7.1.2-32/coders/svg.c) inclui rotas separadas para suporte ao AutoTrace compilado, um delegado TRACE configurado e um fallback PNG incorporado quando nenhum delegado de rastreamento for encontrado nessa ramificação. É por isso que nem “ImageMagick sempre rastreia” nem “ImageMagick apenas incorpora PNGs” são uma resposta geral confiável. A fonte descreve as filiais disponíveis; nosso comando real estabelece qual resultado obtivemos. Não testamos todas as filiais ou máquinas sem o delegado. A versão acima é nossa versão de teste instalada, não uma afirmação sobre a versão mais recente do ImageMagick. ## 2. Salve um SVG e inspecione o que ele contém Use sua própria cópia PNG permitida. Nosso comando de teste exato foi: ```bash magick color-regions.png traced.svg ``` Substitua `color-regions.png` pelo nome do arquivo de entrada e use um novo nome de saída. Se o comando falhar, retenha o erro e inspecione o programa configurado antes de tentar configurações de renderização não relacionadas. Um delegado listado não prova por si só que seu executável está disponível e funcionando. Abra o SVG salvo em um editor de texto. Procure elementos de forma reais, como ``, qualquer elemento `` e seu conteúdo referenciado, e preenchimentos em caminhos individuais e grupos pai. Um caminho pode herdar um preenchimento preto de um grupo circundante; a cor não precisa aparecer em todas as linhas do caminho. Em nosso arquivo, o grupo pai forneceu `fill="#000000"`, dois elementos de caminho descreviam as formas retidas e não havia nenhum elemento de imagem. Essa é a geometria do caminho real, mas não significa que a paleta original ou todas as regiões sobreviveram. Para um arquivo misto ou baseado em imagem, use o [guia de inspeção de conteúdo raster SVG](https://perfectvector.com/pt-BR/blog/svg-contains-raster-image) em vez de adivinhar apenas pelo zoom. ## O que nosso PNG colorido se tornou nesta instalação Criamos um 320 × 240 RGBA PNG original contendo uma moldura retangular azul marinho com um centro vazio, um círculo dourado e um triângulo verde-azulado em um fundo transparente. Os pixels transparentes tinham amostras RGB brancas. Executamos o comando acima com ImageMagick 7.1.2-32 e instalamos o Potrace 1.16, depois inspecionamos a fonte SVG real e a renderizamos de forma independente. | Verificar | PNG originais | SVG real salvo | | ------------------------------------- | ------------------- | ---------------------------------------- | | Moldura da Marinha | `#17344d` | Geometria preta mantida | | Triângulo verde-azulado | `#347f78` | Geometria preta mantida | | Círculo dourado | `#e5aa39` | Ausente | | Abertura da moldura e espaço exterior | Transparente | Transparente no resultado renderizado | | Estrutura de arquivo | Pixels rasterizados | Dois caminhos, nenhum elemento de imagem | O [manual do Potrace](https://potrace.sourceforge.net/potrace.1.html) explica que a entrada não binária é convertida para preto e branco usando um corte de brilho. Uma rota de rastreamento monocromática não transporta a paleta de origem como regiões coloridas separadas. Nesta execução específica, o círculo dourado claro desapareceu enquanto a moldura e o triângulo mais escuros tornaram-se pretos. Aumentar a resolução de entrada ou alterar o nome do arquivo SVG não pode transformar esse resultado monocromático em um traço colorido. Se as cores tiverem significado, selecione um fluxo de trabalho de rastreamento de cores e inspecione as regiões resultantes. Se você precisar intencionalmente de arte de uma cor, use o [fluxo de trabalho explícito de preparação e rastreamento de PNG do Potrace](https://perfectvector.com/pt-BR/blog/potrace-png-to-svg) para controlar essa tarefa separada. Este era um arquivo de teste de cores original em uma versão instalada, suportado pelo controle quadrado com furo anterior. Foi uma inspeção de arquivo digital, não um teste de importação de editor, impressão ou corte. A contagem de caminhos descreve esta saída; não é uma pontuação de qualidade. ### Mantenha as unidades de tamanho separadas da estrutura do caminho Nosso SVG salvo declarou `width="320.000000pt"`, `height="240.000000pt"` e `viewBox="0 0 320.000000 240.000000"`. Valores numéricos correspondentes não tornam pontos, pixels de origem e coordenadas SVG intercambiáveis. Verifique o tamanho físico pretendido separadamente usando o [fluxo de trabalho de solução de problemas de tamanho de importação de SVG](https://perfectvector.com/pt-BR/blog/svg-imports-wrong-size). ## Escolha a correção que corresponde à saída | Resultado observado | Próxima ação | Verificação | | ---------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | Caminhos pretos, mas você precisa de regiões coloridas | Escolha um fluxo de trabalho de rastreamento de cores | Compare regiões e preenchimentos importantes com o PNG original | | Caminhos pretos são a arte pretendida | Mantenha a rota monocromática; inspecionar detalhes faltantes | Verifique a silhueta e as aberturas necessárias sobre um fundo contrastante | | SVG contém um PNG incorporado em vez das formas que você precisa | Verifique a rota de rastreamento instalada ou use um vetorizador dedicado | Inspecione os objetos e imagens referenciadas do arquivo de substituição | | Erro de comando relacionado ao delegado | Leia o erro e verifique a disponibilidade e configuração do programa nomeado | Repita a mesma pequena entrada permitida depois de corrigir esse problema específico | | Existem caminhos, mas o tamanho está errado em outro aplicativo | Verifique as unidades e as dimensões do documento separadamente | Confirme o tamanho pretendido naquele aplicativo receptor | O erro real do comando e a configuração instalada devem orientar o reparo. Este passo a passo não reproduziu um ambiente executável ausente ou com erros de política, portanto, não prescreve uma correção universal para esses erros. Para arte colorida que ainda precisa de SVG, o PerfectVector fornece um fluxo de trabalho on-line de PNG para vetor. Comece com o PNG original e compare a silhueta da visualização, as regiões de cores e os espaços vazios. As cores exatas da marca ou letras pequenas ainda podem precisar de inspeção e correção; se um contorno crítico não for claro, um redesenho deliberado pode ser o próximo passo mais útil. O [guia de qualidade PNG para SVG](https://perfectvector.com/pt-BR/blog/png-to-svg-without-losing-quality) cobre essas decisões de origem e detalhes. Você terá concluído o diagnóstico quando puder nomear o tipo de saída, identificar a rota de rastreamento relevante e explicar se ela atende às suas necessidades de cores. Mantenha a fonte, o SVG salvo e as notas de versão/configuração juntas. Para testar seu PNG online, [comece gratuitamente com PerfectVector](https://perfectvector.com/pt-BR/convert-png-to-svg) e compare as regiões de cores e aberturas da visualização com o original. ## Perguntas frequentes **O ImageMagick pode converter PNG em caminhos SVG reais?** Sim, quando a compilação e a configuração instaladas fornecem uma rota de rastreamento. Nossa configuração do ImageMagick 7.1.2-32 usou Potrace 1.16 e salvou caminhos reais sem um elemento de imagem. Inspecione sua própria saída em vez de assumir que cada instalação se comporta da mesma maneira. **Por que meu ImageMagick SVG ficou preto e branco?** Um delegado de rastreamento monocromático configurado pode explicar esse resultado. Em nosso teste, o Potrace produziu caminhos pretos a partir das regiões mais escuras e omitiu o círculo dourado claro. Verifique a lista de delegados e os preenchimentos salvos antes de escolher uma alternativa de rastreamento de cores. **Uma entrada SVG na lista de formatos garante o rastreamento de cores?** Não. O suporte ao formato por si só não identifica a implementação do rastreamento de saída nem prova que ele mantém sua paleta. Leia a configuração do delegado instalada e inspecione o SVG salvo. **Devo alterar as configurações de RSVG ou MSVG para restaurar as cores PNG?** Primeiro identifique a rota de rastreamento de saída. As configurações de renderização SVG e o programa que rastreia um PNG respondem a perguntas diferentes. Nosso resultado monocromático veio através de um delegado de traçado do Potrace, então a próxima decisão foi se um traço monocromático se adequava à obra de arte. ## Fontes 1. [Recursos do ImageMagick](https://imagemagick.org/resources/) — arquivos de configuração e delegados externos. 2. [Formatos de imagem ImageMagick](https://imagemagick.org/formats/) — listagens de formatos instalados e notas de renderização SVG. 3. [ImageMagick 7.1.2-32 gravador SVG](https://github.com/ImageMagick/ImageMagick/blob/7.1.2-32/coders/svg.c) — rastreamento fixado por versão e ramificações de imagem incorporada. 4. [Manual do Potrace](https://potrace.sourceforge.net/potrace.1.html) — interpretação de entrada monocromática e comportamento de rastreamento. ## Explore - [Read the HTML article](https://perfectvector.com/pt-BR/blog/imagemagick-png-to-svg) - [Conversão em lote PNG2SVG: confira o ZIP baixado](https://perfectvector.com/pt-BR/blog/png2svg-batch-convert.md) - [Vectorization Org: confira o traçado em preto e branco](https://perfectvector.com/pt-BR/blog/vectorization-org-black-white.md) - [Product facts](https://perfectvector.com/product-facts.md) - [FAQ](https://perfectvector.com/faq.md) - [Pricing and credits](https://perfectvector.com/pricing.md)