Vai al contenuto principale

Riferimento

Specifiche dei modelli 3D

Specifiche dei modelli 3D

Questa pagina fornisce un riferimento tecnico dettagliato per la pipeline di generazione e ottimizzazione dei modelli 3D utilizzata in 3D Menu Pro.

Formato di output

Tutti i modelli 3D vengono forniti come file GLB (glTF Binary). GLB è uno standard del settore per i contenuti 3D sul web, supportato da tutti i principali browser e framework, tra cui Three.js e il componente web <model-viewer>.

Limite di dimensione

La dimensione massima di un modello ottimizzato finale è 2 MB. I modelli che superano questo limite dopo il primo passaggio di ottimizzazione vengono semplificati automaticamente. La semplificazione automatica si attiva quando il modello supera 2 MB e il numero di poligoni è superiore a 10,000. Se il dato sul numero di poligoni non è disponibile, il sistema applica per impostazione predefinita la semplificazione come misura di sicurezza.

Pipeline di ottimizzazione

Ogni modello 3D generato passa attraverso una pipeline di ottimizzazione in più fasi per garantire un caricamento rapido sui dispositivi mobili:

  1. Deduplicazione — Rimuove accessor, materiali, mesh e texture duplicati per ridurre la ridondanza.
  2. Pruning — Rimuove nodi, materiali e altre risorse inutilizzati che non contribuiscono al modello visibile.
  3. Welding — Unisce i vertici che condividono la stessa posizione e gli stessi attributi, riducendo il numero di vertici.
  4. Semplificazione — Riduce il numero di poligoni preservando la fedeltà visiva. Utilizza la libreria meshoptimizer per una decimazione della mesh attenta alla qualità.
  5. Quantizzazione — Riduce la precisione degli attributi dei vertici (posizioni, normali, UV) per usare meno memoria con un impatto visivo minimo.
  6. Compressione delle texture — Converte le texture in formato WebP per ottenere file più piccoli mantenendo la qualità visiva.
  7. Compressione Draco — Applica la compressione mesh Draco per la riduzione finale della dimensione del file. Draco viene decodificato dal browser al momento del caricamento.

Stati del modello

Stato Descrizione Durata
PENDING L'articolo è in coda di elaborazione, in attesa di un worker disponibile. Variabile in base alla lunghezza della coda
GENERATING Il provider IA sta generando un modello 3D a partire dalla foto di input. Da 30 secondi a 2 minuti
PROCESSING Il modello generato viene ottimizzato tramite la pipeline descritta sopra. Da 10 a 30 secondi
READY Il modello è ottimizzato e online nel menu pubblico. Stato finale
FAILED L'elaborazione ha riscontrato un errore. È possibile riprovare dalla dashboard. Stato finale (fino a un nuovo tentativo)

Timeout di recupero

Il sistema applica dei timeout durante la distribuzione dei modelli per evitare esperienze di caricamento lente:

  • Recupero dell'immagine poster: timeout di 30 secondi
  • Download del modello: timeout di 120 secondi

Se il download di un modello va in timeout, il visualizzatore ripiega sull'immagine poster (la foto migliorata), così il cliente vede sempre qualcosa.

Compatibilità WebGL

I modelli 3D vengono renderizzati nel browser tramite WebGL. Se WebGL non è disponibile o il contesto viene perso (cosa che può accadere sui dispositivi mobili con poca memoria), il visualizzatore ripiega automaticamente sul componente web <model-viewer>, che offre un'ampia compatibilità. Se non sono supportati né WebGL né model-viewer, viene mostrata la foto 2D migliorata.