WebGL2 non disponibile? Risoluzione anteprima 3D

Sintomi riscontrati

L'area di anteprima mostra "Anteprima 3D non disponibile" o è vuota, senza alcun modello visualizzato. L'anteprima online di Any3D si basa su WebGL2 per rendering della scena 3D sulla GPU; quando WebGL2 non è disponibile, l'anteprima non può avviarsi.

Cause comuni

Causa	Scenario tipico
Accelerazione hardware disabilitata	Browser o impostazioni di sistema che disabilitano la GPU
Driver GPU obsoleti/anomali	Laptop Windows con doppia GPU, driver open source su Linux
Blacklist del browser	GPU molto vecchie inserite nella lista di rendering software del browser
Desktop remoto / Macchina virtuale	RDP, VM senza pass-through della GPU
Strategia aziendale	GPO che disabilita l'accelerazione hardware, VDI senza accelerazione 3D
WebView / Nucleo vecchio	WeChat, DingTalk, app vecchie
Interferenza delle estensioni	Plugin di tipo "protezione impronta Canvas" forzati

Risoluzione dei problemi per piattaforma

Windows

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

2. Aggiorna i driver GPU
   Installa i driver più recenti dal sito ufficiale di NVIDIA / AMD / Intel o tramite Windows Update. Sui laptop, imposta il browser su "Prestazioni elevate" nel pannello di controllo della GPU.

3. Group Policy / Registro di sistema (Azienda)
   L'IT potrebbe disabilitare il compositing della GPU tramite strategia. Gli utenti individuali possono controllare chrome://gpu per verificare la presenza di molti "Software only".

4. Desktop remoto
   Quando si esegue RDP verso una workstation aziendale, WebGL spesso non è disponibile — apri Any3D nel browser del PC locale o usa una soluzione remota con supporto GPU.

5. Controllo parentale
   I sottocount di Windows Family Security generalmente non disabilitano WebGL; se si usa un "browser per bambini" di terze parti, prova con Chrome/Edge.

macOS

1. Safari / Chrome versione più recente; Impostazioni di sistema → Display → Frequenza di aggiornamento / Risoluzione normali.
2. In Modalità a basso consumo la GPU riduce la frequenza, influenzando WebGL in casi estremi — collega alla presa di corrente e riprova.
3. Tempo schermo non disabilita direttamente WebGL; se un MDM limita la grafica, contatta l'IT.

Linux

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

iOS / iPadOS

1. Safari ha un buon supporto a WebGL2; mantieni il sistema aggiornato.
2. La Modalità a basso consumo potrebbe limitare le prestazioni, causando rallentamenti o fallimenti dell'anteprima — ricarica e riprova.
3. WebView all'interno di un'app → Apri in Safari.
4. iPad gestiti da scuole che vietano "Camera/File" non influenzano WebGL, ma il divieto di aggiornamenti di sistema può rendere il nucleo obsoleto.

Android

1. Aggiorna Chrome; attiva Opzioni sviluppatore → Rendering forzato GPU (efficace su alcuni vecchi dispositivi, potrebbe essere già predefinito su sistemi recenti).
2. I browser nazionali con core di compatibilità spesso non supportano WebGL2 → usa Chrome.
3. Modalità di risparmio energetico limita la GPU — disabilita e riprova.

Rete, VPN e rete aziendale

WebGL2 è un'API locale della GPU, generalmente non influenzata direttamente dalla VPN. Ma attenzione ai seguenti scenari:

Scenario	Spiegazione
VDI aziendale (Citrix/VMware)	WebGL non disponibile se il pass-through della GPU non è abilitato; l'IT deve attivare vGPU o usare un browser locale
VPN che forza l'installazione di estensioni del browser	Le estensioni potrebbero interferire con il contesto WebGL
Rete interna che permette solo IE/Vecchio Edge	Nessun supporto a WebGL2, bisogna usare un browser Chromium moderno

Controlli parentali e ambienti pubblici

• PC di biblioteca/scuola: potrebbero usare browser bloccati o senza GPU dedicata — verifica con un laptop personale.
• Family Link che limita la versione di Chrome: permetti l'aggiornamento di Chrome tramite Play Store.

Correzione passo-passo (Generica)

1. Apri chrome://gpu (Chrome/Edge) o about:support → Grafica, e verifica se WebGL2 è Accelerato dall'hardware.
2. Abilita l'accelerazione hardware, aggiorna i driver, riavvia browser e sistema.
3. Usa una finestra di navigazione in incognito per escludere le estensioni.
4. Prova con un altro browser / un altro dispositivo per verifica incrociata.

Auto-test rapido

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

Restituisce false se non è possibile creare un contesto WebGL2.

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

Relazione con OffscreenCanvas

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

Sintesi

La indisponibilità di WebGL2 è fondamentalmente un problema di GPU/driver/accelerazione hardware. Anche la VDI aziendale, i desktop remoti e le vecchie WebView sono cause comuni. Abilitando l'accelerazione per piattaforma, aggiornando i driver e accedendo con un browser locale, nella maggior parte dei casi l'anteprima 3D può essere ripristinata.