WebGL2 non disponibile? Risolvi l'anteprima 3D per piattaforma

Il sintomo che vedi

L'area di anteprima mostra "Anteprima 3D non disponibile" oppure la pagina è vuota, nessun modello visualizzato. L'anteprima online di Any3D si basa su WebGL2 per renderizzare la scena 3D tramite GPU; se WebGL2 non è disponibile, l'anteprima non parte.

Cause comuni

Causa	Scenario tipico
Accelerazione hardware disattivata	Browser o sistema operativo disabilitano la GPU
Driver GPU obsoleto o corrotto	Notebook con doppia GPU, driver open source su Linux
Blacklist del browser	GPU molto vecchie inserite nella lista di rendering software
Desktop remoto / VM	RDP, VM senza pass-through GPU
Policy aziendali	GPO disabilita l'accelerazione GPU, VDI senza 3D
WebView / vecchio motore	App con WebView obsoleta, vecchie app
Interferenza estensioni	Plugin anti-impronta Canvas forzati

Diagnostica per piattaforma

Windows

1. Attiva l'accelerazione hardware
   Chrome/Edge: Impostazioni → Sistema → "Usa accelerazione hardware (se disponibile)" → riavvia il browser.

2. Aggiorna i driver della GPU
   Installa gli ultimi driver dal sito NVIDIA / AMD / Intel o tramite Windows Update. Sui notebook, imposta il browser come "Alte prestazioni" nel pannello di controllo della scheda grafica.

3. Criteri di gruppo / Registro (aziendale)
   L'IT potrebbe disabilitare la composizione GPU tramite policy. Gli utenti privati possono verificare su chrome://gpu se compare "Solo software".

4. Desktop remoto
   Quando ti connetti via RDP a un PC dell'ufficio, WebGL spesso non funziona – apri Any3D nel browser del PC locale oppure usa una soluzione remota con supporto GPU.

5. Controllo parentale
   I sottoprofilo di Sicurezza famiglia di Windows normalmente non bloccano WebGL; se usi un "browser per bambini" di terze parti, prova con Chrome/Edge.

macOS

1. Safari / Chrome aggiornati; Impostazioni di sistema → Monitor → frequenza di aggiornamento/risoluzione normali, basta così.
2. Con la modalità Risparmio energetico la GPU viene limitata, in casi estremi influisce su WebGL – ricarica e riprova.
3. Tempo di utilizzo non blocca direttamente WebGL; se i profili MDM limitano la grafica, contatta l'IT.

Linux

1. Driver proprietari (NVIDIA) o Mesa recente; chrome://gpu per vedere lo stato GL.
2. Se Wayland o X11 falliscono, prova a cambiare sessione per confronto.

iOS / iPadOS

1. Safari ha un buon supporto WebGL2; mantieni il sistema aggiornato.
2. Modalità risparmio energetico può limitare le prestazioni, causando rallentamenti o errori nell'anteprima – ricarica e riprova.
3. WebView nelle app → apri in Safari.
4. Gli iPad gestiti da scuola che bloccano "Fotocamera/File" non influenzano WebGL, ma il blocco degli aggiornamenti di sistema lascia un kernel vecchio.

Android

1. Aggiorna Chrome; attiva Opzioni sviluppatore → Forza rendering GPU (funziona su alcuni dispositivi vecchi, sui nuovi sistemi è spesso già attivo).
2. I browser con motori di compatibilità (es. alcuni browser preinstallati su dispositivi cinesi o custom) spesso non hanno WebGL2 – usa Chrome.
3. Modalità risparmio energetico limita la GPU – disattivala e riprova.

Rete, VPN e rete aziendale

WebGL2 è un'API GPU locale, di solito non è influenzata direttamente dalla VPN. Tuttavia, tieni d'occhio i seguenti casi:

Scenario	Spiegazione
VDI aziendale (Citrix/VMware)	Se il pass-through GPU non è attivo, WebGL non è disponibile; serve vGPU o browser locale
VPN che installa estensioni del browser	L'estensione potrebbe interferire con il contesto WebGL
Rete interna che consente solo IE/vecchio Edge	Niente WebGL2, serve un browser Chromium moderno

Controllo parentale e ambienti pubblici

• PC di biblioteche/scuole: potrebbero usare browser bloccati o senza GPU dedicata – prova con un notebook personale.
• Family Link che limita la versione di Chrome: consenti l'aggiornamento di Chrome dal Play Store.

Risoluzione passo-passo (generale)

1. Apri chrome://gpu (Chrome/Edge) oppure about:support → Grafica, controlla se WebGL2 è Hardware accelerated.
2. Attiva l'accelerazione hardware, aggiorna i driver, riavvia browser e sistema.
3. Prova in finestra di navigazione in incognito per escludere le estensioni.
4. Cambia browser / cambia dispositivo per un confronto incrociato.

Test rapido

(() => {
  const c = document.createElement("canvas");
  return c.getContext("webgl2") !== null;
})();

Se restituisce false, significa che non è possibile creare un contesto WebGL2.

Puoi anche visitare WebGL Report (richiede accesso a internet) per vedere le capacità dettagliate.

Relazione con OffscreenCanvas

Il percorso worker per la compressione delle texture richiede anche OffscreenCanvas + WebGL2. Se vedi solo un avviso Worker giallo in basso ma l'anteprima funziona, consulta prima la guida OffscreenCanvas; se l'anteprima stessa fallisce, segui questo articolo.

Riepilogo

Il problema "WebGL2 non disponibile" è principalmente legato a GPU/driver/accelerazione hardware, ma anche VDI aziendale, desktop remoto e vecchie WebView sono cause comuni. Attiva l'accelerazione per piattaforma, aggiorna i driver, accedi dal browser locale: nella maggior parte dei casi l'anteprima 3D torna funzionante.