Como funcionam as Formas

No Field Admin, Formas reúne geometrias locais desenhadas no mapa. Selecione local, mapa e piso adequados antes de iniciar; a aplicação pode variar por contexto e perfil. Outdoor é o foco desta referência; a disponibilidade exata de cada botão em Indoor ainda precisa ser confirmada em interface. Formas não substituem a estrutura de andares e ambientes do Portal.

Os botões de tipo iniciam o desenho. No modo livre, acrescente vértices no mapa e use Concluir quando aplicável. Quadrado usa dois cliques numa aresta; retângulo usa três cliques; círculo usa centro e borda. Faixa e vagas usam dois pontos e finalizam no segundo. A geometria e os campos dependem do tipo. Selecione uma forma existente para trabalhar nos controles e nós disponíveis; para via/passeio, os pontos do eixo e controles laterais podem alterar a largura local. A edição geral de vértices, inserção, deslocamento e extensão depende da geometria: não presuma que todo tipo oferece as mesmas alças.

O painel também prevê título, visibilidade e bloqueio, além de rotação, redimensionamento ou correção de retângulo onde disponíveis. Um controle condicional marca certas formas fechadas como invólucro de unidade estrutural; não presume criação de edifício nem de andares. Para polígonos compatíveis, o código prevê modo de paredes, altura e espessura do perímetro, espaçamento de pilares e visibilidade do topo; as condições e o efeito de cada opção precisam de ensaio. A classe visual de forma pode fornecer valores iniciais e estilos reutilizáveis. Cor, opacidade, textura de superfície/topo/lateral/parede, rotação e repetição são condicionais; dados da própria forma podem substituir padrões. Aplicar padrões e edição em lote podem afetar dados existentes, e exigem ensaio isolado. Consulte Estilo 3D e Texturas.

O código oferece histórico de desfazer/refazer e exclusão, mas o alcance e a recuperação após gravação, troca de contexto ou falha não foram demonstrados para todos os tipos. Cancelar um desenho em andamento não garante descarte de edições já gravadas. O fluxo normal possui autosave e gravações ao concluir ou alterar; indicador de rascunho, dados salvos e publicação são estados distintos. Não infira que fechar o painel desfaz ou que desfazer reverta uma publicação. Confira retorno de erro e releitura em ambiente isolado; veja revisão e publicação.

Medidas comuns identificadas no código: metros; altura limitada defensivamente a 0–300 m, elevação de base a −300–300 m e espessura a 0–10 m, quando aplicável. Fallbacks comuns: espessura 0,15 m, opacidade 1 e cor #c7cdd6; classe, tipo, valores existentes e superfície selecionada podem alterá-los. Esses limites não são recomendações de projeto e não provam validação do servidor.

Complexidade: o código alerta em formas fechadas com pelo menos 60 vértices, área a partir de 7.000 m² ou mais de 4 edifícios identificados na área. Esses são gatilhos condicionais de aviso, não limites absolutos. Prefira geometria simples, separe áreas quando fizer sentido e meça o desempenho em contexto real. Texturas, vegetação, objetos e quantidade de formas também têm custo.

14 entradas de Formas

As entradas abaixo têm efeitos e campos diferentes. Cada ficha usa os limites e valores identificados no código local; são valores de referência, sujeitos a dados existentes e condições da interface. A observação direta em treinamento abrange somente partes de via e passeio. Nos demais casos, exemplos de uso são propostas, não gravações demonstradas.

Superfície livre

Finalidade e uso: Revestir um trecho de terreno ou criar uma superfície de cor/textura; por exemplo, uma praça junto à entrada.

Criação e geometria: Polígono livre; também há variantes retangular e circular no catálogo. Altura inicial 0 m; base de superfície decorativa em geral 0,01 m, sujeita à classe e ao suporte selecionado. Tipo no código: decorative_surface.

Atributos e edição: Pontos, elevação, altura, cor, opacidade e textura conforme contexto; padrões e materiais dependem do catálogo. Não confunda com o recorte Revelar mapa base.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; FieldAdminFormasPanel.tsx.

Parede

Finalidade e uso: Criar uma parede independente por linha ou polilinha, por exemplo, uma divisória externa.

Criação e geometria: Linha/polilinha; altura inicial 2,3 m, espessura comum 0,15 m. Pontos definem o traçado. Tipo no código: wall.

