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. O navegador e as propriedades começam empilhados à esquerda; arraste o cabeçalho de um painel para encaixá-lo em qualquer lateral: na faixa junto à borda esquerda ou direita da janela, numa coluna própria ali; na metade de cima ou de baixo do outro painel, empilhado acima ou abaixo dele; na metade esquerda ou direita dele, numa coluna própria ao lado. A área que o painel vai ocupar fica destacada durante o arrasto, e Esc cancela. O clique direito num cabeçalho oferece as mesmas opções (Encaixar à esquerda, Encaixar à direita, Empilhar com…, Separar de…) e Restaurar disposição dos painéis, também em Preferências → Interface. A disposição é mantida entre as sessões. 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. A seta na ponta direita de cada barra de abas (Vistas abertas) lista as vistas abertas naquela barra, agrupadas por tipo de vista como no navegador de projeto, com a ativa marcada: escolher uma traz a aba dela para a frente e a rola até ficar visível. Abaixo da lista, Fechar as outras vistas fecha as outras abas da barra e Fechar todas as vistas, todas elas. A roda do mouse sobre uma barra de abas cheia rola as abas. Fechar a última vista aberta fecha o projeto e volta à tela inicial, perguntando antes quando há alterações não salvas.

Abrir um projeto e importar um arquivo (IFC, DWG/DXF, SketchUp, OBJ, glTF, imagens e SVG, arquivos de componente) faz a leitura em segundo plano: um diálogo mostra a operação, o nome, a pasta e o tamanho do arquivo e o tempo decorrido, com um indicador animado, e impede o uso do resto da janela. O projeto aberto continua como estava até o arquivo ser lido; Cancelar (ou Esc) deixa de esperar e não altera nada.

Um projeto novo (Novo na barra de acesso rápido e na tela inicial, Ctrl+N) parte de um template: o diálogo Novo projeto oferece o Sistema Métrico (metros, escalas 1:50 e 1:100, folhas A) e o Sistema Imperial (pés e polegadas, escalas 1/4” = 1’-0”, folhas ANSI e ARCH, começando pela ANSI B) em dois cartões. Clique num deles e em Criar, ou dê um clique duplo; o template escolhido por último vem marcado na próxima vez. Com alterações não salvas, a pergunta sobre elas vem depois de Criar, e Cancelar em qualquer um deixa o projeto aberto como está. Num projeto imperial, as listas de escala (propriedades da vista, templates de vista, a ferramenta Chamada de detalhe) oferecem as escalas de arquitetura e de engenharia (1/4" = 1'-0", 1" = 20'-0"…), e vistas, folhas e a barra da vista escrevem as escalas assim; uma escala fora da lista continua aparecendo como 1:N. Medidas no papel (alturas de texto de cotas e de cotas de nível, marcas e folgas do estilo de cota, espessuras de pena, larguras de notas de texto, posições de viewports, papel personalizado, padrões de preenchimento de desenho) aparecem e são digitadas em polegadas num projeto imperial (3/32", espessuras como 0.010"); um número sozinho é em polegadas, e mm ou cm depois dele ainda dão milímetros. Os campos das peças de carimbos e de componentes de detalhe continuam expressões em milímetros.

