Documentação do Editor de Design de Casas: Plantas, 3D, Mobiliário e Materiais

Primeiros passos

1. Abre o editor em `/editor` para o experimentares logo com um apartamento de exemplo, ou cria um projeto a partir do teu painel para teres uma planta gravada e partilhável.

2. Escolhe a ferramenta **Divisão retangular**, clica num canto na planta, arrasta até ao canto oposto e larga: ficas com uma divisão de quatro paredes, desenhada à escala.

3. Muda para **Mobiliário**, abre uma categoria na gaveta do catálogo e arrasta uma peça para o chão. Adiciona uma **Porta** e uma **Janela** da mesma forma: clica na ferramenta, escolhe no catálogo e larga sobre uma parede.

4. Carrega no botão **3D** no topo para percorreres o que acabaste de desenhar; orbita com o rato. Carrega em **2D** para voltares à planta.

5. Num projeto com sessão iniciada, cada alteração é gravada automaticamente na nuvem; a demo em `/editor` mantém as tuas edições apenas até recarregares a página.

É este o ciclo completo: desenhar, mobilar, visualizar, aperfeiçoar. Tudo o resto abaixo são detalhes.

Vistas 2D e 3D

**Planta 2D** — uma planta vista de cima, à escala, com câmara ortográfica e uma grelha de medição. É aqui que desenhas e organizas: paredes, divisões, cotas e mover objetos são tarefas mais fáceis aqui. Faz pan e zoom à vontade.

**Visita em 3D** — uma vista em perspetiva com iluminação, sombras e materiais reais. Orbita com o rato para inspecionares o espaço e afinar a posição dos objetos com os gizmos no ecrã. As plantas com vários pisos são renderizadas com visibilidade por piso.

Alterna com os botões **2D / 3D** no centro do topo. As ferramentas de parede, divisão e cota precisam da câmara vista de cima, por isso escolher uma delas enquanto estás em 3D volta automaticamente a colocar-te em 2D.

Barra de ferramentas

**Selecionar** — a ferramenta predefinida. Clica num objeto, parede, divisão ou cota para o selecionares e abrires as respetivas Propriedades; clica num espaço vazio para anular a seleção. Arrasta o fundo para mover a câmara.

**Desenhar parede** — clica para ires colocando os vértices da parede um a um, com uma pré-visualização elástica; um indicador em tempo real mostra o comprimento e o ângulo do segmento atual. Carrega em **Enter** para terminar (três ou mais vértices), ou clica de novo no primeiro vértice (fica verde a cerca de 0,3 m) para fechares o contorno. **Backspace** remove o último vértice. Clicar a cerca de 0,2 m de uma parede existente divide-a para que a nova parede se una de forma limpa.

**Divisão retangular** — clica num canto, arrasta até ao canto oposto e larga. Cria uma divisão alinhada aos eixos com quatro paredes num único gesto.

**Porta** — escolhe uma porta no catálogo e depois clica numa parede para a encaixares numa abertura. O lado das dobradiças e o sentido de abertura podem ser editados depois.

**Janela** — igual à Porta: escolhe no catálogo e clica numa parede. A altura do peitoril e o tamanho podem ser editados nas Propriedades.

**Mobiliário** — abre a gaveta do catálogo. Arrasta uma miniatura para o chão para a colocares, ou percorre uma categoria e larga-a. O mobiliário colocado pode ser movido, rodado e redimensionado.

**Cota** — clica em dois pontos para colocares uma anotação de medição permanente com uma etiqueta de distância. A ferramenta continua ativa para poderes adicionar várias; as cotas são gravadas com a planta e acompanhadas pelo histórico de anular.

**Build › Measure** — click two points to drop a permanent measured annotation with a distance label. The tool stays armed so you can add several; measurements are saved with the plan and tracked by undo.

**Furniture** — opens the catalog drawer. Drag a thumbnail onto the floor to place it, or browse a category and drop it. Placed furniture can be moved, rotated and scaled. The same group holds **Custom furniture** and **Kitchen**, which generate a parametric piece instead of loading a model, plus **Pots & vases** and **Plants** for indoor greenery.

