Estructura D3DVIEWPORT9

Artículo
06/13/2023

Define las dimensiones de ventana de una superficie de destino de representación en la que se proyecta un volumen 3D.

Sintaxis

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

Miembros

X: Tipo: DWORD; Coordenada de píxel de la esquina superior izquierda de la ventanilla en la superficie de destino de representación. A menos que desee representar en un subconjunto de la superficie, este miembro se puede establecer en 0.
S: Tipo: DWORD; Coordenada de píxel de la esquina superior izquierda de la ventanilla en la superficie de destino de representación. A menos que desee representar en un subconjunto de la superficie, este miembro se puede establecer en 0.
Width: Tipo: DWORD; Dimensión de ancho del volumen de clip, en píxeles. A menos que solo se represente en un subconjunto de la superficie, este miembro debe establecerse en la dimensión de ancho de la superficie de destino de representación.
Height: Tipo: DWORD; Dimensión de alto del volumen del clip, en píxeles. A menos que solo se represente en un subconjunto de la superficie, este miembro debe establecerse en la dimensión de alto de la superficie de destino de representación.
MinZ: Tipo: float; Junto con MaxZ, valor que describe el intervalo de valores de profundidad en el que se va a representar una escena, los valores mínimo y máximo del volumen de recorte. La mayoría de las aplicaciones establecen este valor en 0,0. El recorte se realiza después de aplicar la matriz de proyección.
MaxZ: Tipo: float; Junto con MinZ, valor que describe el intervalo de valores de profundidad en el que se va a representar una escena, los valores mínimo y máximo del volumen de recorte. La mayoría de las aplicaciones establecen este valor en 1.0. El recorte se realiza después de aplicar la matriz de proyección.

Observaciones

Los miembros X, Y, Width y Height describen la posición y las dimensiones de la ventanilla en la superficie de destino de representación. Normalmente, las aplicaciones se representan en toda la superficie de destino; cuando se representa en una superficie de 640 x 480, estos miembros deben ser 0, 0, 640 y 480, respectivamente. MinZ y MaxZ se establecen normalmente en 0,0 y 1,0, pero se pueden establecer en otros valores para lograr efectos específicos. Por ejemplo, puede establecerlos en 0,0 para forzar que el sistema represente objetos en primer plano de una escena, o ambos en 1,0 para forzar los objetos en segundo plano.

Cuando los parámetros de ventanilla de un dispositivo cambian (debido a una llamada al método SetViewport ), el controlador crea una nueva matriz de transformación.

Requisitos

Requisito	Value
Encabezado	D3D9Types.h

Consulte también

Estructuras de Direct3D
GetViewport
SetViewport