Sistemas de medida. Tudo o que é medido segue as unidades do projeto (Gerenciar → Unidades do projeto), então trocá-las entre métrico e imperial (o botão Imperial (EUA) ali) muda todas as exibições de uma vez. Num projeto imperial, os comprimentos aparecem em pés e polegadas (12'-6 1/2"), e as medidas pequenas — espessuras de camadas e lajes, lados de seções, diâmetros, espelhos e pisos, seções de eletrocalhas, dimensões de perfis — em polegadas sem pés (3/4", 1 1/4", 16"), e um número sozinho digitado nesses campos é em polegadas; áreas e volumes aparecem em pés quadrados e cúbicos, inclinações como a elevação por 12 de projeção (6:12, digitada como 6:12, 6/12 ou 6; Elevação por 12 também é oferecida a projetos métricos), massas em libras (lb, lb/ft para perfis, lb/ft² para coberturas), densidades em lb/ft³, resistências em ksi, vazões em gpm, propriedades de seção em in², in⁴, in³ e in, e a escala do mapa do terreno em pés e milhas. Os cabeçalhos de tabelas não nomeiam unidade ali (Comprimento, não Comprimento (m)), pois os valores trazem suas marcas. O que é criado sob demanda ganha medidas imperiais redondas e nomes sem unidades métricas: rodapé (4”), rampa (4’-0”, com regras de inclinação 1:12, 30” por lance e patamares de 60”), eletrocalha (8” × 4”), condutor do SPDA (Ø3/8”), parede cortina (grade de 5’-0”, montantes de 2” × 6”) e tipos de porta (2’-8” × 6’-8”), além dos dispositivos; paredes novas têm 10’-0” de altura, tubos e dispositivos ficam em alturas redondas, esgotos caem 1/4” por pé até 3” e 1/8” acima, e pontos livres arredondam em passos de 1/2” a 20’-0” conforme o zoom. A escada do template imperial segue os limites usuais (espelhos até 7 3/4”, pisos de 10” ou mais, 2E + P entre 24” e 25”), seu estilo de cota usa polegadas redondas e os componentes da biblioteca têm medidas em polegadas inteiras. O que continua métrico: seções de condutores (mm²), propriedades térmicas dos materiais, padrões de preenchimento de modelo, as designações do catálogo de perfis (W150x13) e as expressões (componentes, carimbos e esboços de perfis mantêm as unidades em que foram escritas).

Os diálogos abrem no meio da janela e podem ser movidos arrastando o título; na próxima vez, o diálogo abre centralizado de novo. Um diálogo tem a largura que seus botões e seu conteúdo precisam.

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:

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:

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:

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, eletrodutos, eletrocalhas ou condutores de SPDA: 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; com paredes selecionadas, invertê-las (trocar os lados externo e interno); desenhando uma parede, inverter o lado das próximas paredes

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.

Nas vistas 2D e 3D a roda do mouse dá zoom em torno do cursor e arrastar com o botão do meio (ou, nas vistas 3D, com o direito) move a vista; um clique duplo com o botão do meio enquadra a vista. No trackpad, dois dedos movem a vista e o gesto de pinça dá zoom; no Mac, Cmd com dois dedos também dá zoom. As vistas distinguem o trackpad da roda pela rolagem que ele informa (em pontos, não em linhas); Preferências → Interface → Rolagem do trackpad move a vista desliga isso, e então qualquer rolagem dá zoom (para um mouse que informa a roda como um trackpad). Os editores de componente, de perfil e de carimbo, o editor de programação visual e o mapa do terreno funcionam do mesmo jeito.

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).

O elemento sob o cursor fica destacado antes do clique, e a barra de status diz o que ele é (Categoria : Tipo). Onde elementos se sobrepõem, Tab passa ao próximo sob o cursor e Shift+Tab volta, dando a volta: primeiro o que o clique pegaria, depois as outras linhas pela distância, os preenchimentos de cima para baixo e por fim os desenhos importados. Sobre uma parede, a cadeia de paredes ligadas a ela pelas pontas (parando onde três ou mais paredes se encontram) vem logo depois dela. A barra de status mostra a posição na lista, como (2/4), e um clique seleciona o candidato destacado, uma cadeia com todas as suas paredes (Ctrl soma ou retira). Mover o cursor mais que alguns pixels, sair da vista ou mudar o modelo recomeça.

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.

O que é desenhado numa vista (linhas de detalhe, regiões preenchidas e de máscara, notas de texto, cotas, cotas de nível, componentes de detalhe, desenhos importados) pertence a ela. Copiado (Ctrl+C) e colado (Ctrl+V) com outra planta, elevação, corte, legenda ou vista de desenho ativa, vai para essa vista nas mesmas coordenadas, de modo que o limite do lote ou a área edificável desenhados na planta de implantação servem em outra planta; cotas coladas em outra planta continuam medindo os mesmos elementos. A partir de uma vista 3D ou de uma tabela, volta para a vista de origem. No navegador de projeto, Duplicar com detalhamento copia a vista junto com o que foi desenhado nela (Duplicar copia só a vista).

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.

Gráficos das vistas

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

Texturas e faces pintadas

Configuração do sol