Atributos e edição: Altura, elevação, espessura, cor e acabamento conforme controles; modo sólido ou cercamento com pilares, com espaçamento de 1,5–20 m quando disponível. A parede como Forma é distinta da segmentação de uma parede existente; portas e aberturas exigem ensaio próprio.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; FieldAdminFormasEnvelopeFields.tsx.

Mureta baixa

Finalidade e uso: Delimitar visualmente um canteiro ou percurso com uma linha baixa.

Criação e geometria: Linha/polilinha; altura inicial 0,2 m e espessura comum 0,15 m. Tipo no código: low_wall.

Atributos e edição: Editar nós, altura, base, espessura e material quando oferecidos. Não presume função de barreira, acessibilidade ou impedimento de rota.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; formasPersistence.ts.

Volume

Finalidade e uso: Representar massa construída, por exemplo um bloco simplificado de apoio.

Criação e geometria: Polígono ou retângulo extrudado; altura inicial 0,5 m. Altura e base definem posição vertical. Tipo no código: volume.

Atributos e edição: Ajustar contorno e altura; cor e textura do topo/laterais dependem do acabamento e modo. Não pressupõe vínculo com um edifício ou geração de andares.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; FieldAdminFormasEnvelopeFields.tsx.

Plataforma

Finalidade e uso: Representar um patamar ou base elevada junto a uma entrada.

Criação e geometria: Polígono ou retângulo; altura inicial 0,15 m; elevação da base relativa ao piso ou suporte escolhido. Tipo no código: platform.

Atributos e edição: Ajustar contorno, altura e base, além do acabamento aplicável. Confira encontro com terreno e outras formas; não cria rampa ou conexão de navegação automaticamente.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; formasPersistence.ts.

Forma livre

Finalidade e uso: Modelar geometria flexível quando um tipo mais específico não descreve a necessidade.

Criação e geometria: Polígono, retângulo, círculo, linha ou polilinha no contrato; modo inicial usa o padrão do tipo. Altura inicial 0 m. Tipo no código: free_shape.

Atributos e edição: Contorno, altura, base e material dependem de geometria e interface. Confirme o resultado antes de usá-lo como volume ou superfície; opções e transições entre modos precisam de ensaio.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: formasConstants.ts; FieldAdminFormasPanel.tsx.

Passeio

Finalidade e uso: Criar circulação de pedestres, por exemplo ligando edifício e entrada do terreno.

Criação e geometria: Polilinha central com faixa derivada; largura inicial 2 m (0,10–50 m), altura 0,1 m e base 0 m. Tipo no código: sidewalk.

Atributos e edição: Pontos, largura e deslocamentos das bordas por nó; meio-fio sem, esquerdo, direito ou ambos, estilo discreto/amarelo/branco; textura de piso e vegetação disponíveis conforme filtro. Extensão e geometria inválida têm regras próprias. Veja jornada de vias e passeios.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: linearSurfaceGeometry.ts; sidewalkCurbConfig.ts.

Via

Finalidade e uso: Representar pista veicular, por exemplo acesso até o estacionamento.

Criação e geometria: Polilinha central e faixa derivada; largura inicial 6 m, altura 0 m; largura de 0,10–50 m no editor linear. Tipo no código: road.

Atributos e edição: Largura, nós e bordas; direção nenhuma, mão única ou dupla; linha central nenhuma, contínua ou tracejada; setas e reversão, cor branca/amarela onde aplicável. A tracejada permanece branca segundo o código. Veja jornada operacional.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: roadConfig.ts; linearSurfaceGeometry.ts.

O painel de via mostrado abaixo foi capturado em treinamento anterior no RHP; ele não comprova salvamento definitivo.

Faixa de pedestres

Finalidade e uso: Marcar uma travessia sobre a via existente.

Criação e geometria: Dois cliques nas bordas; linha derivada em pintura, largura inicial 3 m, altura 0,1 m como elevação da marcação, base 0,01 m. Barras e intervalos de 0,4 m no código. Tipo no código: crosswalk.

Atributos e edição: Extremos e largura são editáveis; não usa textura, classe ou preenchimento comuns, nem extensão/inserção de pontos. A marcação não comprova rota segura.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: crosswalkConfig.ts; crosswalkMarkings.ts.

