Pular para o conteúdo principal

Referência

Especificações dos modelos 3D

Especificações dos modelos 3D

Esta página oferece uma referência técnica detalhada do pipeline de geração e otimização de modelos 3D usado no 3D Menu Pro.

Formato de saída

Todos os modelos 3D são entregues como arquivos GLB (glTF Binary). O GLB é um padrão do setor para conteúdo 3D na web, suportado por todos os principais navegadores e frameworks, incluindo o Three.js e o componente web <model-viewer>.

Limite de tamanho

O tamanho máximo de um modelo final otimizado é 2 MB. Os modelos que ultrapassam esse limite após a primeira passagem de otimização são simplificados automaticamente. A simplificação automática é acionada quando o modelo tem mais de 2 MB e a contagem de polígonos é superior a 10,000. Se os dados de contagem de polígonos não estiverem disponíveis, o sistema aplica a simplificação por padrão, como medida de segurança.

Pipeline de otimização

Todo modelo 3D gerado passa por um pipeline de otimização em várias etapas para garantir carregamento rápido em dispositivos móveis:

  1. Deduplicação — Remove accessors, materiais, malhas e texturas duplicados para reduzir a redundância.
  2. Poda — Remove nós, materiais e outros recursos não utilizados que não contribuem para o modelo visível.
  3. Soldagem — Mescla vértices que compartilham a mesma posição e os mesmos atributos, reduzindo a contagem de vértices.
  4. Simplificação — Reduz a contagem de polígonos preservando a fidelidade visual. Usa a biblioteca meshoptimizer para uma decimação de malha que leva a qualidade em conta.
  5. Quantização — Reduz a precisão dos atributos dos vértices (posições, normais, UVs) para usar menos memória com impacto visual mínimo.
  6. Compressão de texturas — Converte as texturas para o formato WebP para obter arquivos menores mantendo a qualidade visual.
  7. Compressão Draco — Aplica a compressão de malha Draco para a redução final do tamanho do arquivo. O Draco é decodificado pelo navegador no momento do carregamento.

Estados do modelo

Estado Descrição Duração
PENDING O item está na fila de processamento, aguardando um worker disponível. Varia conforme o tamanho da fila
GENERATING O provedor de IA está gerando um modelo 3D a partir da foto de entrada. De 30 segundos a 2 minutos
PROCESSING O modelo gerado está sendo otimizado pelo pipeline descrito acima. De 10 a 30 segundos
READY O modelo está otimizado e no ar no cardápio público. Estado final
FAILED O processamento encontrou um erro. É possível tentar novamente pelo painel. Estado final (até uma nova tentativa)

Tempos limite de busca

O sistema aplica tempos limite durante a entrega dos modelos para evitar experiências de carregamento lento:

  • Busca da imagem de pôster: tempo limite de 30 segundos
  • Download do modelo: tempo limite de 120 segundos

Se o download de um modelo exceder o tempo limite, o visualizador volta a exibir a imagem de pôster (a foto aprimorada), para que o cliente sempre veja algo.

Compatibilidade com WebGL

Os modelos 3D são renderizados com WebGL no navegador. Se o WebGL não estiver disponível ou o contexto for perdido (o que pode acontecer em dispositivos móveis com pouca memória), o visualizador recorre automaticamente ao componente web <model-viewer>, que oferece ampla compatibilidade. Se nem o WebGL nem o model-viewer forem suportados, a foto 2D aprimorada é exibida no lugar.