ConstructCraft

A interface: ribbon, comandos e paleta

English version: interface.md.

A janela do ConstructCraft segue a disposição que usuários de CAD e BIM de desktop esperam. A barra de acesso rápido fica no canto superior esquerdo. Abaixo dela está o ribbon, uma fileira de abas com grupos de botões. Em seguida vem a barra de opções da ferramenta ativa. O navegador de projeto e as propriedades ficam encaixados à esquerda, as vistas ocupam as abas no centro e a barra de status fica embaixo. Com muitas vistas abertas, Fechar vistas inativas (na barra de acesso rápido e em Vista → Janelas) fecha todas as abas menos a ativa, e o clique direito numa aba oferece Fechar as outras vistas.

Comandos e suas dicas

Todo botão do ribbon e da barra de acesso rápido executa um comando da interface. O mesmo vale para cada atalho de duas letras e cada item da paleta de comandos. Cada comando define, num só lugar:

• seu nome e ícone;
• seu atalho: uma combinação com Ctrl ou duas letras digitadas com o foco numa vista;
• uma descrição do que faz;
• o comando do motor que faz a alteração. Scripts, a linha de comando ccad e o servidor MCP chamam esse mesmo comando (veja o guia de automação);
• se ele pode rodar agora e, se não puder, por quê.

Passe o mouse sobre um botão para ver a dica:

Mover  [MV]
Move os elementos selecionados de um ponto base até um destino.
Indisponível: Selecione os elementos antes de usar a ferramenta
Comando do motor: elements_move

Botões que não podem rodar ficam acinzentados, e a dica explica o motivo. Motivos comuns são “nada para desfazer”, “selecione os elementos primeiro”, “abra uma folha para exportá-la”, “selecione um texto” e “copie elementos primeiro”. Um atalho digitado quando o comando não pode rodar mostra o mesmo motivo na barra de status.

Ícones e selos

Os ícones têm dois tons: os traços na cor do texto e os preenchimentos suaves no tom de destaque do tema. Um pequeno selo no canto inferior direito indica o tipo de ação do comando:

Selo	Significado	Exemplos
+ verde	cria algo novo	nova planta de piso ou de forro, vista 3D, legenda, vista de desenho, tabela, folha, novo componente
seta azul para baixo	traz dados de um arquivo	Importar IFC, Importar CAD, Carregar componente
seta azul para cima	grava dados num arquivo	Exportar PDF, Exportar SVG, Exportar imagem, Exportar DXF
− vermelho	remove algo	Excluir

A ferramenta selecionada aparece realçada na cor de destaque. Comandos indisponíveis ficam acinzentados, inclusive o selo.

Recolher o ribbon

Para dar mais espaço às vistas, recolha o ribbon até os títulos das abas. Qualquer uma destas ações recolhe o ribbon ou o expande de novo:

• Ctrl+F1;
• um clique duplo em qualquer aba;
• a seta no fim da fileira de abas, à direita.

Com o ribbon recolhido, um clique numa aba mostra o painel dela por cima das vistas. O painel fecha quando um comando é executado, quando você aperta Esc ou clica em outro lugar, ou quando clica de novo na mesma aba. Se o ribbon começa recolhido é definido em Preferências → Interface.

Janelas estreitas

Quando a janela é mais estreita que os grupos de uma aba, os grupos rolam de lado em vez de serem cortados. Aparecem setas nas duas pontas da fileira: clique nelas para rolar, ou use a roda do mouse. Cada seta fica acinzentada ao chegar à sua ponta.

Paleta de comandos

Ctrl+Shift+P abre a paleta de comandos, assim como a lupa no fim da fileira de abas, à direita. Digite parte do que procura. A busca ignora maiúsculas e acentos (“niveis” encontra “Níveis”), e todas as palavras digitadas precisam aparecer. A paleta encontra:

• comandos da interface, pelo nome, pela descrição ou pelo atalho (digitar WA encontra Parede);
• plantas a criar para cada nível (“Planta de piso: Térreo”) e tabelas para cada categoria;
• vistas a abrir (“Abrir vista: …”);
• comandos do motor (level_create, elements_list, type_set…), em fonte monoespaçada.

Use ↑ e ↓ para escolher e Enter para executar, ou clique num item. Esc fecha a paleta. Um comando indisponível continua na lista, acinzentado, com o motivo no lugar da descrição.

Executar comandos do motor

Escolher um comando do motor abre um formulário com sua descrição e seus argumentos em JSON, já com os campos obrigatórios:

{
  "elevation": 9.0,
  "name": "Cobertura"
}

Executar (ou Ctrl+Enter) roda o comando no projeto aberto e mostra o resultado ou a mensagem de erro. Uma alteração é um passo de desfazer e é gravada enquanto uma macro está gravando, como qualquer outra. Voltar (ou Esc) retorna à busca. Os argumentos são os mesmos dos scripts e da referência de comandos. Comprimentos estão em metros, ângulos em graus, pontos são [x, y], e níveis, tipos, vistas e materiais podem ser indicados pelo id ou pelo nome.

Os comandos de arquivo do motor (project_open, project_save, ifc_import, ifc_export, sheet_export, view_export…) não aparecem aqui. Os comandos da interface correspondentes, nas abas Arquivo e Inserir e na paleta, cuidam dos arquivos pelos diálogos de sempre.

Teclado

Tecla	Ação
Ctrl+Shift+P	Paleta de comandos
Ctrl+F1	Recolher / expandir o ribbon
Ctrl+,	Preferências
Ctrl+N / Ctrl+O / Ctrl+S / Ctrl+Shift+S / Ctrl+W	Novo / Abrir / Salvar / Salvar como / Fechar projeto
Ctrl+Z / Ctrl+Y	Desfazer / Refazer
Ctrl+X / Ctrl+C / Ctrl+V	Recortar / Copiar / Colar
Delete	Excluir a seleção
Esc	Cancelar a operação, sair da ferramenta, limpar a seleção
Backspace	Ao desenhar uma sequência de paredes, vigas, tubos ou eletrodutos: desfaz o último segmento e continua do início dele (Ctrl+Z também; Ctrl+Y o refaz); o último ponto de um guarda-corpo
Espaço	Girar ou inverter a seleção ou o elemento sendo posicionado

As teclas de duas letras funcionam com o foco numa vista e nenhum campo de texto em edição. O README lista todas elas, e cada dica mostra também o seu atalho.

Selecionar em vistas 2D

Um clique escolhe o elemento sob o cursor (Ctrl soma ou retira). Um arrasto que começa no papel vazio, ou dentro de uma laje, de um hachurado ou de outro preenchimento, desenha uma caixa de seleção: arrastada para a direita é uma janela e pega os elementos inteiramente dentro dela (linhas, preenchimentos e textos); para a esquerda é um cruzamento, tracejado e verde, e pega também os que ela corta ou em que está: uma parede cortada entre as pontas, uma laje em volta da caixa, um texto ancorado nela. Áreas de ambiente e desenhos importados não entram por cruzamento (uma janela em volta deles os pega). Ctrl mantém a seleção atual e soma a ela. Um arrasto que começa na linha de um elemento, ou num elemento já selecionado, o move (Ctrl+arrastar copia).

Os identificadores de portas, janelas, vigas, pilares e sapatas podem ser arrastados para outro lugar com a ferramenta Selecionar (o cursor vira uma mão sobre eles). O identificador mantém o texto e ganha uma linha de chamada até o elemento; cada planta guarda as posições dos seus identificadores (uma planta duplicada começa com as da original). Repor identificador, nas propriedades do elemento, o devolve ao lugar padrão.

Anotar → Níveis coloca cotas de nível. Nível em planta (numa planta de piso ou de forro) desenha um círculo com dois quadrantes preenchidos no ponto clicado e escreve, sobre uma linha, o nível acabado do piso sob ele e, abaixo, o nível osso da sua estrutura (o topo das camadas abaixo do acabamento); fora de qualquer piso escreve o nível da planta. Nível em seção (num corte ou elevação) desenha um triângulo apontando para o ponto e escreve a sua altura, com o nível osso quando o ponto está no topo de um piso cortado; no corte a ferramenta se prende às linhas da vista, então um clique na linha do topo de um piso cai sobre ela. Os valores acompanham o modelo; no painel de propriedades a cota pode fixar qualquer um dos níveis à mão, esconder o nível osso ou pôr os valores à esquerda. O tipo guarda o tamanho do texto, o nível de referência (o valor escrito para o zero do projeto, por exemplo 100,00) e os sufixos, (N.A.) e (N.O.) por padrão.

Editar vários elementos

Com vários elementos de uma categoria selecionados, a paleta de propriedades mostra Tipo e Nível (Restrição de base em paredes, pilares, escadas, rampas e shafts) e os parâmetros que eles têm em comum: a Linha de localização das paredes, o deslocamento da base, a Restrição superior (desconectada, ou até um nível; paredes que passam a desconectadas mantêm a altura) com seu deslocamento ou a Altura desconectada, peitoril, beiral, rotação, Estrutural, Delimita ambientes, a união das paredes nas pontas, inversões e os dados de identidade (Marca e Comentários). Um valor que difere entre eles aparece como ‹vários› (uma caixa indeterminada nos de ligar e desligar); escolher ou digitar um valor o aplica a todos num só passo de desfazer (o comando elements_set; tipos por elements_set_type). Uma seleção de categorias diferentes mostra quantos há de cada uma e Excluir.

