Pages de propriétés du compilateur HLSL

Article
10/12/2023

Vous pouvez utiliser les pages de propriétés du compilateur HLSL (fxc.exe) pour configurer la façon dont les fichiers du nuanceur HLSL sont générés. Vous pouvez également spécifier des arguments de ligne de commande au compilateur HLSL à l’aide de la propriété Options supplémentaires de la page de propriétés de ligne de commande . Cela inclut des arguments qui ne peuvent pas être configurés à l’aide d’autres propriétés des pages de propriétés HLSL. Pour plus d’informations sur le compilateur HLSL, consultez Outil Compilateur d’effets

HLSL General Property Page

Autres répertoires Include

Spécifie un ou plusieurs répertoires à ajouter au chemin include. Si vous ajoutez plusieurs répertoires, séparez-les par des points-virgules. (/I[path])

Nom du point d’entrée

Spécifie le nom du point d’entrée du nuanceur (/E[nom])

Désactiver les optimisations

Oui (/Od) pour désactiver les optimisations ; sinon, Non. Par défaut, la valeur est Oui (/Od) pour les configurations Debug et Non pour les configurations Release.

L’argument de ligne de commande /Od du compilateur HLSL applique implicitement l’argument de ligne de commande /Gfp, mais la sortie peut ne pas être identique à la sortie qui est produite en passant explicitement les deux arguments de ligne de commande /Od et /Gfp.

Activer les informations de débogage

Oui (/Zi) pour activer les informations de débogage ; sinon, Non. Par défaut, la valeur est Oui (/Zi) pour les configurations Debug et Non pour les configurations Release.

Type de nuanceur

Spécifie le type de nuanceur. Les différents types de nuanceurs implémentent des parties différentes du pipeline graphique. Certains types de nuanceurs sont disponibles seulement dans les modèles de nuanceur les plus récents (qui sont spécifiés par la propriété Modèle de nuanceur) : par exemple, les nuanceurs de calcul ont été introduits dans le modèle de nuanceur 5.

Cette propriété correspond à la partie [type] de l’argument de ligne de commande /T [type]_[modèle] du compilateur HLSL. La propriété Modèles de nuanceur spécifie la partie [modèle] de l’argument.

Choices

Effet
Nuanceur de sommets
Nuanceur de pixels
Nuanceur de géométrie
Nuanceur de coque
Nuanceur de domaine
Nuanceur de calcul
Bibliothèque
Générer un objet de signature racine

Modèle de nuanceur

Spécifie le modèle de nuanceur. Les différents modèles de nuanceur ont des fonctionnalités différentes. En général, les modèles de nuanceur plus récents offrent des fonctionnalités étendues, mais ils nécessitent du matériel graphique plus moderne pour exécuter le code du nuanceur. Certains types de nuanceurs (qui sont spécifiés par la propriété Type de nuanceur) sont disponibles seulement dans les modèles de nuanceur les plus récents : par exemple, les nuanceurs de calcul ont été introduits dans le modèle de nuanceur 5.

Cette propriété correspond à la partie [modèle] de l’argument de ligne de commande /T [type]_[modèle] du compilateur HLSL. La propriété Type de nuanceur spécifie la partie [type] de l’argument.

Toutes les ressources liées

Le compilateur part du principe que toutes les ressources qu’un nuanceur peut référencer sont liées et sont en bon état pendant la durée d’exécution du nuanceur (/all_resources_bound). Disponible pour Shader Model 5.1 et les versions ultérieures.

Activer les tables de descripteur non liées

Informez le compilateur qu’un nuanceur peut contenir une déclaration d’un tableau de ressources avec une plage non liée (/enable_unbounded_descriptor_tables). Disponible pour Shader Model 5.1 et les versions ultérieures.

Définir la signature racine

Attacher la signature racine au bytecode du nuanceur (/setrootsignature). Disponible pour Shader Model 5.0 et les versions ultérieures.

Définitions de préprocesseur

Ajoute une ou plusieurs définitions de symbole de préprocesseur à appliquer au fichier de code source HLSL. Utilisez des points-virgules pour séparer les définitions de symbole.

Cette propriété correspond à la partie /D [définitions] de l’argument de ligne de commande du compilateur HLSL.

Compiler un effet de nuanceur de pixels personnalisé Direct2D

Compilez un effet personnalisé Direct2D qui contient des nuanceurs de pixels. N’utilisez pour un vertex ni ne calculez un effet personnalisé.

Compilation multiprocesseur

Exécutez plusieurs instances en même temps.

Page de propriétés avancées

Supprime l’affichage de la bannière de démarrage et des messages d’information. (/nologo)

Considérer les avertissements comme des erreurs

Considère tous les avertissements du compilateur comme des erreurs. Pour un nouveau projet, il est conseillé d’utiliser /WX dans toutes les compilations, car la résolution de tous les avertissements permet de réduire les erreurs de code difficilement détectables.

Page de propriétés Fichiers de sortie

Nom de la variable dans l’en-tête

Spécifie un nom pour le nom de la variable dans le fichier d’en-tête (/Vn [nom])

Nom du fichier d’en-tête

Spécifie un nom pour le fichier d’en-tête contenant le code objet. (/Fh [name])

Nom de fichier objet

Spécifie un nom pour le fichier objet. (/Fo [nom])

Sortie de l’assembleur

Spécifie le contenu du fichier de sortie linguistique de l’assembly. (/Fc, /Fx)