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 方法) 而 (更改时,驱动程序将生成一个新的转换矩阵。

要求

要求 Value
标头
D3D9Types.h

另请参阅

Direct3D 结构

GetViewport

SetViewport