Conceitos e escopo

Um objeto paramétrico combina dimensões, quantidade, disposição e aparência para criar elementos recorrentes sem modelar cada peça manualmente. Escadas, rampas, guichês e sanitários usam geometria gerada pelo aplicativo; alguns arranjos usam modelos GLB da biblioteca.

Um GLB de biblioteca é um recurso reutilizável; uma instância GLB é sua colocação no mapa. Um arranjo paramétrico pode distribuir várias cópias de um modelo compatível. Seus parâmetros geométricos determinam a disposição; cor, tom e estilo ajustam a aparência quando disponíveis. O objeto pertence a um local e piso; a recepção pode utilizar um POI hospedeiro para encaixe. Não se deve presumir associação automática a um POI, abertura ou rota.

O painel apresenta tipos para arrastar ao mapa e lista elementos Neste andar. A interface oferece seleção, edição, rotação, exclusão e salvar; a disponibilidade real e os efeitos exatos por perfil ainda precisam de observação segura. Os limites de interface e normalização abaixo são evidência do código, não necessariamente limites do servidor. Contextos Indoor e Outdoor citados são exemplos, não uma matriz de disponibilidade confirmada.

Consulte Modelando escadas e rampas, capacidades de GLB e ferramentas básicas.

Consultar por tipo

• Escada de um lance
• Escada de dois lances (180°)
• Rampa
• Fila de cadeiras
• Conjunto de cancelas
• Bancos de viga
• Sala de espera
• Guichê de atendimento
• Sanitário público
• Grade de cadeiras
• Mesa de reunião
• Lavabo
• Lavabo acessível
• Recepção

Fundamentos comuns

Confira local, andar, elevação, orientação e espaço disponível antes de trabalhar. Valores iniciais indicados são os defaults no código; valores efetivos podem refletir dados do andar ou registros antigos. Campo numérico, seletor e botão podem ser exibidos de forma condicional. Um controle não mostrado no editor não deve ser inferido pela existência de uma propriedade interna.

Para arranjos com GLB, as capacidades chair, meeting_table, reception_desk, turnstile, bench e sofa determinam a compatibilidade funcional; door serve ao resolvedor de portas e não torna um objeto um arranjo de mobiliário. Um candidato precisa de modelo resolvível e largura e profundidade positivas. O nome ou a categoria visual não são suficientes. Cancela, banco e sofá têm fallback incorporado em condições específicas; cadeiras, mesas e balcões não têm fallback garantido no fluxo examinado. Estilos podem ser do local ou específicos do arranjo.

Quantidades de modelos, materiais, geometria e texturas afetam o desempenho. Cor/tom procedural e materiais de GLB são coisas distintas. Criação e edição usam pins; o código agenda salvamento após mudanças, além do botão Salvar. Não presuma que sair ou trocar de seleção descarte alterações.

Circulação vertical

1. Escada de um lance

Identificador: stair-straight.

• Finalidade/contexto: conectar visualmente níveis; exemplo recomendado entre dois pisos Indoor. Elegibilidade Outdoor não demonstrada.
• Controles do editor: altura piso a piso (número, passo 0,1 m, mínimo 0,5; padrão 3); largura (0,05 m, mínimo 0,4; padrão 1,2); quantidade de degraus (inteiro 2–60, padrão 18); profundidade do piso (0,01 m, mínimo 0,15; padrão 0,28); cor e tonalidade; rotação. A estrutura contém outros campos genéricos que não devem ser divulgados como controles deste tipo.
• Geometria/dependências: altura e degraus determinam elevação por espelho; profundidade e contagem influem no desenvolvimento. Procedural, sem seleção GLB obrigatória. Conferir escala, encontro com aberturas e proteção de bordas.
• Acabamento/desempenho: cor/tom procedurais; mais degraus elevam geometria. Persistência/validação: regras comuns acima; fixture deve verificar limites, renderização e mensagem de erro. Exemplo: 3 m, 18 degraus, comparar planta e perspectiva.