Selecionar em vistas 3D

Com a ferramenta Selecionar, um clique escolhe o elemento sob o cursor (Ctrl soma ou retira). Shift+arrastar desenha uma caixa de seleção, como nas plantas: arrastada para a direita é uma janela e pega os elementos inteiramente dentro dela; para a esquerda é um cruzamento e pega também os que ela toca. Elementos atrás de outros contam; os ocultos, não. Ctrl mantém a seleção atual e soma a ela. Com Arrastar na vista 3D seleciona ligado em Preferências → Interface, arrastar com o botão esquerdo desenha a caixa e Shift+arrastar orbita.

Modificar em vistas 3D

Mover, Copiar, Matriz, Girar, Espelhar (escolher ou desenhar o eixo), Alinhar e Unir geometria/Desunir geometria também funcionam em vistas 3D; arrastar com o botão esquerdo continua orbitando (ou Shift+arrastar, veja acima), com o do meio ou o direito desloca a vista.

• Os pontos são escolhidos num plano de trabalho horizontal no nível dos elementos alterados; depois do primeiro ponto, os seguintes ficam na altura dele. Um quadrado indica a atração a um ponto do modelo perto do cursor: um canto de elemento, o centro de um pilar ou componente na base ou no topo, a ponta de uma parede, o cruzamento de eixos. Uma cruz indica um ponto no plano. Shift mantém o eixo principal; digitar a distância e Enter funciona como nas plantas. A prévia mostra o contorno dos elementos onde eles vão ficar.
• Toda alteração é uma transformação em planta: os elementos continuam no seu nível. Mover um pilar do pavimento 1 de um canto até o canto correspondente do pilar de baixo o coloca sobre esse pilar.
• Alinhar (AL, também nas plantas): clique na face ou linha de referência, depois na face ou linha do elemento a mover. Enquanto você aponta, a face ou linha que o clique pegaria aparece mais grossa; escolhida a referência, ela fica marcada por uma linha vermelha tracejada que cruza a vista, até o segundo clique ou Esc. O elemento se move em planta, então os dois podem estar em níveis diferentes (um pilar de cima sobre a face do pilar de baixo). Todo elemento se alinha pela face ou lado mais próximo do clique (uma parede por qualquer das faces, um pilar por um dos lados); eixos, e elementos escolhidos pela linha de comando sem um ponto, pela linha de locação. Quando os dois não são paralelos, o elemento primeiro gira em torno do ponto clicado até ficarem.
• Prender topo (Modificar → Geometria): com paredes selecionadas, clique num telhado, forro ou piso numa planta, elevação ou corte. Sob ele cada parede sobe ou desce até a face inferior, seguindo a inclinação (uma empena termina num triângulo até a cumeeira); onde não está sob ele, a parede mantém o próprio topo, e uma parede que cruza a borda conta como sob ele. As paredes acompanham o telhado quando ele muda, e voltam ao próprio topo se ele for excluído. Soltar topo, ou o botão sob Topo preso a nas propriedades da parede, devolve o próprio topo. Paredes em arco mantêm o próprio topo. wall_attach faz o mesmo pela linha de comando.
• Aparar/estender para canto, Aparar/estender até referência, Dividir elemento, Deslocamento paralelo e Permitir/impedir união escolhem pontas e lados nas linhas da planta e ficam indisponíveis em vistas 3D, com esse motivo na dica.

Gráficos das vistas

Vista → Gráficos reúne Visibilidade/gráficos (VG), Filtros e Modelos de vista (também em Gerenciar).

• Visibilidade/gráficos edita a vista ativa (ou, a partir do gerenciador de modelos, um modelo). As abas Categorias de modelo e Categorias de anotação listam cada categoria com uma caixa de visibilidade e células para linhas em projeção, preenchimento de superfície, linhas de corte, preenchimento de corte, meio-tom e transparência; a célula mostra a sobreposição (— quando não há) e abre um editor de cor, espessura (mm de papel) e padrão. A aba Filtros lista os filtros aplicados à vista em ordem de prioridade (↑ ↓), com caixas de ativo e visível e as mesmas células; Adicionar filtro… aplica outro e Editar filtros… abre o editor de filtros. Quando o modelo da vista controla categorias ou filtros, a aba avisa e fica só para leitura. OK mantém as mudanças; Cancelar as desfaz.
• Filtros edita os filtros do projeto: nome, categorias (nenhuma: todas) e regras — parâmetro, operador e valor — combinadas com E ou OU, com o número de elementos que correspondem.
• Modelos de vista lista os modelos; Criar a partir da vista cria um da vista ativa. Cada propriedade tem a caixa Incluir; Aplicar propriedades copia o modelo para a vista ativa uma vez, Atribuir à vista faz a vista segui-lo. As propriedades da vista mostram seu modelo (Nenhum a libera) e um botão Visibilidade/gráficos; as propriedades controladas pelo modelo ficam só para leitura.
• Nível de detalhe (Baixo, Médio, Alto), na seção Gráficos das propriedades de plantas, fachadas, cortes e vistas 3D, e propriedade dos modelos de vista: no Baixo, paredes, pisos e telhados em camadas são cortados como uma região lisa (sem linhas de camada nem hachuras de material); no Médio (o padrão) e no Alto mostram suas camadas. Cada peça de componente tem as caixas Aparece em para os três níveis (todas marcadas por padrão), então um componente pode desenhar um bloco simples nas vistas de nível baixo e seus detalhes só nas de nível alto; portas e janelas também.
• Estilo visual, na seção Gráficos das propriedades de toda planta, elevação, corte e vista 3D, e propriedade de template (Padrão da vista deixa a cada vista o estilo de costume): Aramado desenha todas as arestas, vistas através do modelo, sem faces; Linhas ocultas preenche as faces de branco, então elas escondem o que está atrás; Sombreado as preenche na cor do material, iluminadas do lado de quem olha; Cores consistentes na cor do material, igual em todos os lados; Texturas na cor de aparência do material com seu padrão de superfície (Padrão de superfície no navegador de materiais: tijolo, concreto, areia, hachuras…), em tamanho real nas vistas 3D e na escala da vista nas vistas 2D. As plantas são desenhadas em linhas ocultas por padrão; nos estilos coloridos, as faces abaixo do plano de corte (acima dele, nas plantas de forro) são preenchidas sob as linhas da planta, e o aramado tira preenchimentos e hachuras. Elevações, cortes e vistas 3D são sombreados por padrão. view_set e template_set aceitam visual_style.
• Sobreposição, seção das propriedades de toda planta de piso e de forro e propriedade dos modelos de vista: a planta de outro nível desenhada em meio-tom sob a da própria vista, como referência ao desenhar. Planta abaixo e Planta acima usam o nível imediatamente abaixo (ou acima) do da vista, o que serve aos modelos de vista, ou um nível escolhido; Vista de a desenha olhando para baixo, como planta de piso, ou para cima, como planta de forro. Só o modelo aparece (sem anotações), na pena clara e com a visibilidade de categorias da vista; ela não é escolhida, selecionada nem atrai o cursor. Aparece só na tela, a menos que Imprimir sobreposição a leve para as folhas e exportações. view_set e template_set aceitam underlay (por exemplo {"below": {"level": "Next", "looking": "Down"}}); excluir um nível o tira das sobreposições que o citam.
• Marcas de corte nas plantas seguem a NBR 6492 (figura A.19): em cada ponta um círculo de 12 mm com o número do desenho sobre o da prancha (enquanto o corte não está em prancha, a última palavra do nome sobre um traço), sobre um triângulo cheio que aponta para onde o corte olha, unidos por uma linha traço-ponto extralarga. Clique numa marca para selecioná-la (as propriedades mostram as do corte), arraste-a para movê-la, arraste as alças quadradas para mover uma ponta, tecle Espaço para invertê-la e Delete para excluir o corte. Linha dividida nas propriedades desenha só um trecho de linha junto a cada cabeça; arraste as alças redondas na ponta interna dos trechos para trazê-las mais perto da cabeça (ou ajuste Trecho no início/fim). view_set aceita start, end e segments ([no início, no fim] em metros, ou null).
• Com elementos selecionados, Sobrepor gráficos muda seus gráficos só na vista ativa e Ocultar na vista (EH) os oculta nela (reexibidos em Visibilidade/gráficos).
• Ocultar/isolar (temporário): HH oculta a seleção, HI a isola, HC e IC ocultam ou isolam suas categorias, HR redefine. Enquanto ativo, a vista ganha uma borda colorida e um aviso com Redefinir e Tornar permanente. A ocultação temporária não é salva, não entra no desfazer e não é impressa.

Esboço de contornos

Pisos, forros, telhados, radiers e massas são esboçados em planta. A ferramenta abre um esboço: o ribbon mostra Criar contorno com as ferramentas de desenho até Concluir ou Cancelar.

