Freigeben über


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;

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