CapVectorize — imagem para CAD

Comando: CAPCAD_RASTER_TRACE, CAPCAD_RASTER_TRACE_RUN Atualizado 2026-09-03 Também em: English
Pergunte sobre esta página
Responde a partir desta página, em português. Assistente geral
Comandos CAPCAD_RASTER_TRACE abre a janela de opções. CAPCAD_RASTER_TRACE_RUN é o comando que vetoriza — disparado pelo botão Executar da janela, e digitável desde que a janela esteja aberta
Atalhos nenhum
Ribbon nenhum. O comando não tem botão: digite o nome na linha de comando
Categoria sem categoria
Formulário CapVectorize — Imagem para CAD, não modal
CADs AutoCAD e Civil 3D apenas. Não existe no BricsCAD, no GstarCAD, no ZWCAD nem no ARES Commander — nem como aviso de "em breve"
Requisitos o runtime nativo do OpenCV, baixado uma única vez pela própria janela (cerca de 65 MB). Ver O download de uma vez só

Um logotipo, um croqui escaneado ou uma placa em PNG viram geometria de verdade — não uma imagem colada por cima do desenho. O que sai é preenchimento vetorial dentro de um bloco: sem arquivo externo, sem OLE, sem link que se perde ao mandar o dwg.

  • Nada de referência externa. A imagem não é anexada: ela é convertida. O dwg viaja sozinho.
  • Cores separadas, uma por vez. Até dezesseis cores são agrupadas automaticamente e cada grupo vira uma região com a sua própria cor, o fundo descartado sozinho.
  • Ilhas respeitadas. O buraco do "O" continua sendo buraco: os contornos internos entram como ilhas do preenchimento, não como manchas por cima.
  • Escala em metros na hora. Você diz a largura que o desenho deve ter e a altura sai pela proporção da imagem — nada de escalar bloco depois no olho.
  • Um botão de fidelidade. A suavização controla quantos vértices sobram: do contorno cru ao contorno limpo, sem editar vértice.
  • Fecha vãos de traço fino. Um filtro opcional emenda falhas de digitalização antes de contornar, para o traço não sair picotado.

O que faz

CAPCAD_RASTER_TRACE apenas abre a janela de opções. Ela é não modal e única por sessão.

CAPCAD_RASTER_TRACE_RUN é quem trabalha. Ele lê as opções da janela aberta — sem janela, responde IMGTRACE: open the dialog first. —, confere que a imagem existe e que o runtime está instalado, pede o ponto de inserção e roda a conversão.

A conversão tem cinco etapas:

  1. Decodificar a imagem (PNG, JPG, BMP ou TIFF).
  2. Separar em máscaras. Com Cores = 1, um limiar automático de Otsu sobre a imagem em tons de cinza: o que é escuro vira tinta, o que é claro vira fundo, e sai uma única região preta. Com Cores ≥ 2, as cores da imagem são agrupadas por k-means no número de grupos pedido, e cada grupo vira uma máscara; o grupo que ocupa a maior parte da borda de um pixel da imagem é considerado o fundo e é descartado.
  3. Fechar vãos, se pedido: uma operação morfológica de fechamento com um elemento elíptico, antes de contornar.
  4. Contornar e simplificar. Os contornos são extraídos com a hierarquia de dois níveis — contorno externo e seus filhos, que são as ilhas — e simplificados pelo algoritmo de Douglas-Peucker.
  5. Converter para o desenho: pixel × escala, com o eixo Y invertido, de modo que a imagem fique de pé com a origem no canto inferior esquerdo.

O resultado vai para um bloco novo, e uma referência desse bloco é inserida no ponto que você escolheu. A linha de comando informa quantas regiões foram traçadas.

Fluxo de trabalho

  1. Rode CAPCAD_RASTER_TRACE.
  2. Procurar… (2) e escolha a imagem.
  3. Ajuste Cores (3), Largura do desenho (4), Suavização (5) e Fechar vãos (6).
  4. Executar (9). Na primeira vez, a janela pergunta se pode baixar o runtime do OpenCV e mostra o progresso; depois disso, vai direto.
  5. O AutoCAD pede Insertion point (image lower-left). Clique.
  6. Confira o resultado. Não gostou? Mude a suavização ou o número de cores e execute de novo — cada execução cria um bloco novo.

O formulário

Sem captura de tela. Os números abaixo seguem a ordem em que os controles aparecem, de cima para baixo.

# Controle O que faz
1 Imagem: O caminho do arquivo. É editável: pode ser colado à mão. O comando recusa a execução se o arquivo não existir
2 Procurar… Abre a caixa de escolha de arquivo, filtrando *.png, *.jpg, *.jpeg, *.bmp, *.tif e *.tiff
3 Cores: De 1 a 16; começa em 1. Com 1, o traço é monocromático (limiar de Otsu, tinta escura sobre fundo claro, saída preta). Com 2 ou mais, as cores são agrupadas em tantos grupos quanto você pedir, contando o fundo: para um desenho com duas cores sobre branco, peça 3
4 Largura do desenho (m): A largura que a imagem inteira vai ter no desenho, em unidades do desenho. De 0,001 a 1 000 000, três casas decimais; começa em 1. A altura não é pedida: sai pela proporção da imagem
5 Suavização (‰): A tolerância da simplificação de contorno, em milésimos da diagonal da imagem em pixels. De 0 a 50, passo de 0,5, uma casa decimal; começa em 4. Maior = menos vértices e contorno mais grosseiro; o valor efetivo nunca é menor que 1 pixel
6 Fechar vãos (px): O tamanho, em pixels, do elemento de fechamento morfológico aplicado antes de contornar. De 0 a 20; começa em 0, que desliga o filtro. Serve para emendar falhas finas de digitalização
7 barra de progresso Só aparece durante o download do runtime
8 linha de estado Só aparece durante o download: "Preparing download…", o percentual e os megabytes, e "OpenCV runtime ready." ao final
9 Executar Confere a imagem, provisiona o runtime se preciso e dispara CAPCAD_RASTER_TRACE_RUN. Fica desabilitado, junto com (2) e (10), durante o download
10 Fechar Fecha a janela

