D3DVIEWPORT9-Struktur

Artikel
06/13/2023

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;

Member

X: Typ: DWORD; Pixelkoordinate der oberen linken Ecke des Viewports auf der Renderzieloberfläche. Sofern Sie nicht in einer 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. Sofern Sie nicht in einer Teilmenge der Oberfläche rendern möchten, kann dieser Member auf 0 festgelegt werden.
Width: Typ: DWORD; Breite der Cliplautstärke in Pixeln. Sofern Sie nicht nur für eine Teilmenge der Oberfläche rendern, sollte dieser Member auf die Breite der Renderzieloberfläche festgelegt werden.
Height: Typ: DWORD; Höhe der Cliplautstärke in Pixeln. Sofern Sie nicht nur für eine Teilmenge der Oberfläche rendern, sollte dieser Member auf die Höhendimension der Renderzieloberfläche festgelegt werden.
MinZ: Typ: float; Zusammen mit MaxZ der Wert, der den Bereich der Tiefenwerte beschreibt, in den eine Szene gerendert werden soll, die minimalen und maximalen Werte der Cliplautstärke. Die meisten Anwendungen legen diesen Wert auf 0,0 fest. Das Beschneiden wird nach dem Anwenden der Projektionsmatrix ausgeführt.
MaxZ: Typ: float; Zusammen mit MinZ der Wert, der den Bereich der Tiefenwerte beschreibt, in den eine Szene gerendert werden soll, die Minimal- und Höchstwerte der Cliplautstärke. Die meisten Anwendungen legen diesen Wert auf 1,0 fest. Das Beschneiden wird nach dem Anwenden der Projektionsmatrix ausgeführt.

Bemerkungen

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

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

Anforderungen

Anforderung	Wert
Header	D3D9Types.h

Siehe auch

Direct3D-Strukturen
GetViewport
SetViewport

Share via