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:
- Deduplicazione — Rimuove accessor, materiali, mesh e texture duplicati per ridurre la ridondanza.
- Pruning — Rimuove nodi, materiali e altre risorse inutilizzati che non contribuiscono al modello visibile.
- Welding — Unisce i vertici che condividono la stessa posizione e gli stessi attributi, riducendo il numero di vertici.
- Semplificazione — Riduce il numero di poligoni preservando la fedeltà visiva. Utilizza la libreria meshoptimizer per una decimazione della mesh attenta alla qualità.
- Quantizzazione — Riduce la precisione degli attributi dei vertici (posizioni, normali, UV) per usare meno memoria con un impatto visivo minimo.
- Compressione delle texture — Converte le texture in formato WebP per ottenere file più piccoli mantenendo la qualità visiva.
- 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.