• Desenhar: linhas (encadeadas até fechar o laço; Encadear na barra de opções), retângulos, polígonos inscritos e circunscritos (Lados na barra de opções), círculos, elipses, arcos por três pontos, pelo centro e arcos tangentes que continuam a ponta livre de uma linha ou arco. Os pontos se ajustam ao modelo e às pontas, meios e centros do próprio esboço. Das paredes adiciona linhas ao longo das paredes do nível. Depois do primeiro ponto, digite uma medida e tecle Enter: o comprimento de uma linha (Tab passa ao ângulo), a largura e, depois de Tab, a profundidade de um retângulo, o raio de um círculo ou polígono, a distância de Mover e Copiar; a medida vale na direção do cursor, Backspace apaga e Esc descarta o que foi digitado.
• Selecionar: um clique escolhe uma curva (Ctrl adiciona ou remove), um clique duplo a cadeia de curvas ligadas a ela, uma janela as curvas dentro dela (arrastada para a esquerda, as que ela toca); suas alças a esticam (uma ponta arrasta as pontas ligadas a ela, e os laços continuam fechados; a alça do meio de um arco muda sua curvatura, as do círculo e da elipse os raios). A paleta de propriedades mostra início, fim, centro, raio, semieixos e rotação da curva escolhida, para digitar. Delete remove as curvas escolhidas; Ctrl+Z e Ctrl+Y desfazem e refazem as mudanças do próprio esboço.
• Modificar: Mover, Copiar (Múltiplo coloca cópias a partir do mesmo ponto base), Girar (centro, direção de referência e final, ou um ângulo digitado e Aplicar) e Espelhar (por uma linha do esboço, ou por um eixo desenhado com dois pontos; Copiar mantém os originais) agem sobre as curvas escolhidas. Deslocamento paralelo copia a curva sob o cursor à Distância no lado clicado; com Encadear copia a cadeia inteira de curvas ligadas, e as vizinhas se encontram onde as cópias se cruzam (elipses não têm deslocamento). Aparar/estender para canto faz duas curvas se encontrarem, mantendo as partes clicadas; Aparar/estender até referência toma uma curva de referência e apara ou estende até ela cada curva clicada; linhas seguem pela sua reta, arcos pelo seu círculo. Dividir elemento corta uma curva em duas onde ela é clicada (um círculo ou uma elipse inteira em metades, que depois podem ser aparadas). Os atalhos de duas letras dessas ferramentas também funcionam no esboço.
• Concluir cria o elemento. Laços dentro do contorno viram aberturas de pisos e telhados. Um esboço aberto, que se ramifica ou se cruza continua aberto, com o lugar marcado e o motivo na barra de status.
• Editar contorno (Modificar → Esboço) abre o esboço do piso, forro, telhado ou massa selecionado: suas curvas como foram desenhadas, ou linhas ao longo do contorno. Mover, girar e espelhar o elemento mantém as curvas; editar diretamente os pontos as descarta.

Cobertura e estrutura de telhados

Um tipo de telhado define a telha e a estrutura, na seção Cobertura e estrutura do diálogo de tipo.

• Telha: cerâmica (colonial, francesa, romana, portuguesa), telha de concreto, fibrocimento ondulada, metálica trapezoidal ou telha sanduíche. Cada uma traz valores de referência: a inclinação mínima, o peso por m², as telhas por m², o espaçamento das ripas (galga) e o maior vão entre terças. São valores típicos de dados públicos de fabricantes, para o estudo; os do fabricante prevalecem.
• Estrutura: Madeira põe as ripas logo abaixo do telhado na galga da telha, os caibros descendo a água abaixo delas (no espaçamento dos caibros) e as terças ao longo do beiral abaixo dos caibros, distribuídas por igual do beiral à cumeeira, sem passar do espaçamento das terças (ou do vão da telha, se menor). Tesouras de madeira acrescenta tesouras abaixo das terças, atravessando a cumeeira e sem passar do espaçamento das tesouras: pernas ao longo das águas, linha (tirante) nivelada, pendural sob a cumeeira e escoras até o meio de cada perna. Terças metálicas põe só as terças, logo abaixo das telhas. Seções, espaçamentos e material ficam no tipo. Escolher a telha escolhe a estrutura em que ela costuma assentar, se nenhuma foi escolhida.
• A estrutura segue as águas do telhado, qualquer que seja a forma, e aparece nas vistas 3D, elevações e cortes com o seu material. Ela não entra no volume do telhado. A exportação IFC grava cada peça como um IfcMember dentro do telhado, e importar esse arquivo traz a telha e a estrutura de volta no tipo do telhado.
• As propriedades do telhado mostram a telha, a inclinação contra a mínima da telha (em vermelho quando abaixo), o número de telhas, o peso e os comprimentos e o volume da estrutura. As tabelas de telhados podem listar Inclinação, Telhas, Peso, Estrutura (comprimento) e Estrutura (volume). O comando roof_check devolve o mesmo, com as regras que o telhado não atende.

Massas conceituais

Massa e Terreno → Estudo de massa → Massa (MS) desenha um contorno na planta, como uma laje, e o extruda até o nível de cima. As massas servem para estudos de volumetria antes de existirem paredes e lajes: corpos transparentes nas vistas 3D, elevações e cortes, cortados nas plantas que atravessam.

• Propriedades: o deslocamento da base e a altura, e se a massa é uma extrusão ou uma transição (um contorno de topo diferente da base, feito com mass_create e top ou top_inset).
• Pisos de massa: uma caixa por nível que a massa atravessa, com a área do piso naquele nível. As plantas desenham o piso do seu nível com a área; as propriedades e a tabela de Massas dão a área bruta de pisos (a soma dos pisos), o número de pisos e o volume.
• Empurrar/Puxar (Estudo de massa → Empurrar/Puxar, PP, numa vista 3D): clique numa face da massa, mova o cursor ao longo da seta (ou digite a distância) e clique ou aperte Enter. O topo muda a altura, a base desce ou sobe, e um lado de uma extrusão se desloca para fora ou para dentro, os lados vizinhos mantendo a direção (os lados de uma transição ficam; empurre o topo ou a base). Uma massa com piso em todos os níveis que atravessa ganha os pisos dos níveis que passa a alcançar. Esc solta a face.
• Da massa ao edifício: com massas selecionadas, Estudo de massa → Paredes por face põe uma parede em cada lado de uma extrusão (face externa na face da massa, com a altura dela, unidas nos cantos), Lajes dos pisos de massa uma laje em cada piso de massa (o contorno da massa naquele nível, com o topo no nível) e Telhado por face um telhado plano no topo. Paredes, lajes e telhado são elementos comuns: mude tipo, altura e forma como de costume. Os lados inclinados de uma transição não recebem paredes.
• Mover, girar, espelhar, copiar e colar funcionam como nos outros elementos. Excluir um nível remove os pisos de massa dele. A exportação IFC deixa as massas de fora.

Terreno

Massa e Terreno → Terreno → Terreno (TS) esboça o contorno do terreno numa planta, como o contorno de uma laje, e marca seus pontos medidos: Pontos → Ponto clica um ponto na cota definida na barra de opções (acima do nível), e desfazer retira pontos como retira curvas. Concluir triangula os pontos com o contorno; o contorno recebe as cotas que os pontos lhe dão, inclusive os que ficam além dele, e a terra fecha até uma base plana. Um projeto sem tipo de terreno ganha um, cortado num material Terra (hachura em trama).

• Plantas desenham o terreno do seu nível: curvas de nível abaixo do plano de corte (a cada cinco, uma mestra mais grossa) e, onde o plano de corte atravessa a superfície, a terra acima dele hachurada e contornada como corte. Elevações, cortes e vistas 3D mostram o sólido, e os cortes cortam a terra no seu material.
• Propriedades: a profundidade da base, as cotas mínima e máxima, a área e o volume (também nas tabelas de Terrenos), os avisos (poucos pontos, pontos alinhados, contorno que cruza a si mesmo) e os próprios pontos, com x, y e z editáveis ou removíveis. Editar contorno reabre o esboço com os pontos, para mudar o contorno ou acrescentar pontos. O tipo define o material, o intervalo das curvas e a frequência das mestras.
• A exportação IFC grava um IfcGeographicElement (TERRAIN); importar esse arquivo traz o terreno de volta com seus pontos.

Massa e Terreno → Terreno → Platô (PD) esboça o contorno de um platô sobre o terreno do nível da planta, na Cota da barra de opções; sem terreno nesse nível, o botão avisa. Concluir conforma o terreno: plano dentro do contorno, talude de corte onde o terreno fica acima do platô e talude de aterro onde fica abaixo, até encontrarem o terreno natural (a linha de offset).

• Plantas desenham o contorno do platô com sua cota, traços sobre os taludes (longos e curtos alternados, os curtos a partir do topo do talude), a linha de offset e, tracejadas, as curvas de nível do terreno natural onde o platô o alterou. Os cortes cortam a terra conformada e tracejam a linha do terreno natural.
• Propriedades: a cota, os taludes de corte e de aterro (Do tipo, ou a inclinação própria do platô, mostrada como 1:n), a área, os volumes de corte e de aterro e o saldo, os avisos (taludes que passam do terreno) e Editar contorno. O tipo define as duas inclinações. As tabelas de platôs listam a cota, a área e os volumes, com totais.
• O platô se move e é excluído com o seu terreno. A exportação IFC guarda os platôs no conjunto de propriedades ConstructCAD_Pads do terreno, que a importação lê de volta.

