Evidência e segurança

Interface observada na etapa 9B: biblioteca, lista de instâncias e formulário vazio em VA emulado, sem gravar. Código: campos, limites do cliente, capacidades e mecanismos abaixo foram identificados na implementação. Pendente: permissões reais, rótulos condicionais, gravação, falhas, propagação, disponibilidade e resultados visuais em fixture. Não trate uma prévia como confirmação de persistência ou publicação.

Catálogo, instâncias e versões

Registros globais e específicos do local agrupam modelos por nome, categoria e tags. Galeria e painel preveem busca, filtros, prévia e download quando disponível; o painel também lista instâncias e oferece ações de inserção, recolocação, edição, estilo e remoção conforme perfil e contexto.

O modelo de dados distingue registro, rascunho e versões publicadas ou arquivadas. Uma instância referencia uma versão específica; publicar outra versão não significa atualizá-la automaticamente. A propagação, atualização das instâncias existentes, histórico e opções de arquivamento disponíveis no produto exigem ensaio isolado. Remover uma instância não deve ser confundido com alterar o catálogo.

As categorias incluem circulação, orientação, controle de acesso, atendimento, mobiliário, paisagismo, comercial, eventos, hospital, humanoides, varejo, parques, aeroportos, exterior e técnico. São agrupamentos, não garantias de compatibilidade com arranjos.

Campos do modelo

Categoria, tags, compatibilidade e referência incorporada são condicionais no formulário. O fluxo de criação local usa caminho de publicação, enquanto o fluxo global prevê rascunho; confirme os controles e respostas no ambiente antes de operar.

Transformação e personalização

O padrão do modelo fornece escala, orientação, elevação, dimensões, estilo e política; a instância possui posição e ajustes próprios. O helper de escala limita a 0,2–12, ou 20–1200%; o slider pode apresentar faixa visual menor. Alterar um padrão não prova que cada instância existente será atualizada.

Os modos de estilo identificados são Fixo (materiais originais), Variantes (presets), Parcial e Completo. Slots podem atingir todos os materiais ou aqueles identificados por nome/índice. Conforme a implementação e o perfil, controles incluem cor, metalicidade, rugosidade e intensidade de reflexo; há opção de preset de material indicada como pendente em determinados contextos. Overrides podem aplicar-se ao local ou a uma instância. Não há evidência suficiente para prometer substituição arbitrária das texturas internas do GLB.

Envio, análise e arquivos

O cliente aceita `.glb` e `.gltf` até 50 MiB; miniaturas até 5 MiB. O serviço examinado valida extensão e tamanho, envia o arquivo e torna a URL pública; não inclua conteúdo confidencial. O comportamento de dependências externas de `.gltf` e outros limites do servidor não foram validados.

Após envio, o código tenta obter dimensões e métricas. Falha da análise pode deixar o arquivo já enviado e dados técnicos desconhecidos. Verifique registro e armazenamento antes de repetir. O fluxo examinado não demonstra otimização automática da geometria: simplifique e teste o arquivo antes de enviar. Produção de GLBs apresenta orientações adicionais.

Desempenho: transferência, complexidade e uso

O tamanho em bytes impacta transferência; geometria, primitivas, materiais, texturas, animações e número de instâncias também influenciam o custo de renderização. Cache e reutilização podem reduzir transferências repetidas, mas não eliminam o custo de desenhar cada instância. Triângulos e vértices descrevem geometria; meshes e primitivas particionam o modelo. Primitivas não são uma medida direta de draw calls reais.

O diagnóstico classifica métricas com faixas iniciais; os limites abaixo são indicadores, não limites obrigatórios de upload. Cada valor é o teto inclusivo da respectiva faixa; acima do teto pesado, o indicador é crítico.

O painel pode mostrar vértices, meshes, contagens, resolução máxima, compatibilidade Draco/Meshopt/KTX2/WebP, skins e animações. Métricas parciais ou desconhecidas não significam modelo inválido; compressão pode impedir análise precisa. As mensagens são geradas a partir das faixas e da situação da análise, e o diagnóstico agrega fatores. Avalie o resultado completo e a quantidade de instâncias.

