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:
- Deduplicação — Remove accessors, materiais, malhas e texturas duplicados para reduzir a redundância.
- Poda — Remove nós, materiais e outros recursos não utilizados que não contribuem para o modelo visível.
- Soldagem — Mescla vértices que compartilham a mesma posição e os mesmos atributos, reduzindo a contagem de vértices.
- 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.
- 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.
- Compressão de texturas — Converte as texturas para o formato WebP para obter arquivos menores mantendo a qualidade visual.
- 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.