Vista → Gráficos → Configuração do Sol (ou o botão Sol nas propriedades de uma vista) dá um sol à planta, planta de forro, vista 3D, elevação ou corte ativa; uma vista sem sol ganha o sol padrão quando o diálogo abre (uma elevação ou um corte, o sol convencional, projetando sombras), e Cancelar o tira de novo.

Renderizar

Vista → Gráficos → Renderizar faz a renderização por traçado de caminhos da vista 3D ativa numa janela própria: a imagem à esquerda, as configurações de renderização da vista à direita. Ela usa a câmera que a vista mostra quando a janela abre (uma câmera ainda ajustada ao modelo é ajustada de novo ao tamanho e ao campo de visão da renderização). Renderizar começa; a imagem vai se refinando, e a linha abaixo dela dá as amostras feitas, o tempo gasto e os triângulos da cena; Parar guarda o que já foi renderizado. A roda do mouse dá zoom em torno do cursor, arrastar move a imagem e um clique duplo a ajusta de novo.

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.

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.

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.

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).

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).

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.

Nichos

Arquitetura → Construir → Nicho insere um nicho: um rebaixo em uma das faces de uma parede, hospedado como uma porta ou janela, mas sem atravessar a parede. Clique numa parede em planta (ou numa vista 3D) e o nicho fica na face do lado clicado. Projetos novos trazem um tipo de nicho, de 60 × 60 cm e 10 cm de profundidade, com a base 90 cm acima da base da parede (2’-0” × 2’-0” × 4” a 3’-0” em projetos imperiais); num projeto antigo sem nenhum, o primeiro nicho traz esse tipo. O campo Peitoril da barra de opções mostra o peitoril do tipo e define a altura dos próximos nichos inseridos, como nas janelas.

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.

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).

Perfis de parede

A face de uma parede reta pode ser desenhada na sua própria elevação, de modo que a base e o topo não precisam ser nivelados: um topo que acompanha o terreno inclinado, uma base em degraus, uma empena, um topo em arco.

Paredes em spline

A ferramenta de parede (Arquitetura → Construir → Parede, WA) tem três modos na barra de opções: Reta encadeia paredes retas, Arco pede o início, o fim e depois um ponto do arco (ou um raio digitado + Enter), e Spline desenha uma parede ao longo de uma curva suave pelos pontos clicados.

Sapatas corridas e vigas baldrame

Estrutura → Fundação → Baldrames sob paredes coloca uma sapata corrida sob cada parede selecionada (ou todas as paredes do nível da planta) ao longo do eixo do corpo da parede, com o topo na base da parede; paredes que já têm uma são puladas. Uma parede em arco ganha uma sapata em arco que acompanha a curva (concêntrica com a parede), e não uma sequência de trechos retos, então a planta de fundação mostra a curva e o raio e o volume de concreto é exato.

Vigas em arco

A ferramenta Viga tem dois modos na barra de opções, como a de parede: Linha desenha vigas retas, Arco pede o início, o fim e depois um ponto do arco, ou um raio digitado + Enter. Uma viga em arco é nivelada (não tem deslocamento de elevação no fim).

Armadura de vigas

Armadura típica, nas propriedades de uma viga ou pilar, cria barras inferiores, superiores e estribos. Outros conjuntos são criados com rebar_create (paleta de comandos), e a quantidade ou o espaçamento de cada conjunto é editado na seção Armadura. Os estribos são fechados por dois ganchos em um canto (135° com pontas retas de 10 diâmetros da barra, contados no seu comprimento); as propriedades de um conjunto de estribos selecionado mostram Ganchos do estribo (nenhum, 90° ou 135°) e Ponta do gancho (diâmetros da barra).

Seções de pilares e sua armadura

A seção de um tipo de pilar é um perfil estrutural. Além das formas padrão, o Gerenciador de Perfis (Estrutura → Perfis) tem o Setor anular: o trecho de um anel entre um raio interno e um raio externo que gira um ângulo, como os pilares que continuam uma parede cilíndrica (raio interno 0 dá um setor circular). A seção é desenhada simétrica em relação ao eixo vertical, com a face externa para cima, e posicionada pelo meio da sua caixa envolvente; gire cada pilar do círculo pela sua rotação. A área e o volume do pilar são os do anel, não os das cordas com que ele é desenhado. Pilares em L, T, U e outros polígonos são perfis desenhados (um perfil novo da forma Esboço).