2. Escada de dois lances (180°)

Identificador: stair-u.

• Finalidade/contexto: conectar níveis com retorno; exemplo Indoor. Procedural, sem GLB.
• Campos: como escada simples, porém largura padrão 1,4 m; acrescenta profundidade do patamar (número, passo 0,05 m, mínimo 0,8, padrão 1,4) e botão “Inverter lances” (booleano, padrão falso). Altura padrão 3 m, degraus 18, piso 0,28 m.
• Dependências: patamar, número e inversão alteram disposição dos dois lances; conferir volume, acesso e patamar em fixture. Cor/tom comuns. Exemplo: alternar inversão e comparar percurso e planta. Persistência/visual: regras comuns; não ensaiado.

3. Rampa

Identificador: ramp.

• Finalidade/contexto: circulação entre cotas; exemplo Indoor/Outdoor sujeito a elegibilidade. A geometria não certifica acessibilidade.
• Campos: altura (padrão 3 m, mínimo 0,5), largura (1,4 m, mínimo 0,4), comprimento (8 m, mínimo 1; somente leitura quando há traçado), cor/tom, corrimão booleano padrão falso, acabamento solid/shaded (novo padrão solid; ausência legada normaliza shaded), opções de via/marcações conforme editor. Traçado selecionável reta, U (arc) ou C (c); personalizado aparece para caminho existente.
• Traçado: raio mínimo no controle = largura × 0,55 + 0,1 m; trecho reto do C mínimo largura + 0,1 m. Patamar de pontas 0–comprimento/4; trecho visível simplificado 2–comprimento/2; recuo de sinalização 0–comprimento/3; mureta 0–0,8 m; transição 0–mínimo(20 m, comprimento/4) no controle. Sinalizações SOBE/DESCE e vista simplificada são condicionais ao caminho.
• Validação do caminho: 3–512 pontos, coordenadas finitas até ±10.000, comprimento 1–10.000 m, distância entre extremos ≥0,1 m; rejeita reversões fortes e cruzamentos. Largura pode ser reduzida pela geometria. Procedural, sem GLB obrigatório; curvas e detalhes aumentam custo. Exemplo: rampa U em fixture com comparação entre andares e marcação; salvar/rota/acessibilidade pendentes.

Assentos e mobiliário

4. Fila de cadeiras

Identificador: chair-row.

• Finalidade/contexto: organizar assentos em linha; exemplo sala Indoor. Capacidade chair; depende de modelo publicável/resolvível com largura/profundidade positivas, sem fallback incorporado garantido.
• Campos: seletor de modelo; quantidade inteiro 1–40 padrão 4; espaçamento em m mínimo 0,3 padrão 0,72, passo 0,01; estilo da cadeira no local ou só no arranjo quando disponível; rotação.
• Geometria: módulos alinhados; área pode crescer para acomodar modelo. Multiplicar cadeiras pode ampliar custo, mesmo com reutilização. Exemplo: quatro cadeiras em linha, comparar troca de modelo/estilo em fixture. Erros: cadeira não selecionada ou ausente do catálogo têm mensagens específicas; gravação conforme regra comum.

Atendimento e controle de acesso

5. Conjunto de cancelas

Identificador: turnstile-row.

• Finalidade/contexto: fila de módulos de controle de acesso; exemplo entrada de prédio. Capacidade turnstile; nova fila prefere chave incorporada turnstile, com modelos compatíveis como alternativas quando oferecidas.
• Campos: modelo, quantidade inteiro 1–24 padrão 3; espaçamento de centro a centro padrão 1,2 m, mínimo 1,1824 m conforme módulo incorporado; inversão de passagem posZ/negZ, padrão posZ; estilo quando disponível.
• Geometria: dimensões incorporadas 1,1824 × 0,352 × 0,95 m; mínimo evita sobreposição do modelo padrão. Outro modelo precisa de medidas válidas; testar encaixe. Exemplo: três unidades, comparar sentido. Risco/validação: criação e alteração persistem; sem ensaio de seletor ou passagem.

