Debugger HLSL

Il debugger HLSL, uno degli strumenti di diagnostica di grafica presenti in Visual Studio, consente di comprendere il modo in cui il codice dello shader HLSL opera con i dati di grafica registrati durante una sessione di acquisizione della diagnostica di grafica.

Questo è il debugger HLSL:

Informazioni sul debugger HLSL

Il debugger HLSL consente di individuare i problemi che sorgono nel codice dello shader. L'esecuzione del debug del codice HLSL in Visual Studio è analogo al debug del codice scritto in altri linguaggi (ad esempio, C++, C# o Visual Basic). È possibile controllare il contenuto delle variabili, impostare punti di interruzione, eseguire il codice istruzione per istruzione e risalire nello stack di chiamate, proprio come quando si esegue il debug di altri linguaggi.

Tuttavia, poiché le GPU raggiungono prestazioni elevate eseguendo il codice dello shader in centinaia di thread contemporaneamente, il debugger HLSL è progettato per interagire con gli altri strumenti di diagnostica di grafica per presentare tutte queste informazioni con un certo criterio. La diagnostica di grafica ricrea i frame acquisiti tramite le informazioni registrate in un log di grafica; il debugger HLSL non monitora l'esecuzione delle GPU in tempo reale mentre esegue il codice dello shader. Poiché un log della grafica contiene informazioni sufficienti per ricreare una parte dell'output e poiché la diagnostica di grafica fornisce strumenti che consentono di individuare il pixel e l'evento esatto in cui si è verificato un errore, il debugger HLSL deve solo simulare il thread dello shader interessato. Ciò significa che il lavoro dello shader può essere simulato nella CPU, dove i meccanismi interni sono in visualizzazione completa. Questa operazione consente al debugger HLSL di operare in modo simile alla CPU.

Tuttavia, il debugger HLSL attualmente è limitato nei modi seguenti:

• Non è possibile eseguire il debug di un'app e del codice dello shader contemporaneamente. Tuttavia, è possibile alternarli.

• È possibile aggiungere variabili e registri alla finestra Espressioni di controllo, ma le espressioni non sono supportate.

Tuttavia, il debugger HLSL fornisce un'esperienza di debug più simile a quella di tipo CPU rispetto a quanto sarebbe altrimenti possibile.

Funzionalità Modifica e applicazione dello shader HLSL

Il debugger dello shader HLSL non supporta la funzionalità Modifica e continuazione nello stesso modo del debugger CPU perché il modello di esecuzione delle GPU non consente l'annullamento dello stato dello shader. Il debugger HLSL supporta invece la funzionalità Modifica e applicazione, che consente di modificare i file di origine HLSL e quindi di scegliere Applica per rigenerare il frame e vedere l'effetto delle modifiche. Il codice modificato dello shader viene archiviato in un file separato per mantenere l'integrità del file di origine HLSL del progetto, ma una volta definite le modifiche è possibile scegliere Copia in ... per copiare le modifiche nel progetto. Con questa funzionalità è possibile scorrere rapidamente il codice dello shader contenente gli errori ed eliminare i passaggi di ricompilazione e acquisizione che comportano un grande consumo di risorse dal flusso di lavoro del debug HLSL.

Importante

Lo shader modificato non è valido per Analisi dei frame.

Disassembly HLSL

Il debugger dello shader HLSL fornisce un elenco di assembly dello shader HLSL a destra dell'elenco del codice sorgente HLSL.

Debug del codice HLSL

È possibile accedere al debugger HLSL dalla finestra Fasi pipeline grafica o da Cronologia pixel grafica.

Per avviare il debugger HLSL dalla finestra Fasi pipeline grafica

1. Nella finestra Fasi pipeline grafica individuare la fase della pipeline associata allo shader di cui eseguire il debug.

2. Sotto il titolo della fase della pipeline scegliere Avvia debug, visualizzato con una piccola freccia verde.

   Nota

   Questo punto di ingresso nel debugger HLSL esegue il debug solo del primo thread dello shader per la fase corrispondente, ovvero il primo vertice o pixel elaborato.È possibile usare Cronologia pixel grafica per accedere ad altri thread di queste fasi dello shader.

Per avviare il debugger HLSL dalla finestra Cronologia pixel grafica

1. In Cronologia pixel grafica espandere la chiamata di disegno associata allo shader di cui eseguire il debug. Ogni chiamata di disegno può corrispondere a più primitive.

2. Nei dettagli della chiamata di disegno espandere una primitiva il cui contributo di colore risultante indichi un bug nel codice dello shader. Se più primitive indicano un bug, scegliere la prima, onde evitare un accumulo di errori che potrebbe complicare la diagnosi del problema.

3. Nei dettagli della primitiva scegliere se eseguire il debug di Vertex shader o Pixel shader. Eseguire il debug del vertex shader se si sospetta che il pixel shader sia corretto, ma generi un contributo di colore errato poiché il vertex shader passa costanti errate. In caso contrario, eseguire il debug del pixel shader.

   A destra dello shader desiderato scegliere Avvia debug, visualizzato con una piccola freccia verde.

   Nota

   Questo punto di ingresso nel debugger HLSL esegue il debug del thread del pixel shader che corrisponde alla chiamata di disegno, alla primitiva e al pixel desiderati oppure dei thread del vertex shader i cui risultati sono interpolati dalla chiamata di disegno, dalla primitiva e dal pixel desiderato.Nel caso dei vertex shader, è possibile migliorare ulteriormente il punto di ingresso in un vertice specifico espandendo i dettagli del vertex shader.

Per alcuni esempi su come usare il debugger HLSL per eseguire il debug degli errori dello shader, vedere Esempi di diagnostica grafica o le procedure dettagliate riportate con un collegamento nella sezione Vedere anche.

Vedere anche

Attività

Procedura dettagliata: oggetti mancanti a causa dello sfondo Vertex

Procedure dettagliate: debug degli errori di rendering dovuti allo sfondo

Procedura dettagliata: utilizzo della diagnostica grafica per eseguire il debug di un compute shader