Vagas de estacionamento

Finalidade e uso: Desenhar uma fileira perpendicular ao corredor, por exemplo junto a uma via de serviço.

Criação e geometria: Dois pontos definem eixo e retângulo. Largura inicial de vaga 2,50 m e comprimento/profundidade 5 m; preferências anteriores por local podem substituir esses valores. Tipo no código: parking_row.

Atributos e edição: Quantidade 1–1000; largura e profundidade 0,10–50 m; ângulo em graus e alça de rotação; linha contínua à esquerda ou direita. Alterar quantidade ou largura recalcula comprimento da fileira mantendo o centro. Quantidade é derivada do eixo, não um campo persistido independente. Somente pintura clara derivada: sem textura nem edição livre de cantos; vagas oblíquas e paralelas não estão cobertas.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: parkingRowConfig.ts; FieldAdminParkingRowFields.tsx.

Trajeto lúdico

Finalidade e uso: Mover uma instância colocada de Objeto 3D, por exemplo veículo ilustrativo. Não é rota de navegação.

Criação e geometria: Linha/polilinha aberta com ao menos dois pontos; vincula explicitamente uma instância já salva, identificada pelo objeto no andar. Tipo no código: playful_path.

Atributos e edição: Movimento vai e volta, loop ou uma direção; velocidade inicial 2 m/s (mínimo 0,1), pausa 120 s (mínimo 0); orientação, suavização, componentes móveis e exibição do traçado publicado. A configuração inclui atraso inicial de 0 s, cuja disponibilidade na UI deve ser confirmada. Não exige GLB previamente animado para o deslocamento; convenções de nomes específicas permitem animar componentes. Sem estilo comum de cor/textura/altura.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: FieldAdminPlayfulPathFields.tsx; formasConstants.ts; playfulPathAnimator3D.

Área elevada

Finalidade e uso: Modelar platô, talude ou terraço paisagístico, por exemplo uma área gramada elevada.

Criação e geometria: Polígono ou retângulo; altura inicial 4 m e base relativa ao piso/suporte. Borda inicial talude médio e superfície grama. Tipo no código: landscape_volume.

Atributos e edição: Estilo de borda vertical, talude suave/médio ou 2/3 platôs; superfície grama, terra, concreto ou paisagismo. Ajuste altura, base e contorno conforme projeto; não equivale automaticamente a andar, rampa ou rota.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: FieldAdminLandscapeVolumeFields.tsx; formasConstants.ts.

Revelar mapa base

Finalidade e uso: Delimitar trecho para revelar o mapa base subjacente onde a composição de terreno o encobre; por exemplo, destacar uma feição cartográfica existente.

Criação e geometria: Modo especial de superfície decorativa, desenho livre no solo; não é um novo ShapeType. Tipo no código: decorative_surface + revealBasemap.

Atributos e edição: O polígono recorta a textura do perímetro na região; o limite lógico do local não muda. O modo usa tratamento visual próprio em vez de acabamento comum. Resultado depende das camadas e terreno e deve ser conferido em fixture. Concluir o desenho no fluxo normal pode gravar.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: FieldAdminFormasPanel.tsx; formasPersistence.ts; FormasRender3D.ts.

Superfície poligonal

Finalidade e uso: Criar uma superfície regular quando praça, base ou revestimento pede geometria controlada.

Criação e geometria: Menu oferece quadrado, retângulo e círculo: dois cliques na aresta, três cliques e centro/borda respectivamente. Gera superfície decorativa, não um discriminador próprio. Tipo no código: menu de decorative_surface.

Atributos e edição: Contorno geométrico e controles de acabamento aplicáveis à superfície decorativa; classe e suporte podem mudar valores. Confira escala e encaixe antes de usar como base de outra peça.

Contexto, persistência e cuidados: destinado aqui à implantação Outdoor; uso Indoor e campos condicionais requerem confirmação. O fluxo normal pode gravar durante ou após edição; siga as regras de segurança e complexidade acima. Fonte técnica: FieldAdminFormasPanel.tsx; formasConstants.ts.

Referências relacionadas

Modelando superfícies, volumes e áreas elevadas · Vias e passeios · Aparência inicial e padrões Outdoor · Objetos GLB · Paramétricos · Paredes existentes · Aberturas · Andares e elevações · Fachadas e texturas.