Bancos e espera

6. Bancos de viga

Identificador: bench-row.

• Finalidade/contexto: organizar assentos longos; exemplo espera Indoor. Capacidade bench, fallback incorporado bench.
• Campos: modelo, quantidade 1–24 padrão 3; espaçamento padrão 1,2 m e mínimo 1,139 m; botão inverter lado, estilo quando disponível.
• Geometria: módulo incorporado medido 1,139 × 0,717 × 0,436 m; modelo é simétrico. Muitas instâncias têm custo cumulativo. Exemplo: três bancos e folga de circulação. Visual/persistência: pendentes conforme regra comum.

7. Sala de espera

Identificador: waiting-room.

• Finalidade/contexto: compor móveis e mesas em espera; exemplo hospital Indoor. Capacidade sofa, fallback incorporado sofa (3 lugares); um modelo para o arranjo.
• Campos: planta Linha/L/U/O; quantidade por lado ativo 1–12 (lado superior inicial 3; demais inativos inicialmente); folga padrão 0,15 m, normalizada 0–1 m; escala 0,5–1,5 padrão 1, passo 0,05; mesas de canto/pontas e de centro booleanas, padrão falsas; largura/profundidade da área e “Ajustar ao mínimo”; estilo.
• Dependências: planta ativa lados específicos, lados inativos tornam-se zero; quantidades contam móveis, não pessoas. Módulo padrão 1,85 × 0,735 × 0,99 m; mesas e área de circulação alteram envelope. Modelo, quantidade e mesas afetam custo. Exemplo: planta U com mesa de centro. Seleção, ajuste e escrita não testados.

Atendimento e sanitários

8. Guichê de atendimento

Identificador: service-counter.

• Finalidade/contexto: balcão modular de atendimento; exemplo recepção Indoor. Geometria procedural sem GLB externo.
• Campos: Postos 1–12 padrão 3; largura por posto 0,8–2 m padrão 1,2, passo 0,05; divisórias booleano padrão verdadeiro; postos na perna em L 0–8 padrão 0; inverter lado do público posZ/negZ; cor e tom.
• Geometria: corpo 0,7 m profundidade × 1,1 m altura; faixa pública mínima 0,8 m; retorno cresce com módulos. Muitos postos/divisórias aumentam geometria. Exemplo: três postos e retorno em L, comparando lado do público. Validação: gravação e colisões em fixture.

9. Sanitário público

Identificador: public-restroom.

• Finalidade/contexto: compor cabines, pias e mictórios; exemplo Indoor. Geometria procedural, não é repetição de lavabos GLB.
• Campos: Ala Feminino/Masculino padrão feminino; Cabines e Pias padrão 2 (UI mostra mínimo 1, máximo 12; normalização aceita 0–12); Mictórios sem/individuais/calha, quantidade 1–12 padrão 2, exibidos condicionalmente para ala masculina; Divisórias padrão verdadeiro; cor/tom.
• Dependências: ala feminina normaliza mictórios para nenhum. Cabine 0,9 × 1,5 m, divisória 1,8 m, pia 0,6 m, faixa circulação 1 m no código. Mais peças e divisórias elevam custo. Exemplo: ala masculina com mictórios individuais e comparação da ala feminina. Conferir UI e requisitos reais de projeto.

Arranjos de mobiliário

10. Grade de cadeiras

Identificador: chair-grid.

• Finalidade/contexto: assentos em linhas e colunas, exemplo auditório Indoor. Capacidade chair, sem fallback garantido.
• Campos: modelo; linhas e colunas inteiras 1–20 padrão 3 × 4; espaçamento horizontal/vertical mínimo 0,3 m padrão 0,72/0,85 m; estilo do local ou arranjo quando disponível.
• Geometria/custo: até 400 posições pela combinação dos limites, sujeito a limites de contexto; medir densidade e geometria efetiva antes de recomendar extremos. Exemplo: 3 × 4 com corredor visível. Modelo ausente gera aviso; salvar e renderização são pendentes.

