Aberturas em paredes e pisos — referência funcional
Consulte os tipos, controles, vínculos e riscos de recortes no mapa 3D.
Os controles e operações descritos foram identificados no código local, sem ensaio do editor nesta etapa. Criar, remover, finalizar desenhos e alterar opções podem gravar. O treinamento de vias e passeios não foi validado para Aberturas. Experimente apenas com dados e armazenamento isolados.
Abertura, elemento visual e acesso
O painel Aberturas distingue Parede e Piso. Na parede, o código prevê Janela — recorte acompanhado de modelo visual — e Vão livre, somente recorte. No piso, um polígono delimita um vazio na laje renderizada. Porta é uma estrutura distinta, com informações próprias de acesso; o recorte por si só não cria porta, POI, rota nem transição navegável.
A parede de suporte pode pertencer a POI poligonal, perímetro do piso ou parede de Forma compatível; a seleção e as permissões variam com o contexto. O proprietário é o elemento ao qual o trecho pertence. Uma escada ou rampa é objeto separado: um vão na laje não cria nem sincroniza automaticamente esse objeto ou sua navegação. Para Outdoor, usos em fachadas e elementos compatíveis dependem de contexto e devem ser testados.
Aberturas em parede
No código do painel, selecione a seção Parede e o dono: perímetro do piso, parede de Forma ou espaço/POI oferecido. Criar abertura usa inicialmente o centro da maior aresta do dono; Posicionar no mapa arma a escolha por clique e projeta para um alvo próximo. Ambos podem gravar ao criar: não são apenas prévias. A disponibilidade e a escolha de alvo precisam de ensaio em fixture.
| Campo | Controle e valores | Efeito e condições |
|---|---|---|
| Tipo | Seletor: Janela ou Vão livre; inicial Janela. | Janela adiciona modelo; vão apenas recorta. Aplicação depende de salvar a edição. |
| Modelo da janela | Seletor: Vidro, Madeira ou Metal; inicial Vidro. | Disponível para Janela; o modelo é visual, separado do recorte. Não há campo comprovado de cor livre ou textura individual neste painel. |
| Largura (m) e Altura (m) | Números, início 1,20 m cada; controle mínimo 0,05 m e passo 0,1 m. | Recorte deve caber na aresta e na altura; código pode ajustar dimensões e informar ajuste. Máximos dependem da parede e validação. |
| Altura da base (m) | Número, início 0,90 m, mínimo 0, passo 0,1 m. | Relativa à base da parede; base + altura deve caber. Para passagem ao nível do piso, verificar projeto e base adequada. |
| Parede | Seletor de segmentos numerados. | Escolhe a aresta do dono; a numeração pode mudar após divisão de geometria. |
| Posição na parede (m) | Número, mínimo 0, passo 0,1 m. | Deslocamento do centro ao longo da aresta; largura ocupa metade de cada lado. A orientação segue a parede, sem campo de ângulo próprio identificado. |
O painel prevê arraste do marcador e alteração dos campos como prévia em memória; para item existente, Salvar persiste e Remover janela solicita remoção. O rótulo pode ser o mesmo para vão livre. Não foi identificado controle independente de profundidade: a parede fornece o suporte de espessura. Não há comprovação de herança de cor ou material de janela.
A validação local verifica dimensões positivas, segmento existente, altura disponível, comprimento e sobreposição horizontal com porta ou outra abertura da mesma aresta, com tolerância de 0,02 m. O ajuste prévio pode reduzir ou deslocar o recorte; mensagens e validações de servidor precisam de ensaio. O código tem parâmetro para parede habilitada, mas nos caminhos de criação e salvamento analisados passa o valor verdadeiro: não presuma que a interface recuse todos os segmentos desativados.
Aberturas em piso
O vão é armazenado na lista floorOpenings dos metadados do piso ativo, como polígono de coordenadas; a geometria da laje o usa como recorte. Não há campo independente de largura, comprimento ou ângulo identificado: dimensões e orientação resultam dos pontos desenhados. Não altera automaticamente a composição lógica do edifício, rampas ou rotas.
| Controle | Função e persistência |
|---|---|
| Nome (opcional) | Texto; o código sugere nome a partir do contexto. Para item existente, Salvar nome grava. |
| Criar vão / Finalizar desenho | Inicia contorno; cliques acrescentam pontos. Finalizar valida e solicita gravação no piso ativo. |
| Desfazer último ponto / Cancelar | Durante desenho, remove o último ponto ou cancela o desenho; não reverte uma abertura já gravada. |
| Editar contorno / Salvar contorno | Arrastar pontos move; arrastar + na aresta insere; duplo clique remove ponto mantendo pelo menos 3. Salvar contorno solicita gravação. |
| Mostrar piso inferior | Caixa para exibição contextual do piso imediatamente inferior; alteração em item selecionado solicita gravação imediata da preferência. Código trata a opção ausente como ativa. |
| Alinhar parede do piso inferior | Caixa condicional à exibição inferior; ajuste local de renderização, não alteração geométrica comprovada do piso inferior. Alteração solicita gravação imediata da preferência. |
| Remover | Solicita gravação da lista sem o vão selecionado; confirme resultado e releitura. |
O código exige ao menos três pontos, polígono sem autointerseção e área mínima de 0,05 m²; não estabelece aqui tamanho adequado à rampa ou regras universais de afastamento de bordas. Piso inferior ausente, ambíguo ou indisponível gera mensagens relacionadas a edifício e cotas. A forma de recorte e seus limites contra perímetro e paredes devem ser verificados em fixture.
Vínculo com segmentos, portas e aberturas
O vínculo de abertura de parede inclui índice da aresta, posição do centro ao longo dela e ponto projetado. A segmentação insere vértice e pode reindexar e remapear aberturas e portas. O cálculo associa o centro a um dos trechos; isso não demonstra que uma abertura que atravesse a nova divisão continue válida. Dividir próximo ou através de um vão existente exige ensaio e revisão da geometria e dos vínculos.
Para perímetro, uma operação pode envolver várias gravações e ter erro parcial. Não presuma que Cancelar desfaça uma etapa já gravada. Confira situação de portas, aberturas e recorte após releitura antes de qualquer nova tentativa.
Gravação, migração e limitações
O código grava a criação de parede no botão ou após posicionar no mapa; edição de item existente usa Salvar e remoção chama persistência. Para piso, finalizar desenho, salvar contorno ou nome e remover solicitam gravação. Mostrar piso inferior e Alinhar parede do piso inferior também acionam gravação ao alternar. Prévia de campos ou arraste em memória não prova persistência; Cancelar desenho não reverte gravações anteriores. Não se identificou desfazer geral de abertura salva.
Migração automática: ao ativar o painel, o código tenta migrar aberturas legadas da raiz para os metadados do piso 0 se encontrar dados órfãos e o piso 0 ainda não os tiver. Nessas condições, até abrir o módulo pode gerar escrita. As condições, permissões, falhas e comportamento implantado precisam ser testados em ambiente isolado.
Persistência usa serviços específicos para POI, perímetro, Forma e metadados de piso; no piso há verificação de resposta ou releitura. Confirmação visual, dados gravados, estado de rascunho e publicação são diferentes. Consulte revisão e publicação. Fontes: FieldAdminOpeningsPanel.tsx, wallOpeningValidation.ts, wallOpeningFit.ts, floorOpeningPersistence.ts, floorOpeningGeometry.ts, wallOpening.d.ts e windowModels.ts.
Veja também
Jornada de janelas, vãos e pisos · Segmentação de paredes · Formas · Paramétricos · Escadas e rampas · Andares e elevações · Portas · Texturas e fachadas · POIs · Rotas.