Guarda-corpos e seus hospedeiros

Cortinas de vidro são paredes de um tipo cortina (um projeto sem tipo cortina ganha um pela lista de tipos da ferramenta Parede: + Cortina de vidro). As propriedades do tipo definem as grades vertical e horizontal (distribuição, espaçamento ou número, justificação), o painel (vidro, sólido, vazio, ou uma porta, janela ou outro componente) e os montantes verticais, horizontais e de borda. Arquitetura → Construir → Grade de cortina edita a grade de uma parede clicando nela em planta, elevação ou corte: Adicionar linha (vertical ou horizontal; em planta, só verticais), Remover linha (a mais próxima), Unir/separar trecho (o pedaço de uma linha entre duas outras: as células dos dois lados viram um painel só, ou dois de novo) e Trocar painel (o painel escolhido na barra de opções, ou o do tipo de novo); passar o mouse mostra o que o clique fará. As propriedades de uma cortina selecionada mostram as células, o número de painéis, a área envidraçada e o comprimento dos montantes, e Repor devolve as linhas ou os painéis do tipo.

Arquitetura → Circulação → Guarda-corpo (RA) desenha um guarda-corpo pelos pontos clicados, no nível mais o deslocamento da base. Um guarda-corpo também pode acompanhar uma escada ou rampa (seu hospedeiro): ele corre pelo lado do hospedeiro na inclinação dos bocéis ou da rampa, contorna os patamares e se move, muda e é excluído com ele.

• Numa escada ou rampa: marque Numa escada ou rampa na barra de opções da ferramenta e clique numa escada ou rampa em planta. O guarda-corpo vai no lado mais próximo do clique, ou nos dois com Dos dois lados. As propriedades da escada ou rampa também têm Adicionar guarda-corpos, para os dois lados de uma vez.
• Lado e hospedeiro: as propriedades de um guarda-corpo hospedado mostram o hospedeiro e o Lado (subindo), que pode ser trocado. Soltar do hospedeiro o torna um guarda-corpo comum, que mantém o caminho que tem em planta.
• Pela linha de comando ou MCP: stair_railings_add (com near, para o lado mais próximo de um ponto) e railing_host_set (põe um guarda-corpo existente numa escada ou rampa, no lado por onde seu caminho passa se side não for dado; troca o lado ou o recuo; ou o solta com detach).

Shafts

Arquitetura → Pisos e coberturas → Shaft (SF) esboça em planta o contorno de uma abertura vertical (um shaft de instalações, um poço de elevador ou de escada, um vazio de iluminação), como o contorno de um piso; ela sobe do seu nível até o nível mais alto acima (ou até um nível ou altura definidos nas propriedades). Um projeto sem tipo de shaft ganha um na primeira vez.

• O que ele corta: todo piso, forro e telhado por onde passa, onde seu contorno fica dentro do deles e afastado das aberturas que eles já têm. Os cortes acompanham o shaft quando ele se move, muda ou é excluído, no mesmo passo de desfazer; plantas, áreas nas tabelas, vistas 3D e exportação IFC os mostram como qualquer abertura. Um shaft que cruza a borda de uma laje não a corta.
• Em planta: o contorno cruzado por duas diagonais, na planta do seu nível e em toda planta cujo plano de corte passa por ele.
• Propriedades: o deslocamento da base, o topo (um nível mais um deslocamento, ou sem vínculo com uma altura), a altura e a área. Editar contorno reabre o contorno. element_get lista os elementos que ele corta (derived.cuts).

Perfis varridos

Arquitetura → Modelo → Perfil varrido (SW) leva um perfil ao longo de um caminho desenhado em planta: rodapés, molduras de teto, testeiras, calhas, rufos. Um projeto sem tipo de perfil varrido ganha um na primeira vez (um rodapé de 1,5 × 10 cm).

• Desenho: clique os pontos do caminho; Enter, clique duplo ou Concluir encerra, e Backspace remove o último ponto. A barra de opções define a altura do caminho acima do nível, Caminho fechado (ele volta ao primeiro ponto, em volta de um ambiente, sem pontas) e Inverter lado.
• De que lado: o perfil é desenhado num plano próprio, perpendicular ao caminho: x na transversal, à esquerda de quem anda pelo caminho, e y para cima a partir da altura do caminho. Inverter lado o põe à direita; uma cópia espelhada o mantém do mesmo lado da parede que acompanha. Os cantos ficam em meia-esquadria.
• Perfis: o tipo guarda o perfil e o material. sweep_type_create cria um tipo a partir de pontos [x, y] ou de curves (linhas, arcos, círculos, retângulos… formando um contorno fechado, então uma meia-cana ou uma calha meia-cana se desenham com arcos), e sweep_profile_set redesenha o perfil de um tipo; os dois estão na paleta de comandos. Um perfil precisa ser um contorno fechado que não se cruza.
• Editar perfil (Modificar → Esboço, com um perfil varrido selecionado, ou o botão em Editar tipo… do seu tipo) abre o perfil do tipo num esboço que ocupa o lugar das vistas: no seu plano, x é a transversal (para fora, à esquerda do caminho) e y sobe a partir do caminho, com o ponto do caminho marcado onde os eixos se cruzam. O esboço tem o ribbon de sempre, as ferramentas de desenho e de modificação, as alças e o desfazer; os pontos se prendem aos pontos do próprio esboço, ao ponto do caminho, aos eixos e aos milímetros. Concluir redesenha o perfil de todos os perfis varridos do tipo num só passo de desfazer (um contorno aberto ou que se cruza é recusado e mostrado), Cancelar o deixa como estava. O tipo guarda as curvas, então o arco de uma meia-cana continua arco ao editar o perfil de novo; mudar os pontos do perfil de outro jeito as descarta.
• Vistas: plantas e plantas de forro desenham o que o plano de corte corta e o que fica abaixo (ou acima, nas plantas de forro), elevações, cortes e vistas 3D mostram o sólido, legendas mostram a seção do perfil e tabelas listam comprimento e volume. A exportação IFC os grava como revestimentos do tipo MOLDING.

Vistas de desenho

• Vista → Vista de desenho (também o + de Vistas de desenho no navegador do projeto) cria uma vista 2D independente do modelo: ela não mostra paredes, pisos nem outros elementos do modelo, só o que foi desenhado nela — notas de texto, cotas e desenhos CAD ou imagens importados. Serve para detalhes padrão e outros desenhos que não são cortados do modelo.
• Tem escala própria (1:10 por padrão; 1:1, 1:2 e 1:5 também estão na lista) e nível de detalhe, definidos nas suas propriedades, e sua própria Visibilidade/gráficos para as categorias de anotação e de desenho importado (não tem modelo de vista, fase nem estilo visual, já que não mostra o modelo).
• As ferramentas Texto, Cota, Importar CAD e Importar imagem funcionam nela como nas outras vistas 2D; as cotas nela medem só o que está desenhado.
• Arraste-a do navegador para uma folha como qualquer outra vista, e exporte-a com Exportar imagem, Exportar PDF, Exportar SVG ou Exportar DXF. Excluí-la exclui o que foi desenhado nela.

Chamadas de detalhe e vistas de detalhe

• Vista → Chamada de detalhe desenha uma chamada na planta, planta de forro, corte ou elevação ativa (desabilitado em outras vistas, dizendo por quê): clique em dois cantos opostos da região a detalhar. Ela cria uma vista de detalhe dessa região em escala maior, listada no navegador de projeto sob o tipo da vista mãe (Plantas, Cortes…), que continua ligada ao modelo e é recortada pelo retângulo; desenhe nela linhas de detalhe, regiões, componentes de detalhe, textos e cotas como em qualquer vista. A barra de opções escolhe a escala (Automática: cerca de cinco vezes maior que a da vista mãe) ou, em Mostra, uma vista de desenho existente para a qual a chamada aponta em vez de uma nova vista de detalhe.
• A vista mãe desenha a chamada como um retângulo de cantos arredondados e uma marca com o número do detalhe sobre o número da folha, depois que o detalhe é colocado numa folha. Com a ferramenta Selecionar, clique na chamada para selecioná-la (as propriedades da sua vista aparecem, com Abrir vista e Remover chamada), arraste-a para movê-la ou arraste um canto para redimensioná-la — o recorte da vista de detalhe acompanha — e clique duas vezes para abrir sua vista. Excluir exclui a vista de detalhe, o que remove a chamada.

Linhas de detalhe