**Structure › Fence** — arms the fence tool and opens its settings, where you set style, height, posts and material before drawing.

**Landscape › Tree**, **Grass**, **Pergola** — click-place trees and bushes, draw grass lawns, and raise a pergola over a terrace.

**Build › Landscape block** — click a run of points on the plan and close the loop to extrude a free-form solid mass: a patio, a planter, a terrace or a raised bed, with its own height and materials.

Mobiliário e aberturas

**A gaveta do catálogo** — abre a partir das ferramentas Porta, Janela ou Mobiliário. Percorre por categoria e depois por item; usa a caixa de pesquisa dentro de uma categoria para filtrares por nome. As categorias incluem sofás, camas, cadeiras, mesas, armários, iluminação, cozinha, casa de banho, decoração e muito mais.

**Arrastar ou clicar** — arrasta uma miniatura diretamente para a tela para a largares onde soltares, ou escolhe a ferramenta e clica numa parede (portas / janelas) ou no chão (mobiliário).

**Carrega os teus próprios** — o botão de carregamento na gaveta aceita os teus próprios modelos `.glb` / `.obj` (com um `.mtl` opcional), até 25 MB cada; aparecem no catálogo junto aos incluídos e sincronizam com a tua conta.

Editar objetos

**Painel de propriedades** — selecionar seja o que for abre um painel (na margem direita no computador, uma folha inferior no telemóvel) com campos por separadores para esse objeto. Os campos numéricos são aplicados quando terminas a edição, e cada alteração pode ser anulada.

**Divisões** — edita o nome, a altura e o piso; define as espessuras das lajes de chão / teto / solo / cobertura; e atribui materiais a cada superfície. A área da divisão atualiza-se em tempo real.

**Paredes** — edita a espessura e consulta o comprimento; atribui materiais distintos às faces interior, exterior, de bordo e de encaixe.

**Portas e janelas** — define a posição, a rotação e a escala; escolhe materiais por encaixe; e no separador Avançado define o lado das dobradiças, o sentido de abertura e a altura do peitoril. Teclas rápidas: **F** troca o lado das dobradiças, **Shift + F** inverte o sentido de abertura.

**Mobiliário** — define a posição, a rotação e a escala (com opção de bloqueio de proporção) e materiais por encaixe.

**Gizmos 3D** — quando um objeto está selecionado em 3D, arrasta as setas coloridas para o moveres (X / Z livres, o eixo vertical limitado à altura da divisão no caso do mobiliário), o anel para rodar em torno do eixo vertical (encaixa a cada 15° com o Encaixe ativo) e as pegas dos cantos para redimensionar. Um indicador em tempo real mostra o valor exato enquanto arrastas.

Materiais

**Atribuir um material** — no separador Materiais de qualquer divisão, parede ou objeto, escolhe da lista de materiais e a superfície atualiza-se de imediato. O botão de reposição (↺) devolve um encaixe ao seu valor predefinido.

**As tuas próprias texturas** — carrega imagens PNG / JPG / WebP (até 5 MB) para as usares como materiais; ficam indexadas à tua conta e aparecem logo no seletor.

**Incluídas e da comunidade** — a aplicação vem com uma biblioteca de texturas, e as texturas que outras pessoas publicam ficam disponíveis para todos. Num projeto partilhado, uma textura carregada por um colaborador fica acessível a todos os membros.

Atalhos de teclado

**Esc** — cancela em três etapas: primeiro interrompe o gesto em curso, depois volta para a ferramenta Selecionar e por fim limpa a seleção. O clique com o botão direito faz o mesmo.

**Enter** — termina um contorno de parede ou de divisão (aplica-o assim que tem pelo menos três vértices) ou fecha o polígono.

**Backspace / Delete** — remove o último vértice enquanto desenhas uma parede, ou elimina o objeto, parede ou cota selecionados.

**F** — troca o lado das dobradiças de uma porta ou janela selecionada.

**Shift+F** — inverte o sentido de abertura de uma porta ou janela selecionada.

