Como usar

Layout

• Barra superior: Arquivo (conjunto de exemplos / Abrir JSON / baixar / salvar / imprimir) · Undo/Redo · Experimentos (allowlist) · Mais (material)
• Canto superior direito: idioma · entrar / conta
• Trilho de ferramentas 2D (desktop): flutuante no canto inferior esquerdo — Desenhar · Selecionar · Mover · Inserir · Excluir · Costura · Simular
• Esquerda: Inspector · Centro: canvas 2D (escuro) · Direita: vista 3D e Camadas
• Celular/tablet: abas 2D | 3D | Inspector | Camadas · ferramentas como FAB no painel 2D
• O progresso da simulação é um diálogo centralizado · após sim: Material · Iluminação · Limpar resultado da sim

Início rápido

• Arquivo → Conjunto de exemplos · Abrir JSON (somente admin) · editor vazio carrega camiseta padrão
• Modo Selecionar — clique ou laço · só para vértices, escolha primeiro o chip Vértice ao lado de Selecionar
• Modo Mover — arraste para transladar · Shift+arrastar para rotacionar · ou setas
• Modo Costura — clique na borda A e depois na B · cordões de costura roxos no canvas
• Arquivo → Baixar JSON salva painéis + costuras · rascunho do navegador é salvo automaticamente
• (Opcional) Entre, salve no servidor · reabra em /designs
• Excluir remove a seleção · Ctrl+Z desfaz (funciona mesmo com layout de teclado não QWERTY)

Pan e zoom

• Botão do meio + arrastar = pan · Scroll = zoom
• Espaço + arrastar com o esquerdo = pan (alternativa)
• Toque com dois dedos: pan juntos · pinça = zoom

Ferramentas principais

• Desenhar painel: coloque ≥3 pontos · Enter ou clique no primeiro ponto para fechar · Esc cancela
• Selecionar: clique/laço · não move · Ctrl/Cmd alterna a seleção
• Mover: arraste painel/borda/vértice · Shift+arrastar rotaciona · painéis no mesmo Z têm ímã de bordas
• Inserir vértice: clique perto da borda · sem ímã de grade · borda costurada = bloqueado
• Excluir: segue o chip de filtro · vértices costurados destacados em âmbar
• Costura: borda A e depois B · bordas costuradas bloqueiam · Esc limpa a primeira borda
• Chips de filtro após Selecionar: Auto / Vértice / Borda / Painel — afetam clique e laço

Ímã de grade · guias · ímã de bordas

• Ímã de grade: caixa no canto superior direito do 2D (ligada por padrão) · Alt ao arrastar = desliga temporariamente
• Linhas guia: mesma área de caixas (desligadas por padrão) · só alinhamento · não atraem vértices
• Ímã de bordas: ao mover painéis inteiros perto da mesma camada frente/verso · Alt = off · não enquanto rotaciona ou move vértices/bordas

Inspector e menu de contexto

• O inspector à esquerda segue a seleção (painel · borda · vértice) · um vértice: x/y local + profundidade z · vários vértices/bordas: deslocamento z/x/y a partir de 0 · digite números e Enter · ▲▼ aplicam na hora
• Vários painéis: campos de posição são deslocamentos x/y/z (começam em 0) somados a cada painel selecionado
• Clique direito: excluir · inserir · costurar/descosturar · duplicar · espelhar · baixar · imprimir · limpar canvas
• Duplicar painel com costuras = bloqueado · um só: espelho esquerda/direita/cima–baixo → frente/verso · vários: frente/verso em torno do centro da seleção

Costuras

• Costura → primeira borda (roxa) → segunda borda → cordão tracejado + seta
• Um par de costura por borda · sem costura válida = não dá para simular
• Camadas → Costuras mostrar/ocultar cordões · clique no cordão para selecionar · clique direito descosturar/inverter
• Diferença de comprimento > ~5% → cordão âmbar · os painéis não são esticados automaticamente
• Salvar: Baixar JSON · após entrar, salvar no servidor em /designs · compartilhar somente leitura pelo catálogo

Camadas · frente/verso

• Caixa da camada = ocultar/mostrar · clique duplo no nome = nome de exibição (id do arquivo não muda)
• Z positivo = frente · Z negativo = verso · a camada verso espelha esquerda–direita em direção ao observador
• Arrastar um painel sobre outro manequim e soltar = mover automaticamente para esse manequim

Painel 3D · escolha do manequim

• Padrão: 2D à esquerda / 3D à direita · arraste para orbitar · roda = zoom · painéis flutuam até Simular
• Escolher manequim · buscar por medidas (~5000) · enviar OBJ · gerar MakeHuman (macros / pose)
• Validar / Pré-visualizar antes da sim · linhas roxas em 3D correspondem aos cordões de costura 2D

Simulação de tecido

Antes de Simular: o modelo precisa de pelo menos um par de costuras · defina o destino de execução e tecido/passos em Configurações de sim

• Destino de execução: Servidor (Python) ou Navegador na aba (WebGPU quando disponível) · salvo neste dispositivo
• WebGPU precisa de HTTPS ou localhost — http://IP-LAN não consegue selecionar a GPU (use CPU)
• Configurações de sim: preset de tecido · envoltório/liberação/subpassos · maleabilidade · presets personalizados salvos localmente
• Simular abre um diálogo · o resultado substitui o painel 3D por tecido + manequim
• Material: cor/textura (só visual) · branco padrão + `/materials/default.png` · funciona em painéis planos · não muda a física da sim
• Iluminação: após a sim · pré-visualização ao vivo · não roda a sim de novo
• Limpar sim: volta aos painéis planos · rode Simular de novo para ver os ajustes

Salvar · catálogo · impressão

• Baixar JSON = painéis + costuras · Abrir JSON / Conjunto de exemplos · rascunho do navegador
• Entre para salvar no servidor · abra em /designs · compartilhe somente leitura pelo catálogo
• Imprimir… / Baixar SVG · escolha Actual size 100% no diálogo de impressão (não Fit to page)
• Entrada e saída podem registrar IP e horário por segurança — veja a página de privacidade
• Undo/Redo ≥50 passos · Ctrl+Z / Ctrl+Y

Símbolos do canvas

• Azul = borda do painel · Vermelho = bordas cruzadas (aviso)
• Cordão de costura = linha tracejada + seta · Borda roxa = aguardando a segunda borda (modo costura)
• Ponto laranja + linha fina = alça de curva · Preenchimento azul = painel selecionado

Atalhos comuns

• Setas movem · Shift+setas rotacionam · Delete/Backspace excluem
• Ctrl+Z desfazer · Ctrl+Y refazer (teclas físicas Z/Y, não letras digitadas)
• Enter fecha o painel (≥3 pontos) · Esc cancela traço/costura
• Alt ao arrastar = desliga ímã de grade e de bordas