Partager via


Structure D3DVIEWPORT9

Définit les dimensions de fenêtre d’une surface de cible de rendu sur laquelle un volume 3D est projeté.

Syntaxe

typedef struct D3DVIEWPORT9 {
  DWORD X;
  DWORD Y;
  DWORD Width;
  DWORD Height;
  float MinZ;
  float MaxZ;
} D3DVIEWPORT9, *LPD3DVIEWPORT9;

Membres

X

Type : DWORD

Coordonnée de pixels du coin supérieur gauche de la fenêtre d’affichage sur la surface de la cible de rendu. Sauf si vous souhaitez effectuer un rendu sur un sous-ensemble de la surface, ce membre peut être défini sur 0.

O

Type : DWORD

Coordonnée de pixels du coin supérieur gauche de la fenêtre d’affichage sur la surface de la cible de rendu. Sauf si vous souhaitez effectuer un rendu sur un sous-ensemble de la surface, ce membre peut être défini sur 0.

Width

Type : DWORD

Dimension de largeur du volume du clip, en pixels. Sauf si vous effectuez un rendu uniquement sur un sous-ensemble de la surface, ce membre doit être défini sur la dimension de largeur de la surface cible de rendu.

Height

Type : DWORD

Dimension de hauteur du volume du clip, en pixels. Sauf si vous effectuez un rendu uniquement sur un sous-ensemble de la surface, ce membre doit être défini sur la dimension de hauteur de la surface cible de rendu.

Minz

Type : float

Avec MaxZ, valeur décrivant la plage de valeurs de profondeur dans laquelle une scène doit être rendue, les valeurs minimales et maximales du volume de clip. La plupart des applications définissent cette valeur sur 0,0. Le découpage est effectué après l’application de la matrice de projection.

MaxZ

Type : float

Avec MinZ, valeur décrivant la plage de valeurs de profondeur dans laquelle une scène doit être rendue, les valeurs minimales et maximales du volume de clip. La plupart des applications définissent cette valeur sur 1.0. Le découpage est effectué après l’application de la matrice de projection.

Notes

Les membres X, Y, Width et Height décrivent la position et les dimensions de la fenêtre d’affichage sur la surface cible de rendu. En règle générale, les applications s’affichent sur l’ensemble de la surface cible ; lors du rendu sur une surface de 640 x 480, ces membres doivent être 0, 0, 640 et 480, respectivement. MinZ et MaxZ sont généralement définis sur 0.0 et 1.0, mais peuvent être définis sur d’autres valeurs pour obtenir des effets spécifiques. Par exemple, vous pouvez les définir sur 0.0 pour forcer le système à restituer les objets au premier plan d’une scène, ou les deux sur 1.0 pour forcer les objets à l’arrière-plan.

Lorsque les paramètres de fenêtre d’affichage d’un appareil changent (en raison d’un appel à la méthode SetViewport ), le pilote génère une nouvelle matrice de transformation.

Spécifications

Condition requise Valeur
En-tête
D3D9Types.h

Voir aussi

Direct3D Structures

GetViewport

SetViewport