D3D11_VIEWPORT-Struktur (d3d11.h)

  • Artikel

Definiert die Dimensionen eines Viewports.

Syntax

typedef struct D3D11_VIEWPORT {
  FLOAT TopLeftX;
  FLOAT TopLeftY;
  FLOAT Width;
  FLOAT Height;
  FLOAT MinDepth;
  FLOAT MaxDepth;
} D3D11_VIEWPORT;

Member

TopLeftX

Typ: FLOAT

X-Position der linken Seite des Viewports. Bereiche zwischen D3D11_VIEWPORT_BOUNDS_MIN und D3D11_VIEWPORT_BOUNDS_MAX.

TopLeftY

Typ: FLOAT

Y-Position des oberen Rands des Viewports. Bereiche zwischen D3D11_VIEWPORT_BOUNDS_MIN und D3D11_VIEWPORT_BOUNDS_MAX.

Width

Typ: FLOAT

Breite des Viewports.

Height

Typ: FLOAT

Höhe des Viewports.

MinDepth

Typ: FLOAT

Minimale Tiefe des Viewports. Bereiche zwischen 0 und 1.

MaxDepth

Typ: FLOAT

Maximale Tiefe des Viewports. Bereiche zwischen 0 und 1.

Hinweise

In allen Fällen müssen Width und Height = 0 und >TopLeftX + Width und TopLeftY + Height = D3D11_VIEWPORT_BOUNDS_MAX sein<.

Viewportgrößen und Unterstützung auf Featureebene Unterschiede zwischen Direct3D 11 und Direct3D 10:

Der Bereich für die minimale und maximale Viewportgröße hängt von der durch D3D_FEATURE_LEVEL definierten Featureebene ab.

  • Direct3D 11 unterstützt Viewports mit Bruchteilen; Die Parametertypen sind Gleitkommazahlen. Die Featureebene D3D_FEATURE_LEVEL_11_0 unterstützt (D3D11_VIEWPORT_BOUNDS_MIN, D3D11_VIEWPORT_BOUNDS_MAX) Werte zwischen (-32768, 32.767).
  • Direct3D 10 unterstützt keine Bruchteile von Viewports. Die Featureebenen D3D_FEATURE_LEVEL_10_1 (oder darunter) unterstützen (D3D10_VIEWPORT_BOUNDS_MIN, D3D10_VIEWPORT_BOUNDS_MAX) Werte zwischen (-16384, 16383).
 
Hinweis Obwohl Sie float-Werte für die Member der D3D11_VIEWPORT-Struktur für das pViewports-Array in einem Aufruf von ID3D11DeviceContext::RSSetViewports für Featureebenen 9_x angeben, verwendet RSSetViewports intern DWORDs. Aufgrund dieses Verhaltens schlägt der Aufruf von RSSetViewports für Featureebenen 9_x fehl, wenn Sie eine negative linke obere Ecke für den Viewport verwenden. Dieser Fehler tritt auf, weil RSSetViewports für 9_x die Gleitkommawerte ohne Vorzeichen ohne Validierung in ganze Zahlen ohne Vorzeichen umwandeln, was zu einem Ganzzahlüberlauf führt.
 

Anforderungen

Anforderung Wert
Header d3d11.h

Weitere Informationen

Kernstrukturen