O que é desenhado

Cada região vira um hatch sólido com o contorno externo como laço externo e cada ilha como laço interno, para o preenchimento respeitar os furos. A cor do hatch é a cor RGB do grupo (preto puro no modo monocromático) — cor verdadeira, não índice.

Todos os hatches de uma execução são criados dentro de um único bloco, chamado CAPCAD_RASTER_TRACE; se já existir um bloco com esse nome, o novo recebe o sufixo _1, _2, e assim por diante. A referência do bloco é inserida no ponto escolhido, que corresponde ao canto inferior esquerdo da imagem.

Os hatches herdam os padrões do desenho — entre eles o layer corrente no momento da execução. Não há um layer próprio do comando: defina o layer que quiser antes de executar.

Regiões muito pequenas são descartadas. Manchas e furos com área menor que 0,02 % da área da imagem são ignorados, o que limpa o ruído de digitalização. Esse limite não é configurável.

Como as opções se combinam

Cores é o que mais muda o resultado. No modo monocromático, o limiar é automático e decide sozinho o que é tinta: funciona bem em desenho preto sobre branco e mal em foto. No modo de cores, o número que você pede inclui o fundo, e o grupo do fundo é achado pela borda da imagem — uma imagem cujo fundo não encoste na borda faz o comando descartar o grupo errado.

A suavização é relativa à imagem, não ao desenho. Ela é uma fração da diagonal em pixels, de modo que o mesmo valor dá um resultado parecido em imagens de tamanhos diferentes. Uma imagem de 1000 × 1000 px tem diagonal de cerca de 1414 px; a 4 ‰, a tolerância é de cerca de 5,7 px. Aumentar a Largura do desenho não muda a fidelidade — muda só a escala do que sai.

Fechar vãos age antes de contornar, sobre a máscara, e não sobre o contorno já traçado. Ele emenda falhas e tapa furos menores que o elemento, sem mudar a espessura do traço; em compensação, arredonda os cantos reentrantes e cola detalhes que estejam a menos de um elemento de distância. Comece em 0 e suba de 2 em 2, só até o traço parar de sair picotado.

O download de uma vez só

O contorno é feito pelo OpenCV, cuja biblioteca nativa não acompanha a instalação do CapCad — ela pesa cerca de 65 MB e seria peso morto para quem nunca usa o comando. Na primeira execução, o Executar pergunta:

Image tracing requires the OpenCV runtime (about 65 MB) to work. It will be downloaded once and reused from then on. Download it now?

Respondendo Sim, o arquivo é baixado do servidor do CapCad com barra de progresso, é verificado antes do uso e é gravado na pasta de instalação do CapCad. Um arquivo que falhe na verificação é apagado e a operação falha. Da segunda vez em diante, a checagem é instantânea e o comando vai direto ao trabalho.

Se você digitar CAPCAD_RASTER_TRACE_RUN antes de o runtime existir, o comando não baixa nada: responde IMGTRACE: OpenCV runtime not available — use the dialog's Run button to download it. O download só acontece pelo botão.

Lembrado entre sessões

O runtime do OpenCV, uma vez baixado, fica na pasta do CapCad e vale para todas as sessões seguintes — inclusive depois de fechar o CAD. É a única coisa que persiste.

As opções da janela, não: elas permanecem enquanto a janela ficar aberta e voltam aos padrões quando ela é fechada e reaberta (1 cor, largura 1, suavização 4, fechar vãos 0, campo de imagem vazio).

Notas

  • É uma conversão representativa, não métrica. O contorno segue a borda dos pixels e depois é simplificado; ele não recupera a geometria original de quem desenhou a imagem. Para cotar, meça no original.
  • Não sai polyline: sai hatch. O que você recebe são regiões preenchidas. Não há opção de gerar só o contorno, e o hatch não é associativo.
  • O bloco não é apagado entre execuções. Cada rodada cria um bloco novo com sufixo numérico; blocos de tentativas descartadas ficam na tabela de blocos do desenho até serem limpos com PURGE.
  • Nenhum layer próprio. Diferentemente do resto do CapCad, o comando não cria nem escolhe layer: os hatches ficam no layer corrente.
  • Uma imagem grande custa memória e tempo. A separação por k-means percorre todos os pixels; para um scan em alta resolução, reduza a imagem antes.
  • Fotografia costuma decepcionar. O comando foi feito para desenho, logotipo e símbolo — coisas de cor chapada. Uma foto, com gradiente e sombra, produz dezenas de regiões recortadas.
  • Toda a interface do comando está em inglês nas mensagens: a caixa do download, os avisos de erro e as respostas da linha de comando. Só os rótulos da janela estão traduzidos.
  • As mensagens da linha de comando têm o prefixo IMGTRACE, embora o comando se chame CAPCAD_RASTER_TRACE.