Énumération D3DTEXTURESTAGESTATETYPE

Les états d’étape de texture définissent les opérations de texture multi-mélangeurs. Certains états de l'échantillonneur configurent le traitement des sommets et d'autres le traitement des pixels. Les états de l'étape de texture peuvent être enregistrés et restaurés à l'aide de blocs d'état (voir Blocs d'état Enregistrer et restaurer l'état (Direct3D 9)).

Syntaxe

typedef enum D3DTEXTURESTAGESTATETYPE { 
  D3DTSS_COLOROP                = 1,
  D3DTSS_COLORARG1              = 2,
  D3DTSS_COLORARG2              = 3,
  D3DTSS_ALPHAOP                = 4,
  D3DTSS_ALPHAARG1              = 5,
  D3DTSS_ALPHAARG2              = 6,
  D3DTSS_BUMPENVMAT00           = 7,
  D3DTSS_BUMPENVMAT01           = 8,
  D3DTSS_BUMPENVMAT10           = 9,
  D3DTSS_BUMPENVMAT11           = 10,
  D3DTSS_TEXCOORDINDEX          = 11,
  D3DTSS_BUMPENVLSCALE          = 22,
  D3DTSS_BUMPENVLOFFSET         = 23,
  D3DTSS_TEXTURETRANSFORMFLAGS  = 24,
  D3DTSS_COLORARG0              = 26,
  D3DTSS_ALPHAARG0              = 27,
  D3DTSS_RESULTARG              = 28,
  D3DTSS_CONSTANT               = 32,
  D3DTSS_FORCE_DWORD            = 0x7fffffff
} D3DTEXTURESTAGESTATETYPE, *LPD3DTEXTURESTAGESTATETYPE;

Constantes

D3DTSS_COLOROP

L’état de l’étape de texture est une opération de mélange de couleurs de texture identifiée par un membre du type énuméré D3DTEXTUREOP. La valeur par défaut pour la première étape de texture (étape 0) est D3DTOP_MODULATE ; pour toutes les autres étapes, la valeur par défaut est D3DTOP_DISABLE.

D3DTSS_COLORARG1

L'état de l'étape de texture est le premier argument de couleur de l'étape, identifié par l'un des D3DTA. L'argument par défaut est D3DTA_TEXTURE.

Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. La valeur par défaut du registre est (0.0, 0.0, 0.0, 0.0).

D3DTSS_COLORARG2

L'état de l'étape de texture est le deuxième argument de couleur pour l'étape, identifié par D3DTA. L'argument par défaut est D3DTA_CURRENT. Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. La valeur par défaut du registre est (0.0, 0.0, 0.0, 0.0)

D3DTSS_ALPHAOP

L’état de l’étape de texture est une opération de mélange alpha de texture identifiée par un membre du type énuméré D3DTEXTUREOP. La valeur par défaut pour la première étape de texture (étape 0) est D3DTOP_SELECTARG1, et pour toutes les autres étapes, la valeur par défaut est D3DTOP_DISABLE.

D3DTSS_ALPHAARG1

L'état de l'étape de texture est le premier argument alpha de l'étape, identifié par D3DTA. L'argument par défaut est D3DTA_TEXTURE. Si aucune texture n'est définie pour cette étape, l'argument par défaut est D3DTA_DIFFUSE. Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. La valeur par défaut du registre est (0.0, 0.0, 0.0, 0.0).

D3DTSS_ALPHAARG2

L'état de l'étape de texture est le deuxième argument alpha de l'étape, identifié par D3DTA. L'argument par défaut est D3DTA_CURRENT. Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. La valeur par défaut du registre est (0.0, 0.0, 0.0, 0.0).

D3DTSS_BUMPENVMAT00

L'état de l'étape de texture est une valeur à virgule flottante pour le coefficient [0][0] dans une matrice de mappage de relief. La valeur par défaut est 0,0.

D3DTSS_BUMPENVMAT01

L'état de l'étape de texture est une valeur à virgule flottante pour le coefficient [0] [1] dans une matrice de mappage de relief. La valeur par défaut est 0,0.

D3DTSS_BUMPENVMAT10

L'état de l'étape de texture est une valeur à virgule flottante pour le coefficient [1] [0] dans une matrice de mappage de relief. La valeur par défaut est 0,0.

D3DTSS_BUMPENVMAT11

L'état de l'étape de texture est une valeur à virgule flottante pour le coefficient [1] [1] dans une matrice de mappage de relief. La valeur par défaut est 0,0.

D3DTSS_TEXCOORDINDEX

Index des coordonnées de texture définies à utiliser avec cette étape de texture. Vous pouvez spécifier jusqu'à huit ensembles de coordonnées de texture par sommet. Si un sommet n'inclut pas un ensemble de coordonnées de texture à l'index spécifié, le système utilise par défaut les coordonnées u et v (0,0).