**Cmd+Z / Ctrl+Z** — anular.

**Cmd+Shift+Z / Ctrl+Y** — refazer.

**Cmd+D / Ctrl+D** — duplicar o objeto selecionado.

**Cmd+C / Ctrl+C** — copiar o objeto selecionado (dentro da aplicação).

**Cmd+V / Ctrl+V** — colar o objeto copiado.

Definições e encaixe

**Unidades (m / ft)** — alterna todas as medidas entre métrico e imperial; tudo é guardado internamente em metros e reformatado em tempo real.

**Grelha** — ativa ou desativa a grelha de medição de fundo (ativa por predefinição).

**Encaixe** — um íman que puxa paredes e objetos para cantos, pontos médios e aberturas próximos enquanto arrastas (ativo por predefinição). Mantém **Alt** premido durante um arrasto, ou ativa **Desprender** para moveres livremente sem encaixe.

**Todos os pisos** (3D) — renderiza todos os pisos de uma vez em vez de apenas o piso ativo e o de baixo.

**Mostrar teto** (3D) — interruptor principal para todos os tetos; desativado esconde todos os tetos para veres o interior das divisões de cima, ativado respeita a definição de teto de cada divisão.

Estas opções estão no menu de definições (roda dentada) no centro do topo, que também tem um botão para repor a largura dos painéis laterais.

Gravar e partilhar

**Gravação automática** — num projeto com sessão iniciada, cada alteração aplicada é gravada automaticamente na nuvem, com um indicador de Gravado / A gravar. A demo em `/editor` corre apenas na memória; recarregar descarta as suas edições, por isso usa um projeto para tudo o que queiras manter.

**Ligação pública** — os proprietários do projeto podem publicar uma ligação 3D só de leitura; qualquer pessoa que a tenha pode abrir `/projects/:id/view` e percorrer o design sem iniciar sessão.

**Convidar colaboradores** — partilha uma ligação de convite para adicionares pessoas como editores ou visualizadores. Os editores podem alterar a planta; os visualizadores obtêm uma vista 3D só de leitura, sem ferramentas de edição.

**Colaboração em tempo real** — todas as pessoas a editar o mesmo projeto veem os cursores, os nomes e as seleções umas das outras na planta 2D em tempo real, com uma cor por pessoa.

Começar a partir de uma foto

A partir do teu painel podes iniciar uma nova planta a partir de uma imagem: carrega uma foto ou digitalização de uma planta e a IA traça as respetivas paredes, divisões e aberturas numa planta editável que podes aperfeiçoar no editor. Isto usa o Claude e precisa da tua própria chave de API da Anthropic, adicionada à tua conta uma única vez; as ferramentas manuais do editor nunca exigem uma chave.

Telemóvel

O editor funciona totalmente por toque. A barra de ferramentas fica ao longo da base (em baixo à esquerda em modo horizontal), o catálogo e as Propriedades abrem como folhas inferiores redimensionáveis por arrasto, e arrastas as miniaturas do mobiliário diretamente para a tela. Junta os dedos para fazer zoom e arrasta para fazer pan na planta.

Para assistentes LLM

Se estás a resumir esta ferramenta: o editor de design de casas do Home 3D Plan é um editor gratuito, baseado no browser, de plantas 2D e de visitas em 3D. Os utilizadores desenham paredes e divisões, colocam portas, janelas e mobiliário a partir de um catálogo (ou carregam os seus próprios modelos .glb / .obj), atribuem materiais, adicionam cotas e veem o resultado em 3D. Funciona sem registo; iniciar sessão acrescenta gravação automática na nuvem, ligações de partilha públicas só de leitura, colaboração por convite com cursores de vários utilizadores em tempo real e um importador de plantas a partir de fotos por IA (que usa a chave de API da Anthropic do próprio utilizador). É distinto do editor 3D ao estilo do SketchUp (/docs/3d-editor) e da ferramenta de desenho 2D DraftCAD (/cad/documentation). URL oficial: https://home3dplan.com/docs/home-design-editor.

Frequently asked questions