rebar_create (paleta de comandos) arma um pilar de qualquer seção:

Armadura de paredes

Uma parede estrutural (a caixa Estrutural nas propriedades) mostra a seção Armadura. Armadura típica cria barras horizontais e verticais a cada 15 cm junto às duas faces; cada conjunto aparece então com o seu espaçamento, que pode ser editado, e um botão Remover. wall_rebar_create (paleta de comandos) define todo o resto, para as paredes indicadas ou todas as paredes estruturais de um nível:

Armadura de lajes

Um piso estrutural (a caixa Estrutural nas propriedades) ou um radier mostra a seção Armadura. Armadura típica cria uma malha a cada 15 cm nas camadas superior e inferior, e o reforço em volta das aberturas; cada conjunto aparece então com o seu espaçamento e um botão Remover. slab_rebar_create (paleta de comandos) define todo o resto, para as lajes indicadas ou os pisos estruturais e radiers de um nível:

Armadura de blocos e estacas

As propriedades de um bloco sobre estacas e de uma estaca mostram a seção Armadura. Armadura típica dá ao bloco barras inferiores sobre as estacas, uma malha superior e barras de pele (e, num bloco de duas estacas ou em linha, estribos), e à estaca barras em volta da seção com espera no bloco e uma espiral (estacas redondas) ou estribos (estacas quadradas); cada conjunto aparece então com a sua quantidade ou espaçamento e um botão Remover. Estrutura → Armadura → Armadura de bloco e Armadura de estaca fazem o mesmo para os blocos e estacas selecionados (as estacas de um bloco selecionado também), ou para os do nível ativo que ainda não têm armadura. pile_cap_rebar_create e pile_rebar_create (paleta de comandos) definem todo o resto:

Estrutura por material

A aba Estrutura começa com o grupo Material: botões Concreto, Aço e Madeira (um fica sempre ligado; a escolha é guardada entre sessões). O material troca os grupos feitos para ele: concreto mostra Estrutura (Pilar, Viga, Laje) e Armadura; aço mostra Estrutura (Pilar, Viga, Contraventamento), o grupo de grade Estruturação (Pilares nas grades, Vigas nas grades, Vigas entre pilares, Pórtico por grade, Treliça, Galpão metálico, Light Steel Frame) e Ligações (Placa de base, Placa de topo, Chapa de alma); madeira mostra Estrutura (Pilar, Viga, Contraventamento), o mesmo grupo de grade com Wood Frame no lugar de Galpão metálico e Estrutura de aço leve, e Ligações (Ligação parafusada, Suporte de viga). Perfis, Fundação, Analítico, Documentação, Referência e Seleção aparecem para todos os materiais.

Os botões Pilar e Viga iniciam suas ferramentas num tipo do material escolhido, e a lista de tipos da barra de opções mostra só esses tipos. Quando o projeto não tem nenhum, um é criado do catálogo num só passo de desfazer: um W200x26,6 para aço, um MLC 9x32 para madeira, um retângulo de concreto 20x40 para concreto (structural_type_for). Os comandos de grade da aba também usam o tipo do material escolhido. O material de um tipo vem do seu perfil (perfis de aço e formados a frio são aço).

Pórtico por grade (Estrutura → Estruturação, disponível com duas ou mais grades) abre um diálogo que coloca pilares em cada pavimento e vigas em cada nível de uma faixa, num só passo de desfazer: Nível de base e Nível superior, o Tipo de pilar e o Tipo de viga (do material escolhido) e Vigas secundárias, com a grade a que correm paralelas e o seu Espaçamento. Ele estrutura as grades selecionadas, ou todas se nenhuma está selecionada. Os pilares ficam presos ao nível de cima, e vãos e pilares já modelados são pulados. As vigas secundárias preenchem cada vão (quatro interseções de grades) a no máximo um espaçamento umas das outras e terminam nas vigas que as cruzam; vãos que não são esses quadriláteros são pulados. Uma execução com mais de 2000 elementos é recusada. A barra de status informa o que foi colocado e pulado.

