| 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:
- Decodificar a imagem (PNG, JPG, BMP ou TIFF).
- 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.
- Fechar vãos, se pedido: uma operação morfológica de fechamento com um elemento elíptico, antes de contornar.
- 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.
- 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
- Rode
CAPCAD_RASTER_TRACE. - Procurar… (2) e escolha a imagem.
- Ajuste Cores (3), Largura do desenho (4), Suavização (5) e Fechar vãos (6).
- Executar (9). Na primeira vez, a janela pergunta se pode baixar o runtime do OpenCV e mostra o progresso; depois disso, vai direto.
- O AutoCAD pede Insertion point (image lower-left). Clique.
- 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 chameCAPCAD_RASTER_TRACE.