Comandos de linha de comando (com hífen)

O que é um comando com hífen

O hífen na frente do nome é a convenção do próprio CAD para “a versão sem caixa de diálogo”, como em -LAYER ou -INSERT. O CapCad segue a convenção: onde CAPCAD_SIGN_INSERT abre um formulário, -CAPCAD_SIGN_INSERT faz as mesmas perguntas na linha de comando.

Isso importa em três situações:

1. Scripts .scr e arquivos de lote, que só sabem enviar texto para a linha de comando.
2. Macros de ribbon, menu e teclado, que também são texto.
3. Automação de fora do CAD — outro programa mandando comandos para o desenho aberto.

Todos os comandos com hífen do CapCad rodam só no AutoCAD.

Os oito comandos com hífen

Como ler as tabelas de perguntas

• Prompt é o texto exato que aparece na linha de comando.
• Uma palavra-chave entre colchetes é uma opção digitável; como em qualquer comando do CAD, as letras maiúsculas do início bastam (I para Implantar, D para Detectar).
• Enter aceita o padrão indicado; Esc cancela o comando inteiro.
• Números aceitam vírgula ou ponto como separador decimal.

-CAPCAD_SIGN_INSERT — inserir uma placa

Insere uma placa referenciada ao eixo, com estaca, lado e afastamento calculados — o mesmo caminho do Insere Vertical, sem o formulário.

Exige um eixo ativo. Sem ele, o comando responde Sem eixo ativo. e termina. Defina o eixo antes, com -CAPCAD_PROJECT_SET ou pelo Gerenciador de eixos.

As perguntas 8 e 9 formam um laço: a cada volta você informa um par nome/valor, até responder Enter no nome. Os pares vão para os atributos da placa inserida.

Detalhes que valem saber:

• A opção PontoClicado não insere nada. Ela lê o ponto e sai. Para inserir sem eixo, use CAPCAD_SIGN_INSERT_SIMPLE, que pede o código e insere no ponto clicado.
• Detectar é a resposta de reserva. Respondendo com Enter, com D, ou com qualquer texto que não seja um número, o comando mede a distância do ponto clicado até o pé de perpendicular no eixo (até um limite de 1000 unidades) e usa esse valor como afastamento.
• Um valor vazio no passo 9 também encerra o laço — depois de gravar o atributo com valor vazio. Para continuar informando atributos, dê a cada um um valor não vazio.
• Os prompts estão em português em qualquer idioma do produto.

Exemplo de script

Uma placa R-1, a implantar, 3,50 m à direita do eixo, com o atributo de suporte preenchido:

-CAPCAD_SIGN_INSERT
R-1
Implantar
Eixo
125430,74580
Identificar
3.5
Não
SUP_COD
SP-2

(uma linha em branco para encerrar o laço de atributos)

-CAPCAD_SIGN_FILL — validar o dwg da placa

Roda a validação do desenho de uma placa — hachuras de ByLayer para ByColor, moldura, milímetros para metros, ponto de inserção, INSBASE, zoom extents e gravação — sem abrir o formulário. A validação em si está descrita em Corrigir sinalização vertical.

Este comando não faz nenhuma pergunta. Os parâmetros vêm da última configuração do formulário:

• Se o formulário Validar e Publicar Placa estiver aberto, o comando usa exatamente o que está na tela.
• Se estiver fechado, o comando monta uma cópia invisível dele e usa as preferências gravadas: política de moldura (layer 0 / por cor / por layer especificado), Renovar borda, Desenhar borda se não existente e as dimensões forçadas de largura e altura.

Três coisas a considerar antes de colocá-lo num script:

• O desenho é sempre salvo. Ao montar o formulário invisível, a caixa Salvar é ligada, independentemente do que estiver gravado nas preferências.
• Ele não é totalmente silencioso. Na primeira execução da vida da instalação, uma caixa pergunta se você quer salvar a placa ao final; se houver largura ou altura forçadas, outra caixa pede confirmação. Rode o comando uma vez à mão antes de automatizá-lo, para que essas perguntas fiquem respondidas.
• A caixa Todos dwg's abertos nunca vem ligada num formulário recém-montado: pela linha de comando, o comando valida apenas o desenho corrente. Para validar todos os desenhos abertos, use o formulário.

-CAPCAD_MARKING_STRIP_CONTRAN — desenhar um trecho do eixo como faixa

Extrai o trecho do eixo ativo entre dois pontos, opcionalmente o afasta, e o desenha como polyline numa layer que você informa. É a versão mínima e scriptável do desenho de faixa: não tem catálogo CONTRAN, cadência, tacha nem cor — quem escolhe tudo isso é você, ao escrever o nome da layer.

Exige um eixo ativo. Sem ele: Sem eixo ativo.

O que acontece depois:

1. O trecho do eixo entre os dois pontos é identificado. Se não for possível: Trecho não identificado no eixo.
2. Com afastamento diferente de zero, o trecho é deslocado. Positivo é para a esquerda do sentido de estaqueamento; negativo, para a direita.
3. A layer é criada se não existir, e a polyline é desenhada nela.
4. Se a layer teve de ser criada, o comando avisa: <layer> wasn't defined.

Cuidados importantes:

• A layer é criada crua. A camada nasce com a cor e o tipo de linha padrão, sem a cor da sigla nem o linetype da cadência, e sem nenhuma validação da gramática do nome. Se o que você quer é uma faixa CONTRAN completa — com cor, cadência, tachas e material —, use o comando com formulário, descrito em Faixas CONTRAN, ou o Desenhar Faixa Viária.
• Só uma polyline é desenhada por execução. Faixas duplas (LFO-3, LFO-4) e tachas não saem daqui.
• Os dois primeiros prompts estão em inglês, e os dois seguintes em português — em qualquer idioma do produto.

Exemplo de script

Um bordo direito, 3,60 m à direita do eixo, entre dois pontos conhecidos:

-CAPCAD_MARKING_STRIP_CONTRAN
SINA_HOR_BR_LBO
-3.6
125430,74580
125630,74612

Notas

• Nenhum destes comandos abre nada e nenhum guarda o que você respondeu. Cada execução recomeça do zero — com a exceção do -CAPCAD_SIGN_FILL, que lê as preferências do formulário.
• Esc cancela o comando inteiro, em qualquer pergunta; nada do que já foi respondido é aproveitado.
• Para repetir a operação em muitos desenhos, combine estes comandos com o Script em lote, que abre cada arquivo, roda o script e fecha.
• Se o comando responder “Sem eixo ativo”, o problema é o projeto, não o comando: veja O eixo e o Gerenciador de eixos.

Veja também

• Insere Vertical — a versão com formulário da inserção de placa.
• Corrigir sinalização vertical — a validação do dwg da placa, controle a controle.
• Faixas CONTRAN — a versão com formulário do desenho de faixa.
• Script em lote — rodar um script sobre vários desenhos.
• Pontos de entrada e modos — os comandos que só abrem alguma coisa.