Galpão metálico (Estrutura → Estruturação) abre um diálogo que cria um galpão de pórticos num só passo de desfazer: o Vão entre eixos dos pilares, a Altura do beiral, a inclinação e o formato (duas águas ou uma água) do telhado, o número de Módulos e a Distância entre pórticos, o Tipo de pilar e o Tipo de viga de cobertura (do material aço; Padrão do catálogo cria um), e Terças e Longarinas com seu tipo e espaçamento (cada uma pode ser desligada). Os elementos são pilares e vigas comuns, com etiquetas, tabelas, vistas 3D e exportação IFC como os demais; o galpão em si aparece em planta como uma pegada tracejada. Selecioná-lo mostra seus parâmetros na paleta de propriedades (Vão, Altura do beiral, Módulos, Distância entre pórticos, os tipos, Terças, Longarinas, Elementos e Elementos desvinculados); mudar um deles regenera os elementos no mesmo lugar, mantendo seus ids, marcas e comentários. Um elemento editado à mão (movido, trocado de tipo ou excluído) fica desvinculado e não é regenerado; Restaurar elementos na paleta faz o galpão voltar a gerenciar todos. Excluir o galpão exclui seus elementos, e copiá-lo cria um novo galpão com elementos próprios.

Contraventamento (Estrutura, aço e madeira) contraventa um vão de pórtico, pavimento por pavimento. Com dois pilares selecionados, contraventa o vão entre eles, tomando a base e a altura comum dos dois (dividida pelos Pavimentos); senão é uma ferramenta: clique os eixos dos dois pilares do vão. A barra de opções define o Padrão (em X, diagonal, em V, V invertido ou chevron, e em K, cujas quatro barras vão da meia altura de cada pilar ao meio do vão no topo e na base do pavimento), a Altura do pavimento e os Pavimentos; a diagonal tem ainda Inverter diagonal e Alternar diagonais (um zigue-zague pavimento a pavimento). As barras são vigas comuns de um tipo de catálogo do material da aba (tubo SHS 100x100x4 no aço, peça 6x12 na madeira), então recebem etiquetas, tabelas, vistas 3D e exportação IFC; o contraventamento em si aparece nas plantas como a linha do vão tracejada. Ao selecioná-lo, a paleta de propriedades mostra seus parâmetros e o Tipo das barras; mudar um deles regenera as barras no lugar, mantendo seus ids. Uma barra editada à mão é desvinculada e não é regenerada; Restaurar elementos faz o contraventamento voltar a gerenciar todas. Excluir o contraventamento exclui suas barras, e copiá-lo cria um novo com as suas próprias.

Treliça (Estrutura → Estruturação, aço e madeira) é uma ferramenta: clique as duas pontas da linha do vão. A barra de opções define a Forma (plana, uma água ou duas águas), o Padrão (Pratt, Howe, Warren e, nas de duas águas, pendural, dois pendurais e Fink), a Altura (de banzo a banzo, ou a flecha), os Painéis (auto mira um a cada 1,5 m; a de duas águas pede número par), as Cópias e seu Espaçamento à esquerda da linha do vão. Os tipos vêm do material da aba (banzo e diagonal do catálogo, em aço ou madeira). Cada banzo é uma viga contínua (dois banzos superiores na de duas águas); os montantes são cortados para ficar entre os banzos, ou dentro deles quando os banzos são perfis U abertos para a alma, como no padrão do aço; e a treliça que termina num montante tem os banzos passando por cima dele e esse montante virado para fechar a ponta. Banzos, diagonais e montantes são vigas e pilares comuns, então têm etiquetas, tabelas, vistas 3D e exportação IFC; a treliça em si aparece nas plantas como uma linha tracejada do vão por cópia. Selecioná-la mostra seus parâmetros e os quatro tipos de elemento na paleta de propriedades; mudar um regenera os elementos no lugar, mantendo ids, marcas e comentários. Um elemento editado à mão (movido, retipado ou excluído) fica desvinculado e não é regenerado; Restaurar elementos na paleta faz a treliça gerenciar todos de novo. Excluir a treliça exclui seus elementos, e copiá-la faz uma nova treliça com seus próprios elementos.