• Anotar → Linha de detalhe (DL) desenha linhas 2D que pertencem só à vista ativa: uma planta, planta de forro, elevação, corte, legenda ou vista de desenho (nas outras vistas o botão fica cinza e diz por quê). Elas ficam por cima do modelo e não aparecem em nenhuma outra vista.
• A barra de opções escolhe o modo — Linha, Polilinha (linhas encadeadas ponta a ponta até a polilinha fechar ou Esc), Arco por 3 pontos, Arco pelo centro, Círculo, Elipse e Retângulo — e o estilo de linha: Fina, Média, Grossa, Oculta, Tracejada, Eixo ou Pontilhada. Os pontos se prendem ao modelo, a desenhos importados e a outras linhas de detalhe (pontas, meios, centros, quadrantes). Cada curva vira um elemento assim que é desenhada (um por segmento de polilinha ou lado de retângulo); Esc descarta a curva em andamento e um segundo Esc sai da ferramenta.
• Selecionada, a linha de detalhe mostra na paleta de propriedades seu estilo, vista, forma, comprimento e raio, onde o estilo pode ser trocado, e alças nas pontas, no meio de um arco, no centro e no contorno de círculos e elipses para mudar sua forma. Mover, Copiar, Girar, Espelhar, Matriz e Excluir valem para ela, também em vistas de desenho, elevações e cortes (lá só pegam o que a vista possui: linhas de detalhe, textos e cotas); Aparar/estender canto, Aparar/estender, Dividir e Deslocar agem na sua curva (duas linhas de detalhe se encontram num canto; uma linha de detalhe também apara até uma parede, viga ou eixo; círculos se dividem em metades; arcos e círculos se deslocam concêntricos).
• Visibilidade/gráficos as oculta ou sobrepõe pela categoria Linha de detalhe. Saem nas folhas, são exportadas com a vista (o DXF as põe numa camada com o nome do estilo) e ficam fora das vistas 3D e do IFC.

Estilos de linha, regiões preenchidas e de máscara

• Anotar → Estilos de linha abre um diálogo com os estilos internos (só leitura) e os do projeto: nome, espessura, cor e tracejado são editados na própria tabela, que diz quantos elementos usam cada um. Novo adiciona um estilo; Excluir remove o selecionado, e o que o usava passa para o estilo Fina. OK mantém as mudanças, Cancelar desfaz todas. As listas de estilo de linha da ferramenta Linha de detalhe, de uma linha de detalhe selecionada e do contorno de uma região mostram os estilos do projeto depois dos internos.
• Anotar → Região preenchida (FR) e Região de máscara abrem o modo de esboço na planta, planta de forro, elevação, corte, legenda ou vista de desenho ativa (nas outras vistas o botão fica cinza e diz por quê): desenhe o contorno com as ferramentas de esboço — laços dentro do contorno viram aberturas — e clique em Concluir. Uma região preenchida é preenchida como o seu tipo diz (escolha o tipo na lista de tipos da barra de opções; a primeira região cria um tipo com linhas diagonais sobre branco) e contornada no estilo fino; uma região de máscara é branca opaca, sem contorno, e esconde as linhas do modelo sob ela. As duas ficam por cima do modelo e sob as anotações da vista (linhas de detalhe, cotas, textos, etiquetas, eixos), só nessa vista.
• Selecionada, a região mostra na paleta de propriedades o estilo do contorno (qualquer estilo de linha, ou Nenhuma), a vista, a área, o perímetro e o número de aberturas, e o seu tipo na lista de tipos. Editar contorno (aba Modificar) reabre o esboço na sua vista. Mover, Copiar, Girar, Espelhar e Excluir valem para ela, também fora das plantas. Editar tipo mostra o Preenchimento de um tipo de região preenchida: um padrão de frente e um de fundo, cada um com sua cor (um padrão Sólido preenche com a sua cor; um fundo Nenhum deixa o modelo aparecer entre as linhas do padrão).
• Visibilidade/gráficos as oculta ou sobrepõe pelas categorias Região preenchida e Região de máscara. Saem nas folhas e são exportadas com a vista (o DXF põe os preenchimentos como sólidos e as linhas do padrão numa camada com o nome do estilo do contorno) e ficam fora das vistas 3D e do IFC.

Componentes de detalhe

• Anotar → Componente de detalhe (DC) insere um componente de detalhe — um componente 2D reutilizável para detalhes construtivos — na planta, planta de forro, elevação, corte, legenda ou vista de desenho ativa (o botão fica cinza nas outras vistas, ou quando o projeto não tem nenhum, e diz por quê). A lista de tipos da barra de opções escolhe o componente, e a rotação (com o botão Girar 90°), a escala e Espelhado definem como ele fica; ele segue o cursor, com os encaixes das outras ferramentas, e um clique o insere. Ele é desenhado por cima do modelo e das regiões, sob as linhas de detalhe e anotações, só nessa vista.
• Anotar → Criar componente de detalhe transforma as linhas de detalhe, regiões, textos e componentes de detalhe selecionados da vista ativa num novo tipo de componente de detalhe (chamado Detalhe 1, Detalhe 2…; renomeie-o nas propriedades do tipo), inserido onde eles estavam, num passo de desfazer. Um componente de detalhe pode conter outros (aninhados), nunca a si mesmo.
• Selecionado, um componente de detalhe inserido mostra na paleta de propriedades o seu componente e a sua vista, e a rotação, a escala e Espelhado. Mover, Copiar, Girar, Espelhar e Excluir valem para ele, também fora das plantas. As suas peças são editadas pelos comandos component_sheet_piece_* na paleta de comandos (o editor de componentes é para componentes 3D).
• Inserir → Biblioteca de componentes lista os componentes de detalhe com os outros (o tipo deles é Detalhe 2D) e os carrega, com os componentes que eles aninham. Ao lado de Inserir → Importar CAD…, Blocos como componentes traz os blocos de um DWG ou DXF como componentes de detalhe inseridos onde o arquivo os insere, em vez de explodi-los no desenho importado.
• Visibilidade/gráficos os oculta ou sobrepõe pela categoria Componente de detalhe. Saem nas folhas e são exportados com a vista (o DXF os grava como blocos e inserções) e ficam fora das vistas 3D e do IFC.

Desenhos CAD importados

• Inserir → Importar CAD… coloca um desenho DWG ou DXF na planta, planta de forro, elevação, corte, legenda ou vista de desenho ativa (nas outras vistas o botão fica cinza e diz por quê). Também dá para soltar arquivos .dwg e .dxf na janela. O diálogo de arquivo começa na Pasta de projetos. A origem do desenho fica na origem da vista, a menos que isso o deixe a mais de 1 km do modelo (um desenho em coordenadas de levantamento); então ele é centrado no que a vista mostra. A barra de status informa quantos itens e camadas foram lidos, quantas entidades não foram desenhadas (sólidos 3D, imagens, linhas infinitas…) e que unidades foram supostas quando o arquivo não tem nenhuma.
• Inserir → Importar imagem… coloca uma imagem (PNG, JPEG, GIF, BMP, WebP) ou um desenho SVG na vista ativa, nas mesmas vistas do Importar CAD, centralizada no que a vista mostra; soltar um desses arquivos na janela faz o mesmo. A imagem fica no papel do tamanho que sua resolução dá (96 dpi quando o arquivo não declara): ajuste a Escala nas propriedades (100 para uma planta escaneada em 1:100) ou width em image_import. O SVG mantém caminhos, preenchimentos e imagens embutidas nas próprias cores (os textos não são lidos). É um desenho importado como um DWG: fixado, movido, girado e oculto do mesmo jeito, impresso e exportado com a vista.
• Arquivo → Exportar DXF… (também Inserir → Exportar DXF…) grava a vista ativa (qualquer vista menos tabela) como desenho DXF para outros programas CAD, como impressa: plantas, fachadas e cortes em tamanho real em milímetros (textos na altura impressa vezes a escala da vista), a folha em milímetros de papel. Cada elemento vai para a camada da sua categoria (WALL, DOOR…; anotações em ANNOTATION e TEXT), linhas tracejadas e traço-ponto recebem tipos de linha, preenchimentos opacos viram sólidos e as cores são o índice de cor mais próximo, para que uma tabela de penas por cor dê as espessuras. O arquivo é DXF R12, que todo programa CAD abre; ele volta com Importar CAD.
• O desenho é um fundo para traçar por cima: linhas finas cinzas sob o modelo, com seus textos. Ele aparece só na vista em que foi importado (não em outras plantas nem em vistas 3D), sai nas folhas e exportações e fica fora da exportação IFC. Visibilidade/gráficos o oculta ou sobrepõe pela categoria CAD importado.
• Ele começa fixado, para não ser movido sem querer; use Liberar para movê-lo ou girá-lo com as ferramentas de sempre. Um clique nas linhas dele só o seleciona onde não há elemento do modelo sob o cursor.
• As propriedades definem as unidades (lidas do arquivo, senão supostas), uma escala extra, a rotação, a posição da origem, as cores (Cinza, Cores das camadas, com as cores muito claras escurecidas para o papel branco, ou Preto) e o Meio-tom. A seção Camadas mostra ou oculta cada camada (Todas as camadas alterna todas); camadas desligadas ou congeladas no arquivo começam ocultas.
• As ferramentas de desenho fazem snap nas extremidades e vértices, pontos médios, centros de arcos e círculos (um marcador de círculo) e em pontos das linhas dele.
• Modificar → Explodir (também o botão Explodir nas propriedades dele) transforma o desenho importado selecionado em elementos nativos da sua vista, num passo de desfazer: linhas, polilinhas, arcos e círculos viram linhas de detalhe (uma por segmento; elipses e splines saem como seus segmentos), preenchimentos viram regiões preenchidas de um tipo sólido da sua cor e textos viram notas de texto de um tipo do seu tamanho no papel. Cada camada vira um estilo de linha com o seu nome e cor (Anotar → Estilos de linha), reaproveitado quando já existe um com esse nome; camadas ocultas ficam de fora, e o resultado fica onde o desenho estava (unidades, escala, rotação, espelhamento). Imagens continuam como desenho importado; o modo de cor e o meio-tom não são levados. O que foi criado fica selecionado. Um desenho que geraria mais de 100.000 elementos é recusado: oculte camadas antes.