Para reduzir custo, remova geometria invisível, simplifique malhas, reúna materiais quando possível, reduza resolução e quantidade de texturas e teste em dispositivo alvo. Extensões de compressão devem ser verificadas no visualizador antes de adotar. Valores são calibração inicial, não garantia de fluidez.

Políticas de exibição

Essential: o filtro de política mantém o objeto, sujeito ao piso e a outras regras da cena. Adaptive: com detalhes ativos ou durante rota passa pelo filtro; em modo otimizado usa zoom e diagnóstico. Optional: requer detalhes ativos e não passa durante otimização de rota. Há exceções configuradas de exibição garantida em desktop/totem e filtragem separada para trajetos lúdicos.

No código atual, a calibração adaptativa esconde abaixo de zoom 15; modelos pesados requerem pelo menos 16 e críticos não aparecem automaticamente nesse modo. Zoom ausente dispensa a verificação de zoom, mas não a restrição de crítico. Esses valores são calibração sujeita a revisão; verificar no ambiente e dispositivo reais.

Capacidades para componentes paramétricos

As capacidades são tags reservadas, independentes do nome e da categoria: chair, meeting_table, reception_desk, turnstile, sofa, bench e door. Um modelo pode ter mais de uma. Há compatibilidade explícita para algumas chaves legadas; não atribua capacidade apenas pelo nome visível.

Para autoria, o candidato precisa de modelo resolvível, versão utilizável e largura e profundidade finitas e positivas. Existem fallbacks incorporados para cancela, banco e sofá em condições específicas; uma cancela nova prefere o modelo incorporado. Nem todo papel necessariamente apresenta o mesmo seletor. Medidas, seleção e fallback precisam de ensaio antes de compor os guias dos Paramétricos.

Animações e convenções de nós

O código prevê animação procedural na prévia e no trajeto lúdico; a configuração do trajeto precisa habilitar os componentes móveis. Isso é distinto de clipes e skins incorporados ao GLB, cuja reprodução automática não foi comprovada. O diagnóstico contabiliza animações, mas a contagem não demonstra execução.

• Humanoide: nós de nomes exatos arm_left, arm_right, leg_left e leg_right são necessários para reconhecer o rig. root, body e head são procurados, mas não obrigatórios nessa detecção. O movimento alterna membros sobre a pose inicial; confira pivôs e eixo local X.
• Cadeirante: além dos quatro membros, pelo menos um nó exato wheel_left, wheel_right, wheel_rear_left ou wheel_rear_right identifica esse tipo. Pernas não alternam como na caminhada; rodas e rodízios podem girar, com prefixos wheel_ e caster_.
• Rodas: prefixo wheel_; o giro acompanha a distância e o raio estimado. O eixo local mais fino é detectado, com X como preferência/fallback. Nós aninhados que correspondem ao prefixo não devem duplicar rotação.
• Hélices: prefixo rotor_, como rotor_main; o código estima o eixo mais fino e usa Y como fallback. Pivô e orientação do modelo são essenciais.
• Luzes: malhas com prefixo light_, como light_siren, podem receber efeito procedural; não implica suporte a qualquer emissor.

Ao preparar modelos no Blender ou similar, mantenha nomes exatos, pivôs coerentes e partes móveis separadas; teste o modelo exportado. O comentário de código recomenda membros irmãos sob root, mas a detecção examinada não exige formalmente essa hierarquia. Prévia e trajeto precisam ser ensaiados separadamente, inclusive para skins e clipes incorporados.

Persistência e próximos ensaios

Cadastro, upload, substituição, publicação, alteração de estilo, posicionamento e remoção podem gravar no catálogo, nos arquivos ou no mapa. A confirmação de cada ação, falhas parciais, concorrência e o efeito das versões devem ser ensaiados com dados e armazenamento isolados. Uma URL de modelo enviada pode ser pública.

Capturas adicionais pendentes: filtros, distinção completa de recursos locais/globais, desempenho detalhado, prévia, transformação, materiais e animação. Continue na jornada de Objetos 3D, em Objetos 3D, Produção de GLBs e Ícones.