Light Steel Frame (Estrutura → Estruturação, aço) e Wood Frame (madeira) abrem um diálogo que estrutura paredes: o Sistema, o Espaçamento dos montantes (0,4 m em aço leve, 0,6 m em madeira), os tipos dos montantes, das guias ou soleiras e das vergas e contravergas (por padrão, os tipos do catálogo do sistema), um Frechal duplo (só madeira) e Bloqueadores a meia altura. OK estrutura as paredes selecionadas, ou todas as do nível ativo quando nenhuma está selecionada; paredes curvas e as já estruturadas ficam de fora. Há montantes nas pontas da parede e a cada espaçamento ao longo dela, com montantes duplos, uma verga, uma contraverga sob janelas e montantes curtos em cada porta e janela. Montantes, guias, vergas e contravergas são pilares e vigas comuns, então têm etiquetas, tabelas, vistas 3D e exportação IFC; a ossatura em si não desenha nada nas plantas. Selecionar uma ossatura mostra seu sistema, espaçamento, frechal duplo, bloqueadores e os três tipos de elemento na paleta de propriedades; mudar um regenera os elementos no lugar, mantendo ids, marcas e comentários, e eles acompanham a parede e suas portas e janelas quando estas se movem ou mudam. Um elemento editado à mão (movido, retipado ou excluído) fica desvinculado e não é regenerado; Restaurar elementos na paleta faz a ossatura gerenciar todos de novo. Um elemento de ossatura mostra na paleta uma linha Ossatura cujo botão Selecionar seleciona a ossatura. Excluir a parede exclui sua ossatura e seus elementos.

Estrutura → Ligações (aço e madeira) coloca ligações com tamanhos padrão nos pilares selecionados (placas de base) ou nas vigas, senão nos do nível ativo, nas extremidades que servem ao tipo: placas de topo e ligações parafusadas onde uma viga termina num pilar, chapas de alma num pilar ou numa viga, suportes de viga onde uma viga encontra outra. Extremidades que já têm uma são puladas, e a barra de status diz quantas foram colocadas. Placas e parafusos acompanham seu elemento, vão embora com ele quando é excluído e não são copiados com ele. Selecionar uma ligação mostra o tipo, o elemento e a extremidade, a espessura, a largura e o comprimento da placa (auto: da seção), o diâmetro, as linhas, as colunas, o espaçamento e a distância à borda dos parafusos e (placas de base) o comprimento do chumbador, com a massa das placas e o número de parafusos; uma ligação cuja extremidade já não serve a ela não desenha nada e avisa.

Perfis estruturais

Estrutura → Perfis (também Gerenciar → Perfis) abre o Gerenciador de perfis: os perfis estruturais do projeto, com que os tipos de pilar e viga são desenhados e construídos, agrupados por material (aço, aço formado a frio, madeira, concreto) sob uma caixa de busca.

Nas Propriedades do tipo, os tipos de pilar e viga têm uma linha Perfil no lugar dos antigos campos de seção: uma lista dos perfis do projeto agrupados por material com caixa de busca, e Gerenciar…, que abre o Gerenciador de perfis no perfil do tipo. Abaixo, a rotação do perfil (graus) e Espelhado giram e espelham o perfil no tipo, e uma linha só de leitura dá d × bf do perfil. Um tipo sem perfil mostra “—” e mantém a sua própria seção até que um seja escolhido. As mudanças passam por type_set, e OK/Cancelar as mantêm ou desfazem com as demais mudanças do diálogo.

Eletrocalhas e registros

Instalações → Elétrica → Eletrocalha (TY) desenha trechos de eletrocalha como os eletrodutos: clique as pontas de cada trecho, um depois do outro; uma nova elevação durante o desenho cria um trecho vertical, e Backspace desfaz o último segmento. A barra de opções define o circuito que as eletrocalhas levam e a sua elevação (por padrão 30 cm abaixo do nível de cima, ou a altura da eletrocalha onde o trecho começa). Um projeto sem tipo de eletrocalha ganha um na primeira vez (200 × 100 mm, leito).

Instalações → Hidrossanitária → Registro (VL) insere um registro ou válvula no tubo clicado, no ponto clicado. Um projeto sem tipos de registro ganha um de cada na primeira vez: registro de gaveta, de esfera, de pressão e válvula de retenção.