Lors du rendu à l'aide de vertex shaders, l'index de coordonnées de texture de chaque étape doit être défini sur sa valeur par défaut. L'index par défaut de chaque étape est égal à l'index de l'étape. Définissez cet état sur l'index de base zéro de l'ensemble de coordonnées pour chaque sommet utilisé par cette étape de texture.

De plus, les applications peuvent inclure, en tant que OU logique avec l'index défini, l'une des constantes pour demander à Direct3D de générer automatiquement les coordonnées de texture d'entrée pour une transformation de texture. Pour une liste de toutes les constantes, voir D3DTSS_TCI.

À l'exception de D3DTSS_TCI_PASSTHRU, qui est résolu à zéro, si l'une des valeurs suivantes est incluse dans l'index défini, le système utilise l'index strictement pour déterminer le mode d'habillage de texture. Ces indicateurs sont particulièrement utiles lors de l'exécution du mappage d'environnement.

D3DTSS_BUMPENVLSCALE

Valeur d'échelle à virgule flottante pour la luminance de la carte de relief. La valeur par défaut est 0,0.

D3DTSS_BUMPENVLOFFSET

Valeur de décalage en virgule flottante pour la luminance de la carte de relief. La valeur par défaut est 0,0.

D3DTSS_TEXTURETRANSFORMFLAGS

Membre du type énuméré D3DTEXTURETRANSFORMFLAGS qui contrôle la transformation des coordonnées de texture pour cette étape de texture. La valeur par défaut est D3DTTFF_DISABLE.

D3DTSS_COLORARG0

Paramètres de la troisième opérande de couleur pour les opérations triadiques (multiplier, ajouter et interpoler linéairement), identifiés par D3DTA. Ce paramètre est pris en charge si les fonctionnalités de périphérique D3DTEXOPCAPS_MULTIPLYADD ou D3DTEXOPCAPS_LERP sont présentes. L'argument par défaut est D3DTA_CURRENT. Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. La valeur par défaut du registre est (0.0, 0.0, 0.0, 0.0).

D3DTSS_ALPHAARG0

Paramètres de l'opérande de sélection de canal alpha pour les opérations triadiques (multiplier, ajouter et interpoler linéairement), identifiés par D3DTA. Ce paramètre est pris en charge si les fonctionnalités de périphérique D3DTEXOPCAPS_MULTIPLYADD ou D3DTEXOPCAPS_LERP sont présentes. L'argument par défaut est D3DTA_CURRENT. Spécifiez D3DTA_TEMP pour sélectionner une couleur de registre temporaire pour la lecture ou l'écriture. D3DTA_TEMP est pris en charge si la capacité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente. L'argument par défaut est (0.0, 0.0, 0.0, 0.0).

D3DTSS_RESULTARG

Paramètre de sélection du registre de destination du résultat de cette étape, identifié par D3DTA. Cette valeur peut être définie sur D3DTA_CURRENT (la valeur par défaut) ou sur D3DTA_TEMP, qui est un registre temporaire unique qui peut être lu dans les étapes suivantes en tant qu'argument d'entrée. La couleur finale transmise au mélangeur de brouillard et au tampon de trame est extraite de D3DTA_CURRENT, donc le dernier état de l'étape de texture active doit être défini pour écrire dans le courant. Ce paramètre est pris en charge si la fonctionnalité de périphérique D3DPMISCCAPS_TSSARGTEMP est présente.

D3DTSS_CONSTANT

Couleur constante par étape. Pour voir si un appareil prend en charge une couleur constante par étape, consultez la constante D3DPMISCCAPS_PERSTAGECONSTANT dans D3DPMISCCAPS. D3DTSS_CONSTANT est utilisé par D3DTA_CONSTANT. Voir D3DTA.

D3DTSS_FORCE_DWORD

Force cette énumération à se compiler à une taille de 32 bits. Sans cette valeur, certains compilateurs permettraient à cette énumération de se compiler dans une taille autre que 32 bits. Cette valeur n'est pas utilisée.

Notes

Les membres de ce type énuméré sont utilisés avec les méthodes IDirect3DDevice9::GetTextureStageState et IDirect3DDevice9::SetTextureStageState pour récupérer et définir les valeurs d’état de texture.

La plage valide de valeurs pour les coefficients de matrice de mappage de relief D3DTSS_BUMPENVMAT00, D3DTSS_BUMPENVMAT01, D3DTSS_BUMPENVMAT10 et D3DTSS_BUMPENVMAT11 est supérieure ou égale à -8,0 et inférieure à 8,0. Cette plage, exprimée en notation mathématique est (-8.0,8.0).

Spécifications

Condition requise	Value
En-tête	D3D9Types.h

Voir aussi

Énumérations Direct3D

IDirect3DDevice9::GetTextureStageState

IDirect3DDevice9::SetTextureStageState