D3DVIEWPORT9 结构

定义 3D 卷投影到的呈现目标图面的窗口尺寸。

语法

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

成员

X

类型： DWORD

呈现目标图面上视区左上角的像素坐标。 除非你想要呈现到图面的子集，否则此成员可以设置为 0。

是

类型： DWORD

呈现目标图面上视区左上角的像素坐标。 除非你想要呈现到图面的子集，否则此成员可以设置为 0。

Width

类型： DWORD

剪辑卷的宽度尺寸（以像素为单位）。 除非只呈现到图面的子集，否则应将此成员设置为呈现目标图面的宽度维度。

Height

类型： DWORD

剪辑卷的高度尺寸（以像素为单位）。 除非只呈现到图面的子集，否则应将此成员设置为呈现目标图面的高度维度。

MinZ

类型： float

与 MaxZ 一起的值，该值描述要呈现场景的深度值范围，以及剪辑音量的最小值和最大值。 大多数应用程序将此值设置为 0.0。 应用投影矩阵后执行剪裁。

MaxZ

类型： float

与 MinZ 一起的值，该值描述要呈现场景的深度值范围，以及剪辑体积的最小值和最大值。 大多数应用程序将此值设置为 1.0。 应用投影矩阵后执行剪裁。

备注

X、Y、Width 和 Height 成员描述呈现目标图面上视区的位置和尺寸。 通常，应用程序呈现到整个目标图面;在 640 x 480 表面上呈现时，这些成员应分别为 0、0、640 和 480。 MinZ 和 MaxZ 通常设置为 0.0 和 1.0，但可以设置为其他值以实现特定效果。 例如，可以将两者都设置为 0.0，以强制系统将对象呈现到场景的前景，或将两者都设置为 1.0 以强制对象进入背景。

当设备视区参数由于调用 SetViewport 方法) 而 (更改时，驱动程序将生成一个新的转换矩阵。

要求

要求	值
标头	D3D9Types.h

另请参阅

Direct3D 结构

GetViewport

SetViewport