11. Mesa de reunião

Identificador: meeting-table.

• Finalidade/contexto: mesa com cadeiras; exemplo sala Indoor. Requer capacidades chair e meeting_table, referências resolvíveis e dimensões positivas; nenhum fallback garantido para ambos.
• Campos: seletores de cadeira e mesa; cadeiras por lado 1–12 padrão 3; cadeiras nas cabeceiras booleano padrão verdadeiro; distância da cadeira à mesa mínimo 0,1 m padrão 0,35; estilo por modelo ou arranjo conforme UI.
• Geometria: assentos nas laterais e opcionalmente pontas; tamanho e orientação do GLB influenciam disposição. Avaliar total de cadeiras e materiais. Exemplo: seis cadeiras laterais e duas cabeceiras; verificar seleção e limites em fixture.

Lavabos e recepção

12. Lavabo

Identificador: lavabo.

• Finalidade/contexto: conjunto sanitário compacto; exemplo Indoor. Peças procedurais, sem GLB obrigatório.
• Campos: largura padrão 1,6 m, profundidade 1,8 m, mínimos 0,8 m e passo 0,05; layout esquerda/direita padrão direita; composição parede do fundo/em L padrão parede do fundo; cor/tom conforme editor e rotação.
• Dependências: layout e composição alteram disposição; comparar envelope com paredes e aberturas. Cor padrão cerâmica #f7f7f5. Exemplo: inverter layout em fixture. Não afirmar adequação normativa; persistência comum.

13. Lavabo acessível

Identificador: lavabo-accessible.

• Finalidade/contexto: variante com área maior; exemplo Indoor. A denominação não certifica requisitos legais de acessibilidade.
• Campos: mesmos controles do lavabo; largura e profundidade padrão 2,2 m; layout direita; composição em L; mínimos técnicos 0,8 m não são recomendação de projeto.
• Dependências: verificar espaço livre, orientação e equipamentos de acordo com projeto aprovado. Peças procedurais, custo varia com detalhes. Exemplo: comparar disposição em L e espelhamento; ensaio isolado pendente.

14. Recepção

Identificador: reception.

• Finalidade/contexto: cadeira em grade com balcão associado a sala/POI; exemplo recepção hospitalar Indoor. Requer chair e reception_desk com versões e dimensões válidas.
• Campos: modelos de cadeira/balcão; linhas e colunas 1–20 padrão 3 × 4; espaçamento 0,72/0,85 m mínimo 0,3; distância ao balcão mínimo 0,1 m, padrão de criação 1 m; registros antigos sem valor mantêm fallback 0,45 m; lado auto/posX/negX/posZ/negZ, alinhamento centro/início/extremidade; “Reencaixar na sala”; estilo.
• Dependências: hostPoiId e polígono disponível para reencaixe automático; sem hospedeiro/anel válido o ajuste não é garantido. As dimensões dos GLBs e limites da sala influenciam o cálculo. Até 400 cadeiras pelos limites independentes, custo precisa de medição. Exemplo: fixture com POI retangular e balcão em outra parede. Avisos de modelos não selecionados ou ausentes; persistência e encaixe a validar.

Persistência, validações e fontes

O código prevê estados Alterações não salvas, Salvando…, Salvo e erro. As atualizações podem agendar gravação após cerca de 700 ms; remoção também é persistente. O sucesso do pin e a publicação do mapa são etapas distintas. Permissões VA reais, falhas, concorrência, troca de seleção, cancelamento, publicação e efeitos sobre outros elementos exigem ensaio isolado.

Fontes principais: parametricTypes.ts, FieldAdminParametricPanel.tsx, parametricAuthoringCatalog.ts, useParametricInstances.ts e parametricInstanceApi.ts. A lista de parâmetros, exemplos e limites nesta página é baseada no código, não em ações de escrita comprovadas.

Veja jornada de circulação vertical, pisos e elevações, aberturas, portas, rotas e Formas.