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 |
|