Pagine delle proprietà del compilatore HLSL

Articolo
10/12/2023

È possibile usare le pagine delle proprietà del compilatore HLSL (fxc.exe) per configurare la compilazione dei singoli file shader HLSL. È anche possibile specificare argomenti della riga di comando per il compilatore HLSL usando la proprietà Opzioni aggiuntive della pagina delle proprietà Della riga di comando. Sono inclusi gli argomenti che non possono essere configurati utilizzando altre proprietà delle pagine delle proprietà HLSL. Per informazioni sul compilatore HLSL, vedere Effect-Compiler Tool (Compilatore degli effetti)

Pagina delle proprietà Generale HLSL

Directory di inclusione aggiuntive

Specifica una o più directory da aggiungere al percorso di inclusione. Usare il punto e virgola (;) come delimitatore per più percorsi. (/I[path])

Nome del punto di ingresso

Specifica il nome del punto di ingresso per lo shader (/E[name])

Disabilita ottimizzazioni

Sì (/Od) per abilitare le ottimizzazioni; in caso contrario, No. Per impostazione predefinita, il valore è Sì (/Od) per le configurazioni di tipo Debug e No per le configurazioni di tipo Rilascio.

L'argomento della riga di comando /Od per il compilatore HLSL applica in modo implicito l'argomento della riga di comando /Gfp. Tuttavia l'output potrebbe non essere identico all'output generato passando entrambi gli argomenti /Od e /Gfp in modo esplicito.

Abilita informazioni di debug

Sì (/Zi) per abilitare le informazioni di debug; in caso contrario, No. Per impostazione predefinita, il valore è Sì (/Zi) per le configurazioni di tipo Debug e No per le configurazioni di tipo Rilascio.

Tipo shader

Specifica il tipo di shader. Tipi diversi di shader implementano parti diverse della pipeline grafica. Alcuni tipi di shader (specificati dalla proprietà Modello di shader) sono disponibili solo in modelli di shader più recenti, come ad esempio i compute shader, che sono stati introdotti nel modello di shader 5.

Questa proprietà corrisponde alla parte [type] dell'argomento della riga di comando /T [type]_[model] per il compilatore HLSL. La proprietà Modello di shader specifica la parte dell'argomento [model].

Choices

Effetto
Vertex shader
Pixel shader
Geometry shader
Hull Shader
Domain Shader
Compute Shader
Library
Generare l'oggetto Firma radice

Modello di shader

Specifica il modello di shader. I diversi modelli di shader hanno funzionalità diverse. In generale, i modelli di shader più recenti offrono funzionalità avanzate, ma richiedono componenti hardware grafici più moderni per eseguire il codice dello shader. Alcuni tipi di shader (specificati dalla proprietà Tipo di shader) sono disponibili solo in modelli di shader più recenti come ad esempio i compute shader, che sono stati introdotti nel modello di shader 5.

Questa proprietà corrisponde alla parte [model] dell'argomento della riga di comando /T [type]_[model] per il compilatore HLSL. La proprietà Tipo di shader specifica la parte dell'argomento [type].

Tutte le risorse associate

Il compilatore presuppone che tutte le risorse a cui può fare riferimento uno shader siano associate e siano in uno stato valido per la durata dell'esecuzione dello shader (/all_resources_bound). Disponibile per Modello shader 5.1 e versioni successive.

Abilitare tabelle del descrittore non associato

Informare il compilatore che uno shader può contenere una dichiarazione di una matrice di risorse con intervallo non associato (/enable_unbounded_descriptor_tables). Disponibile per Modello shader 5.1 e versioni successive.

Imposta firma radice

Collegare la firma radice al bytecode shader (/setrootsignature). Disponibile per Modello shader 5.0 e versioni successive.

Definizioni del preprocessore

Aggiunge una o più definizioni di simboli del preprocessore da applicare al file di codice sorgente HLSL. Usare il punto e virgola per separare le definizioni di simboli.

Questa proprietà corrisponde all'argomento della riga di comando /D [definitions] per il compilatore HLSL.

Compilare un effetto pixel shader personalizzato Direct2D

Compila un effetto personalizzato Direct2D che contiene pixel shader. Non usare per un effetto personalizzato di vertex o compute shader.

Compilazione di più processori

Eseguire più istanze contemporaneamente.

Pagina avanzate delle proprietà

Evita la visualizzazione del messaggio di avvio e dei messaggi informativi. (/nologo)

Considera gli avvisi come errori

Considera tutti gli avvisi del compilatore come errori. Per un nuovo progetto, potrebbe essere preferibile usare /WX in tutte le compilazioni. La risoluzione degli avvisi garantirà il minor numero possibile di errori del codice di difficile individuazione.

Pagina delle proprietà File di output

Nome variabile intestazione

Specifica un nome per il nome della variabile nel file di intestazione (/Vn [nome])

Nome file intestazione

Specifica un nome per il file di intestazione contenente il codice oggetto. (/Fh [name])

Nome file oggetto

Specifica un nome per il file oggetto. (/Fo [nome])

Output assembler

Specifica il contenuto del file di output in linguaggio assembly. (/Fc, /Fx)