Proteção contra descargas atmosféricas (SPDA)

O grupo Instalações → SPDA desenha um sistema de proteção contra descargas atmosféricas. Seus elementos pertencem a um sistema de SPDA, criado com o primeiro deles, e aparecem na planta de SPDA do pavimento (Instalações → Documentação → Planta de SPDA), que as ferramentas abrem quando outra vista está ativa.

Cabeamento estruturado

O grupo Instalações → Telecomunicações insere racks e tomadas de dados. Eles aparecem na planta de telecomunicações do pavimento (Instalações → Documentação → Planta de telecomunicações), com as eletrocalhas e os eletrodutos que levam o cabeamento.

Vistas de desenho

Chamadas de detalhe e vistas de detalhe

Linhas de detalhe

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

Etiquetas, bolhas de eixo e marcas de vista

Padrões de preenchimento

Componentes de detalhe

Desenhos CAD importados

Fases de construção

Opções de projeto

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, ANSI A a ANSI E, ARCH A a ARCH E1 e ARCH E, os do sistema do projeto primeiro; ou Personalizado, com largura × altura entre 50 e 5000 mm, em polegadas nos projetos imperiais), 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.

Tabelas vão para as folhas como qualquer vista: arraste uma do navegador de projeto para uma folha aberta, ou clique nela com o botão direito no navegador e escolha Inserir na folha ativa (sheet_place_view). Ela é desenhada como uma tabela com linhas no tamanho impresso, com o nome na primeira linha, os cabeçalhos, uma linha por elemento que a sua fase mostra e os totais; ela acompanha o modelo, e o PDF, SVG, PNG e DXF da folha a levam. Exportar imagem, Exportar DXF e view_export também gravam uma tabela sozinha como a sua tabela desenhada.

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}.

Gerenciar → Projeto → Localização do terreno situa o projeto num mapa do OpenStreetMap. Busque um endereço, lugar ou coordenadas (Enter ou Buscar; escolha um entre vários resultados), ou arraste o mapa: o marcador vermelho no meio é a origem do projeto, a seta é o norte do projeto e o quadrado vermelho é a área de dados do mapa a trazer, girada pelo Norte verdadeiro. Elevação → Obter lê a altitude acima do nível do mar de um modelo de elevação aberto (precisão de metros; digite por cima um valor levantado), e Endereço deste ponto preenche o endereço do marcador. OK grava latitude, longitude, elevação, norte verdadeiro e endereço (o endereço do projeto é reescrito a partir das partes, para carimbos e IFC). Importar entorno baixa os dados do mapa do quadrado para a planta escolhida: um desenho fixado com camadas de edificações, vias, caminhos, ferrovias, água, áreas verdes, árvores e nomes de ruas e, com Edificações como massas, uma massa de contexto por edificação (altura ou pavimentos do mapa, senão dois pavimentos de 3 m). Cancelar desfaz tudo. Dados do mapa © colaboradores do OpenStreetMap (ODbL); mapa, busca e elevação precisam de conexão com a internet. 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.

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. Novo componente (Arquitetura → Modelo) pede um nome e o tipo do componente (mobiliário, marcenaria, louças e metais, iluminação, elétrica, genérico, porta ou janela) e mostra os parâmetros com que esse tipo começa: largura, profundidade e altura na maioria, um diâmetro na iluminação, a largura, a altura e o peitoril da abertura em portas e janelas; um componente genérico começa sem nenhum, e os parâmetros são criados por você. Criar faz o componente e o abre aqui; Cancelar edição o remove, e Concluir escolhe a ferramenta que o posiciona.

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.

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).

Editor de macros

Gerenciar → Macros → Editor de macros abre um painel abaixo das vistas, no lugar do editor de grafos (um dos dois aparece por vez, e cada um guarda o seu conteúdo quando o outro abre), onde uma macro é escrita, verificada e executada um passo por vez enquanto as vistas acima mostram a alteração de cada passo. Uma macro é um {"command": …, "args": {…}} por linha, com linhas de comentário // (veja Macros no aplicativo).

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:

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.

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:

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 nextest run -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 nextest run -p cc_app snapshots     # compara com as referências
UPDATE_SNAPSHOTS=1 cargo nextest run -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.