Importar SVG no OpenSCAD: crie uma forma dimensionada para extrusão
Importe geometria SVG no OpenSCAD, confira furos e dimensões e faça a extrusão de uma forma dimensionada. Entenda por que um centro branco pode precisar de reparo para virar um furo real.
Nesta página
A importação de SVG no OpenSCAD começa com import("emblem.svg");. Isso carrega uma forma bidimensional. Para criar um sólido, envolva a importação em linear_extrude(). Antes de adicionar altura, confira o contorno, os espaços vazios e a largura desejada. Um desenho que parece correto no navegador ainda pode conter um retângulo de fundo ou uma forma branca onde você esperava um furo.
Este guia separa essas verificações usando um emblema de flor traçado. A imagem original, a saída real do PerfectVector e o SVG explicitamente editado mostram o que mudou antes da etapa CAD. A geometria do SVG foi inspecionada; os exemplos de OpenSCAD abaixo são instruções para executar no seu arquivo, não resultados de um modelo testado no OpenSCAD.
Comece pela forma que deseja fabricar
Use o arquivo vetorial original se o tiver. Traçar novamente uma captura de um SVG existente acrescenta trabalho e pode alterar seu contorno. Se a única imagem original é um PNG, JPG ou imagem gerada, prepare um SVG para impressão 3D com o PerfectVector e inspecione os traçados baixados antes de importá-los no CAD.
Para uma primeira extrusão, escolha uma silhueta robusta com uma abertura generosa. Deixe letras pequenas, pontes estreitas, pontos separados e textura decorativa para uma versão posterior. O tamanho do desenho na tela não estabelece se esses elementos sobreviverão no tamanho final da peça.
Seu arquivo de trabalho deve responder a três perguntas:
- Quais regiões devem virar material sólido?
- Quais regiões devem permanecer vazias através de toda a espessura da peça?
- Qual deve ser a largura do contorno final em milímetros?
O fluxo de imagem para SVG para impressão 3D mais amplo aborda a escolha da imagem original. Aqui, a tarefa é levar esse contorno ao OpenSCAD com geometria e dimensões intencionais.
Um centro branco não é automaticamente um furo
Convertemos uma flor raster preparada de 1.254 × 1.254 pelo PerfectVector e inspecionamos o SVG sem alterações. Ele continha três traçados fechados: um retângulo de fundo quase branco, uma silhueta preta de flor e um círculo central quase branco. Não havia imagens raster incorporadas.
O centro parecia vazio em uma página branca, mas era uma forma pintada separada. Remover apenas esse círculo exporia a flor preta sólida por baixo. Não abriria um furo.
Em um SVG de trabalho separado, removemos o fundo verificado e colocamos os contornos originais da flor e do círculo em um traçado composto com regra de preenchimento par-ímpar. As coordenadas dos contornos permaneceram iguais. A renderização desse SVG editado confirmou pixels transparentes no centro e fora da flor, com uma pétala preta opaca entre eles. Isso verifica o espaço negativo do SVG; não comprova um sólido válido no OpenSCAD nem uma peça imprimível.

