Volumes externos de edifícios — referência funcional
Conheça prismas, faixas, faces e persistência da representação externa de um edifício.
Controles e regras foram identificados no código local; esta etapa não ensaiou a interface ou a gravação. Alterar volumes pode gravar imediatamente. Não experimente em dados reais; use fixture com armazenamento isolado. O treinamento de vias e passeios não foi validado para volumes externos.
Estrutura, edifício e geometria
Unidade estrutural, edifício, mapas e pisos pertencem à composição lógica preparada no Core e Portal; plantas e cotas são referências a conferir. O volume externo é um prisma associado à representação do edifício, com contorno e faixa vertical. Pode haver vários prismas para o mesmo POI, sem criar um cartão de POI para cada bloco. O mapa Outdoor mostra a representação física; pisos Indoor e rotas são configurações distintas.
No caminho de volumes empilhados analisado, o Field Admin procura o POI ao vivo ligado a um edifício reconhecido e verifica o contexto Outdoor quando identificado. Os pisos Indoor ligados ao edifício alimentam seletores quando disponíveis; não são obrigatórios para representar todas as faixas por metros. O painel também tem caminhos de edição apenas de perímetro para outros suportes: não conclua que qualquer POI Outdoor tenha autoria de volumes empilhados. A ausência de unidade, vínculo, contorno ou mapa pode limitar a ferramenta; não recrie a estrutura lógica no editor para contornar isso.
Plataformas, áreas elevadas, Coberturas, Topos do andar, portas, aberturas, objetos e rotas são mecanismos distintos. Compare cotas e vínculos, sem presumir atualização automática de todos após editar um prisma.
Volume externo e Forma Volume
| Aspecto | Volume externo do edifício | Forma Volume |
|---|---|---|
| Suporte e identidade | Prismas autorados em externalVolumes da representação do edifício; compartilham o POI de suporte. | Geometria independente desenhada no módulo Formas, associada ao mapa/piso. |
| Geometria e alturas | Contorno próprio por prisma e faixa resolvida por pisos e/ou cotas em metros relativas ao plano Outdoor. | Polígono/retângulo, base e altura próprios da Forma; não constitui por si a composição do edifício. |
| Faces e persistência | Topo e exceções de fachada por prisma; a lista pode ser gravada no POI pelo painel de Estilo. | Acabamentos e gravação seguem o fluxo de Formas, com seleção e persistência próprias. |
| Escolha editorial | Prefira avaliar este mecanismo para representar torre e base vinculadas ao mesmo edifício. | Avalie para peça independente, como base ou elemento auxiliar, quando o projeto pedir. |
Exemplo: usar uma Forma Volume como torre pode gerar uma peça visual sem a mesma integração de faixas e identidade do edifício e exigir correções adicionais. Isso é orientação de planejamento, não proibição técnica; ambos podem coexistir quando suas funções forem entendidas.
Controles de volumes
Na seção Volumes externos de Estilo 3D do alvo compatível, o código mostra Volume base e Volume {n}; o identificador é interno e não se identificou campo de nome individual ou tipo funcional. Se a lista estiver ausente, o renderizador pode usar um prisma legado a partir do contorno e altura do POI.
| Controle / identificador | Finalidade e valores | Dependência e persistência |
|---|---|---|
Adicionar volume fieldAdminExternalVolumesAdd | Na primeira adição, tenta gerar base e torre copiando contorno e dividindo a faixa existente; depois copia o último contorno e sugere próxima faixa. | Requer contexto e contorno válidos. A mudança da lista chama gravação diretamente no caminho VA analisado. |
De / Até fromFloor / toFloor | Seletores de pisos disponíveis do edifício; o piso Até é incluído na faixa. | Exibidos quando há pisos Indoor associados; faixas resolvidas dependem das cotas e não implicam edição dos pisos. |
Altura da base / topo do volume (m) minHeightM / maxHeightM | Números em metros, passo 0,1, relativos ao plano Outdoor; não são necessariamente altura geométrica da peça. | Campos podem ficar vazios; controle não declara mínimo/máximo explícitos. Ao editar, o caminho VA chama gravação. |
| Exibir topo / Textura do topo / Cor do topo | Visibilidade, seleção de textura ou Sem textura/Herdar do espaço e cor. Valores ausentes podem herdar do POI; Sem textura é exceção explícita. | Aplicam-se ao topo do prisma, não a todas as faces laterais; mudanças usam o caminho da lista. |
| Editar perímetro / Concluir edição | Manipula vértices do contorno; controle de meio de aresta adiciona vértice e duplo clique remove, respeitando mínimo de três. | Geometria de volume autorado usa o caminho da lista; perímetro legado tem gravação e vínculos próprios. |
| Redesenhar perímetro / Concluir desenho / Cancelar desenho | Desenha anel no mapa; ao menos três pontos para concluir. Cancelar desenho interrompe essa operação de desenho. | Não garante desfazer gravações anteriores ou uma edição já persistida. |
| Coincidir proximidade | Ajusta vértices próximos ao volume inferior; o código usa limiar de 1,2 m na operação de autoria. | Disponível com alvo inferior aplicável; altera o volume escolhido e pode gravar. Recuos intencionais exigem cuidado. |
| Remover | Abre confirmação para excluir o prisma da lista; os demais permanecem. | Confirmar chama alteração da lista e pode gravar. Não presume recuperação automática. |
Referência técnica: FieldAdminExternalVolumesSection.tsx, FieldAdminVaSectorStylePanel.tsx, externalVolumesBridge.ts e externalVolume.d.ts. São controles identificados no código, não observação de disponibilidade para todos os perfis ou contextos.
Faixas verticais e encontros
O código resolve De até o nível imediatamente superior a Até; no último piso considera o topo externo ou altura da parede quando aplicável, com fallback de 3 m em casos previstos. Metros autorados podem ampliar a faixa resolvida: o cálculo considera o menor entre base derivada e base informada e o maior entre topo derivado e topo informado. Logo, um número digitado não deve ser interpretado isoladamente como altura final garantida.
Sem resolução de pisos, base e topo em metros podem definir a faixa quando válidos; combinações inválidas ou dados ausentes podem acionar fallback ou deixar o prisma sem resolução. Valores iniciais dependem da geometria e altura existentes. Ao adicionar depois da primeira vez, o código sugere base no topo anterior e, se disponível, topo anterior + 9 m; é sugestão técnica, não medida de projeto.
Exemplo ilustrativo: base de 0 a 5 m e torre de 5 a 20 m podem representar térreo alto e corpo superior; valores reais e resultado do cálculo precisam ser conferidos. O renderizador alinha interfaces próximas e aplica ajustes visuais em encontros; isso não significa união booleana, corte automático ou correção permanente dos polígonos. Recuos e balanços podem existir. Confira vazios, sobreposições e faces em perspectiva e planta. A alteração das cotas dos pisos pode mudar a faixa resolvida, sem comprovar atualização dos dados de todos os módulos.
Faces, fachadas e materiais
Cada aresta do contorno de um prisma identifica uma face local; mudar contorno pode reindexar associações. O fluxo separado Aplicar em fachada de Texturas prevê pintura por face ou escopo do prédio. Para volumes, o código documenta o escopo de prédio aplicado ao prisma em questão; não presuma que pinte todos os prismas do edifício.
A textura exige largura e altura reais em metros; o pincel prevê espelhamento, calibração da face e deslocamento vertical em condições específicas. O contorno e a faixa determinam orientação e posição da face; inspecione ângulos e escala. A exceção de face do volume tem prioridade; no volume base, faces sem exceção podem recorrer às exceções do POI. Um apagamento explícito bloqueia herança; prismas superiores não herdam automaticamente as exceções de face da base. Não confunda configuração de topo com textura de fachada.
Aplicar, calibrar, apagar e salvar texturas seguem fluxo próprio e podem gravar vários alvos; mensagens de falha ou salvamento parcial exigem revisão. Veja Paredes e segmentos para diferenças de proprietário e Biblioteca de Texturas para recursos.
Gravação e integridade
No painel VA analisado, persistVolumes atualiza o rascunho local, aplica prévia e chama serviço de gravação do POI ao receber mudanças da lista. Adicionar, editar campos ou contornos, coincidir vértices e confirmar remoção podem portanto gravar sem aguardar Salvar geral. O fluxo não deve ser tratado como prévia segura; falhas e concorrência precisam de ensaio com resposta e releitura.
O caminho do perímetro legado é separado: concluir a edição pode gravar contorno do POI e exigir sincronização de representações ligadas, edifício ou pisos correspondentes; o código possui confirmações e mensagens de conflito/fracasso. Em alguns caminhos, fechar um painel com alteração pendente também pode disparar commit. Segmentos, portas e aberturas podem ser remapeados ou exigir revisão. Não presuma que Cancelar ou fechar reverta o que já foi enviado, nem atomicidade ou rollback integral em erro parcial.
Ao criar volumes autorados, o contorno legado e a lista de prismas não são automaticamente sincronizados em todos os casos. A visualização, rascunho gravado e publicação são distintos. Compare dados, contexto e versão com o responsável antes de qualquer repetição.
Conferência e desempenho
Mais prismas, faces, texturas e sobreposições podem aumentar custo visual e de renderização. Como boa prática editorial, evite geometrias redundantes, avalie tamanho dos arquivos e teste o resultado em desktop e celular com dados representativos; não há limite universal de volumes estabelecido aqui. Compare proporção, encontros, cobertura, acessos e posição relativa a pisos e terreno.
Portas e aberturas são tratadas principalmente no contorno base/legado no fluxo documentado; não presuma suporte em cada prisma superior. Coberturas podem usar um volume de suporte conforme geometria; Topo de andar é outro mecanismo. Rotas, POIs e GLBs exigem verificação separada.
Jornada de composição externa · Andares e cotas · Posicionamento · Coberturas · Portas · Aberturas · Rotas.