D3DVIEWPORT9-Struktur

Definiert die Fensterdimensionen einer Renderzieloberfläche, auf die ein 3D-Volume projiziert wird.

Syntax

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

Members

X

Typ: DWORD

Pixelkoordinate der oberen linken Ecke des Viewports auf der Renderzieloberfläche. Wenn Sie nicht in eine Teilmenge der Oberfläche rendern möchten, kann dieser Member auf 0 festgelegt werden.

J

Typ: DWORD

Pixelkoordinate der oberen linken Ecke des Viewports auf der Renderzieloberfläche. Wenn Sie nicht in eine Teilmenge der Oberfläche rendern möchten, kann dieser Member auf 0 festgelegt werden.

Width

Typ: DWORD

Breitendimension des Clipvolumes in Pixel. Sofern Sie nicht nur in eine Teilmenge der Oberfläche rendern, sollte dieses Element auf die Breite der Renderzieloberfläche festgelegt werden.

Height

Typ: DWORD

Höhendimension des Clipvolumens in Pixel. Sofern Sie nicht nur in eine Teilmenge der Oberfläche rendern, sollte dieses Element auf die Höhendimension der Renderzieloberfläche festgelegt werden.

MinZ

Typ: float

Zusammen mit MaxZ ein Wert, der den Bereich der Tiefenwerte beschreibt, in den eine Szene gerendert werden soll, die Minimal- und Höchstwerte des Clipvolumens. Die meisten Anwendungen legen diesen Wert auf 0,0 fest. Clipping wird ausgeführt, nachdem die Projektionsmatrix angewendet wurde.

MaxZ

Typ: float

Zusammen mit MinZ ein Wert, der den Bereich der Tiefenwerte beschreibt, in den eine Szene gerendert werden soll, die Minimal- und Höchstwerte des Clipvolumens. Die meisten Anwendungen legen diesen Wert auf 1.0 fest. Clipping wird ausgeführt, nachdem die Projektionsmatrix angewendet wurde.

Bemerkungen

Die Elemente X, Y, Width und Height beschreiben die Position und Die Abmessungen des Viewports auf der Renderzieloberfläche. In der Regel werden Anwendungen auf der gesamten Zieloberfläche gerendert. Beim Rendern auf einer 640 x 480-Oberfläche sollten diese Member 0, 0, 640 bzw. 480 sein. MinZ und MaxZ sind in der Regel auf 0,0 und 1,0 festgelegt, können aber auf andere Werte festgelegt werden, um bestimmte Effekte zu erzielen. Beispielsweise können Sie beide auf 0,0 festlegen, um zu erzwingen, dass das System Objekte im Vordergrund einer Szene rendert, oder beide auf 1.0, um die Objekte in den Hintergrund zu zwingen.

Wenn sich die Viewportparameter für ein Gerät ändern (aufgrund eines Aufrufs der SetViewport-Methode), erstellt der Treiber eine neue Transformationsmatrix.

Requirements (Anforderungen)

Anforderung Wert
Header
D3D9Types.h

Weitere Informationen

Direct3D-Strukturen

GetViewport

SetViewport