O importador do OpenSCAD usa a geometria de formas fechadas em vez de tratar sua aparência pintada como instrução de modelagem. Seu suporte documentado também tem limites para texto, recorte e mascaramento. Na preparação para CAD, transforme o material desejado em traçados explícitos e faça os furos desejados serem recortes reais. Veja a documentação de importação de SVG.
Em um editor vetorial, trabalhe em uma cópia: identifique a silhueta externa e a forma interna, subtraia a forma interna da externa e salve o resultado. Coloque temporariamente um fundo contrastante atrás dele para conferir se a abertura é transparente. Remova esse fundo temporário antes de salvar a cópia para CAD. Se a silhueta tiver várias aberturas, inspecione cada uma.
Importe o SVG preparado como geometria 2D
Salve o arquivo pronto para CAD como emblem-cad.svg ao lado do documento do OpenSCAD. Comece apenas com isto:
import("emblem-cad.svg", center = true);Visualize a importação e olhe de cima. Você deve ver o contorno e a abertura desejados, sem um retângulo ao redor da arte. center = true centraliza a caixa delimitadora importada; não repara traçados nem descarta formas indesejadas. A referência de importação SVG do OpenSCAD descreve esse parâmetro e seu comportamento padrão.
Se a importação estiver vazia, confirme primeiro o nome do arquivo e sua localização relativa e leia as mensagens do console. Abra o SVG em um editor vetorial para conferir se contém formas reais em vez de uma imagem incorporada. A extensão .svg, sozinha, não comprova que a figura foi traçada.
Se o centro ficar preenchido, volte ao SVG de trabalho. Alterar sua cor visível para branco não é o reparo. Se aparecer um retângulo, inspecione a geometria de fundo antes de tentar outra configuração de extrusão.
Defina uma largura intencional antes de adicionar altura
Os SVGs carregam dimensões pelo tamanho do documento, unidades e sistema de coordenadas. O parâmetro dpi do OpenSCAD se aplica quando dimensões relevantes não têm unidades explícitas ou estão ausentes; não é uma correção universal de escala. Não mude o DPI repetidamente até a forma parecer plausível por acaso. O manual de importação explica quando o parâmetro se aplica.
Para um emblema cuja largura total deve ser 40 mm, defina essa dimensão explicitamente:
resize([40, 0, 0], auto = true)
import("emblem-cad.svg", center = true);Aqui, resize() define a dimensão X como 40, enquanto auto = true redimensiona proporcionalmente as dimensões não especificadas. Isso difere de scale(), que multiplica as dimensões existentes. A referência de transformações documenta ambas as operações.
Essa largura só é útil após remover a geometria de fundo indesejada: caso contrário, você pode estar dimensionando o retângulo ao redor em vez do emblema. Se já precisa que o arquivo preserve um tamanho físico conhecido entre aplicativos, corrija as unidades do documento e verifique-as em vez de sobrescrever rotineiramente as dimensões de cada importação. O guia de SVGs importados no tamanho errado explica essa distinção.
Quarenta milímetros é uma dimensão de exemplo, não um mínimo recomendado. No tamanho escolhido, confira a ponte mais estreita, a abertura central e quaisquer ilhas separadas em relação às necessidades da impressora, do material e da peça.
Faça a extrusão, renderize e inspecione o modelo exportado
Quando o contorno 2D e a largura estiverem corretos, adicione uma extrusão reta:
linear_extrude(height = 3)
resize([40, 0, 0], auto = true)
import("emblem-cad.svg", center = true);Leia de dentro para fora: importe a forma preparada, defina sua largura e dê a ela 3 mm de altura. Esse é o padrão básico de extrusão SVG no manual do subsistema 2D. A altura é outra escolha de exemplo, não uma recomendação estrutural.
Mantenha este primeiro modelo simples. Torção, afunilamento, uniões ou posicionamento em superfície adicionais podem dificultar perceber se a importação original estava correta. Confira as vistas superior e lateral: o furo deve permanecer aberto através de toda a extrusão, e o contorno esperado deve ter altura.
Execute uma renderização completa com F6, confira os erros e exporte o modelo como STL quando esse for o formato necessário ao próximo aplicativo. O guia de exportação STL distingue renderização de exportação. Uma prévia bem-sucedida não é a verificação final de aceitação.
Abra o arquivo exportado no fatiador. Verifique suas dimensões gerais, a abertura e as camadas ao longo da peça. Peças decorativas separadas podem ser geometria válida e ainda inadequadas ao objeto pretendido. Um SVG limpo e uma renderização concluída não tomam essa decisão de design por você.
Diagnostique a etapa que falha
| O que você vê | Primeira coisa a inspecionar | Próxima ação útil |
|---|---|---|
| Um retângulo sólido | Um traçado de fundo vetorizado | Remova o fundo verificado no SVG de trabalho. |
| O centro fica preenchido | Uma sobreposição branca em vez de um furo real | Subtraia o centro da silhueta e confira novamente a transparência. |
| O contorno tem tamanho errado | Dimensões do documento, unidades ou limites indesejados | Confira as unidades do arquivo original ou defina uma largura proporcional intencional. |
| Uma linha desaparece ou muda de espessura | Geometria de traçado aberto ou fechado | Converta o material desejado em formas preenchidas explícitas. |
| A prévia parece aceitável, mas a renderização falha | Erros do console e interseções suspeitas de traçados | Simplifique para a importação isolada e repare a geometria do arquivo original. |
| O fatiador perde detalhes pequenos | Tamanho dos elementos na escala final | Amplie ou simplifique o design e inspecione as camadas novamente. |
O guia de problemas de extrusão de SVG aprofunda contornos quebrados e outros reparos de geometria. Mantenha um SVG bruto junto da cópia de trabalho para distinguir quais mudanças vieram da conversão e quais você fez para CAD.
Perguntas frequentes
O OpenSCAD pode importar um SVG diretamente?
Sim. Use import("emblem.svg"); para carregar a geometria 2D aceita. Confira os traçados e dimensões antes de envolver a importação em linear_extrude() para criar uma forma 3D.
Por que o furo do meu SVG fica sólido no OpenSCAD? O aparente furo pode ser um objeto preenchido de branco sobre uma silhueta sólida. Prepare um recorte real em um SVG de trabalho e inspecione-o sobre um fundo contrastante antes de importar novamente.
Como controlo o tamanho de um SVG importado?
Confira primeiro as dimensões e unidades do documento. Para definir uma largura total escolhida, aplique resize([40, 0, 0], auto = true) antes da extrusão, substituindo 40 pela largura desejada. Remova a geometria de fundo indesejada antes de dimensionar os limites.
Converter uma imagem para SVG a deixa pronta para imprimir? Não. A conversão fornece traçados para inspecionar e preparar. Você ainda precisa de geometria fechada adequada, furos e dimensões intencionais, uma extrusão válida e uma verificação no fatiador para seu design e processo específicos.
Fontes
- Referência de importação SVG do OpenSCAD — Geometria aceita, parâmetros de importação, unidades e limitações.
- Transformações do OpenSCAD — Redimensionamento proporcional, escala e ordem de transformação.
- Subsistema 2D do OpenSCAD — Extrusão linear de geometria SVG importada.
- Exportação STL do OpenSCAD — Renderização completa e etapa de exportação.
Se o emblema ainda existe apenas como pixels, converta a arte raster em traçados SVG e confira uma silhueta e uma abertura antes de montar o modelo no OpenSCAD. Mantenha o vetor original quando ele já fornecer as formas necessárias.
Mais do blog

Importar SVG no Tinkercad: de traçados 2D a formas 3D
Prepare um SVG para o Tinkercad, defina seu tamanho e confira regiões preenchidas, furos e altura. Corrija erros de importação antes de tratar a extrusão como modelo imprimível.

PNG para SVG no Bambu Studio: importações multicoloridas limpas
Converta um PNG em SVG para o Bambu Studio, preserve regiões de cor úteis, confira traçados fechados e aberturas e verifique tamanho e extrusão antes de fatiar o modelo.