Fases de construção

• Gerenciar → Fases tem três abas. Fases lista as fases do projeto da mais antiga para a mais recente, com nome, descrição e quantos elementos são construídos e demolidos em cada uma; Adicionar acrescenta uma no fim, Inserir antes põe uma antes da selecionada, ↑ ↓ reordenam (uma mudança que poria uma demolição antes da construção é recusada), e excluir uma fase passa seus elementos e vistas para a fase escolhida em Mesclar elementos e vistas em. Filtros de fase define, para cada filtro, como aparecem os elementos existentes, demolidos, novos e temporários: Não exibido, Por categoria ou Substituído. Gráficos de fase define as sobreposições de cada estado (as mesmas células de Visibilidade/gráficos). OK mantém as mudanças; Cancelar as desfaz.
• As propriedades da vista (plantas, elevações, cortes, vistas 3D, tabelas) têm a seção Fases com sua Fase e Filtro de fase; o filtro fica só para leitura quando o modelo da vista o controla. Os elementos mostram Fase de criação e Fase de demolição. Elementos novos são construídos na fase da vista ativa.
• Modificar → Demolir (DE) demole os elementos clicados na fase da planta, elevação ou corte ativo; suas portas e janelas vão junto.

Folhas e carimbos

As propriedades de uma folha definem o número, o carimbo (um tipo de carimbo do projeto, ou Nenhum para papel em branco), o formato do papel (A0 a A4, ou Personalizado, com largura × altura em milímetros entre 50 e 5000), com Retrato para deixar o lado maior na vertical, e a data de emissão (digitada como AAAA-MM-DD; Hoje preenche a data de hoje). Campos da folha lista os campos por folha do carimbo: digite um valor para esta folha, ou deixe a linha vazia para usar o texto do próprio carimbo, mostrado em cinza. Quando uma peça do carimbo da folha ativa não pode ser desenhada (uma expressão que não se resolve), a barra de status a indica.

Gerenciar → Projeto → Informações do projeto tem uma tabela Campos do projeto: valores seus, como o engenheiro ou o número do alvará, cada um com nome e valor. + Adicionar campo acrescenta um, o nome muda ao digitar por cima (Enter), × remove. Os carimbos os mostram como {project:Nome}.

O carimbo desenha a folha inteira: borda, margens, o próprio carimbo, logotipos. Ele é um componente (categoria Carimbos), então é salvo e carregado em arquivos .ccomp e na biblioteca de componentes. Modificar → Carimbo → Editar carimbo (ou Editar carimbo no menu do botão direito de uma folha, na vista ou no navegador do projeto) abre o carimbo da folha ativa no editor; Vista → Documentação → Novo carimbo cria um a partir do modelo padrão e o abre; carregar um carimbo da biblioteca também o abre.

• A vista Folha: o editor mostra o papel num tamanho de visualização: o da folha de onde foi aberto, ou A0 a A4 em retrato ou paisagem (Visualizar em, na barra de opções). As quatro bordas são planos de referência travados. A roda aproxima, arrastar com o botão do meio ou o direito move, clique duplo com o botão do meio enquadra a folha.
• Linhas: abre um esboço com as ferramentas de desenho e modificação de Esboço de contornos. Concluir cria um traço para cada cadeia de curvas, fechado quando as pontas se encontram. Um ponto sobre uma borda é gravado como SheetWidth, SheetHeight ou 0, e um ponto sobre um plano de referência como o nome do plano, então o traço acompanha o papel: uma linha desenhada na borda direita de uma A3 continua na borda direita de uma A1. Os demais pontos ficam com precisão de centésimo de milímetro. Comprimentos digitados durante o desenho são medidas no papel impresso. As propriedades de um traço definem a espessura (milímetros), a cor e, quando fechado, o preenchimento; Editar esboço (ou clique duplo) o reabre.
• Texto: um clique coloca um texto. As propriedades definem as palavras, a altura, o alinhamento (esquerda, centro ou direita na linha de base, ou o centro do bloco), a rotação e a posição. Inserir campo acrescenta um campo no cursor: número, nome, total e posição da folha, escala e papel; nome, número, cliente, endereço e autor do projeto e os campos do projeto; a data de hoje e a de emissão; e os campos por folha. Os campos aparecem preenchidos pela folha de onde o editor foi aberto (ou por valores de exemplo); Mostrar chaves dos campos os mostra como digitados, como {sheet_number}. {{ escreve uma chave.
• Imagem: escolha um arquivo PNG, JPG ou SVG e arraste o retângulo; a imagem mantém as proporções, a não ser com Shift pressionado. As alças dos cantos a movem e redimensionam. A imagem fica guardada no carimbo (e no seu arquivo .ccomp).
• Plano de referência: dois cliques ao longo de uma linha criam um plano em esquadro com o papel. A posição é uma expressão em milímetros que pode ler o papel (SheetWidth - 10).
• Parâmetros: números (em milímetros) e textos. Novo campo por folha acrescenta um texto que cada folha pode definir em Campos da folha; o texto do parâmetro é o padrão. Largura da folha e Altura da folha mostram o papel da visualização.
• Seleção: clique numa peça, ou arraste uma janela em volta de várias; Delete as remove. Um texto ou imagem selecionado mostra alças.
• Concluir mantém as alterações e Cancelar edição desfaz tudo o que foi feito no editor. Todas as folhas que usam o carimbo acompanham.

Ambiente de modelagem de componentes

Editar componente (Arquitetura → Modelo, ou Editar componente… nas propriedades de um tipo de componente) abre um espaço de trabalho próprio para o componente selecionado, ou para o que a ferramenta Componente coloca. Edição rápida… mantém o editor antigo, numa só janela.

• Vistas: as vistas do projeto dão lugar às vistas Planta, Frente, Lateral e 3D do componente. A rodinha aproxima, arrastar com o botão do meio ou o direito move a vista, e um duplo clique com o botão do meio enquadra tudo.
• Ribbon: a aba Criar traz Selecionar, Extrusão, Revolução, Varredura, Transição, Plano de referência, Cota, Igualdade (EQ), Conector, Salvar componente…, Concluir e Cancelar edição.
• Painel à esquerda: o tipo cujos valores as vistas mostram, os parâmetros (nome, valor, se os elementos podem sobrepô-lo, × e + Parâmetro) e as propriedades do plano, da cota, da peça ou do conector selecionados.
• Planos de referência: três planos de origem estão sempre lá: CenterX (centro esquerda/direita), CenterY (centro frente/fundo) e Base. Plano de referência leva dois cliques na vista de planta, frente ou lateral; uma linha mais vertical ou mais horizontal define a orientação do plano. A posição de um plano é uma expressão (Left + Largura), e seu nome pode ser usado em qualquer expressão do componente, então uma peça que lê x = Left acompanha o plano.
• Cotas: Cota pega dois planos paralelos e os mede onde você clicou. Nas propriedades, um Rótulo (um parâmetro de comprimento, ou um novo digitado em Novo parâmetro) faz o parâmetro controlar o segundo plano. Mudar o valor muda o parâmetro, ou move o plano quando a cota não tem rótulo.
• Peças por esboço: Extrusão, Revolução, Varredura e Transição abrem um esboço, o mesmo dos contornos em planta (veja Esboço de contornos): seu ribbon (Esboço: Extrusão…) traz as ferramentas de desenho (linhas, retângulos, polígonos, círculos, elipses e arcos), as ferramentas de Modificar, Concluir e Cancelar; as curvas são escolhidas, esticadas pelas alças e digitadas no painel lateral. Desenhe na vista de planta, frente ou lateral: a primeira curva fixa a vista. Os pontos se ajustam aos pontos do próprio esboço e aos planos de referência, e uma coordenada sobre um plano visto de perfil fica presa a ele, então a peça acompanha o plano; pontos de um círculo ou elipse com centro sobre um plano são escritos a partir desse plano. A barra de opções define Sólido ou Vazio. Concluir cria a extrusão na hora; a revolução pede em seguida o eixo, um plano visto como linha vertical ou qualquer ponto (Esc volta ao contorno). A peça nova fica selecionada: suas propriedades definem o nome, Vazio, Mostrar em planta, o material e onde ela começa e termina (ou o eixo e o ângulo), cada um uma expressão que o menu ⌖ prende a um plano. Editar esboço nas propriedades reabre o contorno (o caminho de uma varredura, a base e depois o topo de uma transição); pontos que não se moveram mantêm as expressões com que foram escritos.
• Igualdades (EQ): Igualdade (EQ) pega três planos paralelos numa vista: um externo, o que fica no meio e o outro externo. A posição do plano do meio passa a ser (a + b) / 2, então ele continua centrado quando os outros se movem; a vista mostra duas cotas marcadas EQ. Mover o plano do meio à mão quebraria a igualdade e é recusado; apague a igualdade antes.
• Conectores: onde tubos e eletrodutos se ligam ao componente (a entrada de água e o esgoto de uma peça sanitária, a ligação elétrica de uma tomada). Conector coloca um com um clique na vista de planta, frente ou lateral; uma coordenada perto de um plano de referência visto de perfil fica presa a ele, então o conector acompanha o plano, e a profundidade começa em 0 (em planta ele aponta para baixo, nas outras vistas para trás). Todas as vistas, a 3D também, mostram os conectores como anéis na cor do seu sistema, com uma seta no sentido em que as tubulações saem (um ponto quando é na sua direção, um x quando é para longe). As propriedades definem o nome, o tipo de sistema, X, Y e Z (expressões que o menu ⌖ prende a um plano), a direção e o diâmetro. Uma tubulação levada até um componente colocado se liga a ele pelos conectores (component_connector_add, _set, _delete).
• Pontos do esboço: as propriedades de uma peça de esboço listam seus pontos (e o caminho e a seção de uma varredura, o topo de uma transição). Cada coordenada é uma expressão; digite outra, ou prenda-a com ⌖ a um plano visto de perfil na vista do esboço.
• Varreduras e transições: as curvas de uma Varredura são um caminho aberto; por ele vai uma seção, definida na barra de opções como retângulo (largura × altura) ou círculo (diâmetro), centrada no caminho; os cantos ficam em meia-esquadria. Transição pega um contorno de base e depois (após Concluir) um de topo, desenhado na mesma vista, e os une; início e fim se definem nas propriedades, como numa extrusão.
• Seleção e teclas: clique na linha de um plano, no texto de uma cota, numa aresta de peça ou num conector para selecioná-lo; Delete o remove, e Esc volta passo a passo pelos cliques da ferramenta, pela ferramenta e pela seleção.
• Peças de script: + Script no Edição rápida… acrescenta uma peça de script com um script inicial; o código é editado nas propriedades da peça, e o que ele declara vira os parâmetros do componente (nomes, tipos e a marca de instância vêm do script; na tabela só os valores mudam). Um script que não carrega é indicado acima da peça. Veja Componentes com script. Na paleta de propriedades, um componente com script colocado mostra Parâmetros de instância e Parâmetros do tipo · compartilhados (caixas de seleção, caixas de texto, listas de opções e de materiais) e os Erros do script; selecionado numa planta, seus hotspots aparecem como grips na forma e cor declaradas, e arrastar um o move.
• Concluir e Cancelar: toda mudança vale para todos os tipos do componente e se desfaz como qualquer edição. Concluir mantém as mudanças, Cancelar edição desfaz tudo o que foi feito desde que o ambiente abriu.

Preferências

Arquivo → Preferências (Ctrl+,, também no pé da tela inicial) reúne as configurações do próprio aplicativo; elas não fazem parte de nenhum projeto e ficam guardadas entre as sessões. Escolha uma página à esquerda. As mudanças aparecem na hora; OK as mantém e Cancelar (ou Esc) volta aos valores de quando a janela abriu. Restaurar padrões (embaixo, à esquerda) volta as opções da página mostrada aos valores padrão; o idioma e as pastas ficam como estão.

• Geral: o idioma da interface, o tema (claro, escuro ou o do sistema) e Verificar atualizações automaticamente (veja o aviso de atualização abaixo).
• Interface: a Escala da interface (75–200%, tudo cresce: painéis, ícones, texto; Ctrl+Mais e Ctrl+Menos também a mudam), o Tamanho do texto (pequeno, normal, grande, muito grande; só o texto, em qualquer escala), Iniciar com o ribbon recolhido, Dicas detalhadas (desligadas, as dicas dos comandos mostram só o nome, o atalho e por que o comando está indisponível, sem a descrição e o comando do motor) e Arrastar na vista 3D seleciona (arrastar com o botão esquerdo desenha uma caixa de seleção e Shift+arrastar orbita; desligado, o contrário).
• Locais de arquivos: a Pasta de macros (os diálogos de arquivo de macro começam nela e Gerenciar → Executar macro lista as macros dela), a Pasta de projetos (onde começam Abrir, Importar IFC, Importar CAD e o primeiro Salvar de um projeto novo; um projeto já salvo é salvo de novo ao lado dele mesmo), as pastas da biblioteca de componentes (Adicionar pasta…, Remover) e a Pasta de plugins (veja Plugins; sem definir, uma pasta plugins na pasta de dados do aplicativo). O botão Gerenciar pastas… da janela da biblioteca de componentes abre esta página. Uma pasta que não existe mais aparece como Não encontrada e é ignorada.
• Salvamento: o intervalo do Salvamento automático (desligado, ou a cada 1, 2, 5, 10 ou 15 minutos; veja abaixo) e quantos projetos recentes a tela inicial lista.
• Teclas de atalho: todos os comandos com suas teclas. Clique na caixa de um comando e digite duas letras para dar novas teclas a ele (elas substituem as antigas na hora, nas dicas, na paleta e nas vistas); teclas que já são de outro comando são recusadas e a linha diz de qual. Deixe a caixa vazia para tirar as teclas, e Padrão traz de volta as originais. A busca acha um comando pelo nome ou pelas teclas. Atalhos com Ctrl, Delete e Esc são fixos.

Programação visual

Gerenciar → Macros → Programação visual abre o editor de grafos num painel abaixo das vistas, para ver o modelo e o grafo juntos (constructcraft projeto.ccad --graph arquivo.ccgraph abre um ao iniciar). Um grafo é um conjunto de nós ligados por fios (veja Grafos de programação visual para o que os nós fazem e como rodar de novo atualiza o modelo).

• Adicionar nós: clique duas vezes ou com o botão direito no fundo para abrir a busca de nós; digite palavras do nome, do grupo ou da descrição do nó e tecle Enter (ou clique num resultado). Todo comando do motor é um nó, ao lado dos nós internos (entradas, matemática, lógica, listas, geometria, parâmetros, saídas) e do nó Lua.
• Ligar: arraste de uma saída (lado direito) para uma entrada (lado esquerdo), ou ao contrário. Arrastar de uma entrada ligada pega o fio dela. As portas têm a cor do tipo; um fio entre tipos que não combinam é recusado, com uma mensagem na barra de status.
• Navegar: arraste um nó para movê-lo (junto com os outros selecionados); arraste o fundo para selecionar com uma janela (Shift ou Ctrl acrescenta); o botão do meio ou o direito move a vista; a roda dá zoom em torno do ponteiro. Zoom para ajustar enquadra o grafo.
• Entradas: os nós number, integer, slider, boolean e text têm o valor no próprio nó. O inspetor à direita edita o nó selecionado: o nome (nos nós de entrada e de saída, o nome da entrada ou do resultado do grafo), a combinação de listas, os valores das entradas não ligadas (JSON, ou texto simples), Mostrar todas as entradas de um nó de comando, as entradas, saídas e o código de um nó Lua, e Usar a seleção em select_elements. Depois de uma execução, mostra as saídas do nó, o erro ou o motivo de ele não ter rodado. Sem nó selecionado, mostra o nome do grafo, Permitir comandos de arquivo, quantos elementos o grafo criou, Selecionar elementos e Liberar elementos.
• Executar: Executar (F5) roda o grafo pelo motor como um passo de desfazer; a barra do editor e a barra de status mostram quantos elementos foram criados, alterados e apagados. Automático roda depois de cada alteração. Cada nó mostra o valor (ou o erro) embaixo dele; clicar num nó seleciona os elementos que ele criou.
• Teclas com o ponteiro sobre o painel: Delete remove os nós selecionados, Ctrl+C / Ctrl+V copiam e colam, Ctrl+A seleciona tudo, Ctrl+Z / Ctrl+Y desfazem e refazem edições do grafo (o desfazer do modelo fica na barra de acesso rápido), Ctrl+S salva o grafo.
• Arquivos: Novo, Abrir…, Salvar, Salvar como… trabalham com arquivos .ccgraph (os diálogos começam na pasta de macros). Fechar o painel, Novo ou Abrir… com alterações não salvas pergunta antes.

Plugins

Plugins acrescentam comandos ao ConstructCraft (veja Plugins no guia de automação). Gerenciar → Plugins tem dois botões: Plugins… abre a janela Plugins, e Comandos de plugins é um menu dos comandos dos plugins instalados, por plugin; escolher um abre o formulário dele na paleta de comandos, onde Executar o roda como um passo de desfazer e mostra o que o plugin imprimiu. A paleta também encontra os comandos de plugins pelo nome.

A janela Plugins tem duas abas:

• Instalados: os plugins da pasta de plugins. Escolha um para ver a versão, os autores, a licença, a página, os comandos e algum erro ao carregá-lo. Ativado o carrega ou o deixa de fora (um plugin desativado não roda nenhum código). Um plugin que pede para trabalhar com arquivos tem Permitir que leia e grave arquivos; sem isso, os comandos dele que importam, exportam ou salvam são recusados. Remover o apaga da pasta.
• Disponíveis: os plugins do índice da comunidade, lido quando a aba é aberta pela primeira vez (Atualizar o lê de novo). Instalar (ou Atualizar para …) baixa a versão mais nova que esta versão do programa consegue rodar, confere o checksum do índice e só instala se o plugin carregar; um plugin que pede arquivos só recebe a permissão se você marcar a caixa antes.

Só essa aba usa a rede: ela lê o índice e os arquivos que ele lista, por HTTPS, quando você pede. Recarregar plugins lê a pasta de novo, depois que você acrescenta ou edita um plugin à mão. Os plugins são carregados quando o aplicativo abre e continuam carregados quando você abre outro projeto.

Aviso de atualização

O ConstructCraft avisa quando uma versão mais nova é publicada; ele nunca baixa nem instala nada por conta própria, só quando você escolhe Atualizar agora.

• Quando: ao iniciar, no máximo uma vez por dia, em segundo plano (a janela nunca espera por isso). Arquivo → Verificar atualizações (também no diálogo Sobre) verifica na hora e informa “está atualizado”, a nova versão ou que não foi possível verificar.
• O que é contatado: uma requisição HTTPS à API do GitHub, https://api.github.com/repos/francisreboucas/constructcraft/releases/latest, que devolve a última versão publicada. A requisição envia os dados usuais de conexão (seu endereço IP) e o agente ConstructCraft/<versão>; nenhum dado de projeto, identificador ou informação de uso. Vale para ela a declaração de privacidade do GitHub.
• O que aparece: quando a versão publicada é mais nova que a em uso (pré-lançamentos são ignorados), um aviso aparece na barra de status e na tela inicial: Baixar abre a página da versão no navegador, Ignorar esta versão esconde o aviso até sair uma versão posterior, e × o esconde até a próxima verificação. Qualquer falha (sem conexão, tempo esgotado, proxy, limite de requisições) é silenciosa.

• Atualizar agora: onde o ConstructCraft pode se substituir com segurança, o aviso e o diálogo da verificação oferecem Atualizar agora. Ele baixa o pacote que corresponde à forma como esta cópia foi instalada e confere o SHA-256 com o SHA256SUMS.txt da versão (os dois pelos links de download da própria versão no GitHub) antes de mudar qualquer coisa; um download que não confere é apagado e a cópia instalada fica como estava.

  Instalado como	Atualizar agora faz
  AppImage	Baixa o novo AppImage ao lado do antigo, confere, renomeia por cima do arquivo antigo e oferece Reiniciar agora
  Instalador do Windows (.msi, em Arquivos de Programas)	Baixa e confere o instalador; ele roda quando o ConstructCraft fecha (Instalar agora fecha, perguntando antes sobre alterações não salvas; Ao sair espera), e o ConstructCraft abre de novo ao terminar
  .zip do Windows	Baixa e confere o arquivo, coloca o novo constructcraft.exe e o ccad.exe no lugar (os antigos ficam como .old e são apagados na próxima abertura) e oferece Reiniciar agora
  App do macOS	Baixa e confere a imagem de disco e a abre: arraste o ConstructCraft para Aplicativos
  .deb	Nada: o diálogo mostra o comando do apt, com Copiar, e Baixar pega o pacote
  .tar.gz, compilação própria	Nada: Baixar abre a página da versão

  Atualizar agora precisa de permissão de escrita nos arquivos instalados: um AppImage numa pasta sem permissão falha com uma mensagem, e Baixar é o caminho para atualizá-lo.

• Como desligar: desmarque Verificar atualizações automaticamente em Preferências → Geral. A variável de ambiente CONSTRUCTCAD_NO_UPDATE_CHECK=1 desliga toda verificação, automática ou pedida (útil em CI, quiosques e instalações sem rede). O ConstructCraft guarda a hora da última verificação, a versão ignorada e a opção junto com as outras preferências.

Salvamento automático e recuperação

Um minuto depois que um projeto passa a ter alterações não salvas (também um projeto novo, nunca salvo; Preferências → Salvamento define outro intervalo ou desliga o salvamento automático), o ConstructCraft grava uma cópia dele, em segundo plano, na pasta recovery da sua pasta de dados (%APPDATA%\ConstructCraft\data no Windows, ~/Library/Application Support/ConstructCraft no macOS, ~/.local/share/constructcraft no Linux). Ele só grava de novo depois que o modelo muda, e nunca sobre o arquivo do projeto. Salvar, fechar o projeto ou sair remove a cópia.

Se o ConstructCraft travar ou for encerrado à força, a próxima abertura mostra Recuperar trabalho não salvo com as cópias deixadas: Restaurar abre o projeto escolhido com as alterações não salvas (salvá-lo grava no arquivo original, ou pergunta onde, para um projeto nunca salvo), Descartar apaga a cópia e Cancelar guarda as cópias para a próxima abertura. Uma falha na interface também grava uma última cópia antes de o programa fechar, e toda falha é acrescentada a crash.log na pasta de dados; anexe-o ao relatar uma falha.

Inicialização gráfica

O ConstructCraft desenha com a API gráfica nativa do sistema (DirectX 12 ou Vulkan no Windows, Metal no macOS, Vulkan no Linux) e passa sozinho para o OpenGL quando ela falha, o que algumas GPUs integradas antigas ou pequenas exigem:

• Se a API nativa informar um erro, a mesma abertura tenta o OpenGL. Se ela travar antes de a janela aparecer, o ConstructCraft abre de novo uma vez com o OpenGL; se o processo inteiro morrer (uma falha do driver), a próxima abertura tenta o OpenGL primeiro.
• Depois que o OpenGL foi necessário, ele continua em primeiro: a escolha fica no arquivo gpu-backend da pasta de dados. Apague esse arquivo (depois de atualizar o driver de vídeo, por exemplo) para tentar a API nativa de novo.
• Toda abertura que falha é registrada em crash.log na pasta de dados. Quando nenhuma API funciona, uma mensagem avisa e indica esse arquivo.
• A variável de ambiente WGPU_BACKEND escolhe a API e desliga a troca automática: gl para OpenGL, dx12, vulkan ou metal, ou várias separadas por vírgulas (no Windows, por exemplo, set WGPU_BACKEND=gl num prompt de comando antes de abrir constructcraft.exe, ou como variável de ambiente do usuário). WGPU_POWER_PREF=low prefere a GPU integrada em computadores com duas.

Acessibilidade

Os botões do ribbon, os títulos das abas, as setas de rolagem, os itens da paleta, as linhas do navegador, os cartões da tela inicial, os botões de fechar dos diálogos, as seções de propriedades e o botão de início do cubo de vista são desenhados pelo próprio ConstructCraft. Eles informam à interface de acessibilidade do sistema seu papel (botão, item selecionável, cabeçalho recolhível), seu nome e seu estado (habilitado, selecionado, expandido), para que leitores de tela possam anunciá-los.

Para desenvolvedores

Adicionar um comando à interface

1. Primeiro, faça da alteração um comando do motor (veja Para desenvolvedores no guia de automação).
2. Acrescente uma variante a UiCommand em crates/cc_app/src/commands.rs. Depois preencha icon, label, description (uma chave i18n cmd-desc-… em todos os arquivos .ftl), shortcut (se houver), engine (o nome do comando do motor), badge, unavailable (um motivo traduzido para cada estado em que não pode rodar), selected (para ferramentas) e run. Inclua-o em UiCommand::all.
3. Coloque-o num grupo do ribbon com command_button (grande) ou numa família de botões pequenos com stacks (crates/cc_app/src/ribbon.rs).

A dica, a habilitação, o item da paleta e um atalho de duas letras saem todos do comando. Os testes verificam que cada nome do motor existe no catálogo, que os atalhos não se repetem e que todo comando aparece no ribbon com nome acessível.

Ícones

Os ícones são arquivos SVG em assets/icons/ui, numa grade de 24 unidades. Eles usam traços brancos (stroke-width 1.75, pontas e junções arredondadas) e preenchimentos suaves escritos como fill="#fff" fill-opacity=".2". O icons.rs separa cada ícone em duas camadas por esses atributos: os traços e as marcas sólidas formam a tinta, e os preenchimentos suaves formam o tom. Cada camada é rasterizada pelo resvg no tamanho exato em pixels e pintada nas cores do tema (icons::Tones). Acrescente o novo ícone a Icon, Icon::ALL e Icon::source. ICON_SHEET=folha.png cargo test -p cc_app icon_sheet grava todos os ícones em vários tamanhos para revisão.

Tema

As cores são tokens de theme::Palette: PALETTE (claro) e DARK, com um teste de contraste. Pinte com theme::palette(ctx) para que um tema escuro possa ser ligado depois.

Testes de interface

O crates/cc_app/src/ui_tests.rs roda o ribbon e a paleta sem janela, com o egui_kittest. Os testes clicam e digitam pela árvore de acessibilidade, então widgets próprios precisam chamar Response::widget_info. As capturas de referência ficam em crates/cc_app/tests/snapshots. Elas cobrem cada aba do ribbon, o ribbon estreito e o recolhido, uma dica completa, a paleta, cada página da janela de Preferências e uma galeria de ícones nos dois temas. Placas de vídeo renderizam com pequenas diferenças, então a comparação das capturas roda sob demanda:

CC_UI_SNAPSHOTS=1 cargo test -p cc_app snapshots     # compara com as referências
UPDATE_SNAPSHOTS=1 cargo test -p cc_app snapshots    # regrava após uma mudança intencional

Revise as imagens novas antes do commit. Quando há diferença, o kittest grava *.new.png e *.diff.png ao lado das referências; o Git ignora esses arquivos.

This site is open source. Improve this page.