XMVector3UnprojectStream-Funktion (directxmath.h)

Artikel
08/23/2023

Transformiert einen Stream von 3D-Vektoren aus dem Bildschirmbereich in den Objektbereich.

Syntax

XMFLOAT3 *XM_CALLCONV XMVector3UnprojectStream(
  [out] XMFLOAT3       *pOutputStream,
  [in]  size_t         OutputStride,
  [in]  const XMFLOAT3 *pInputStream,
  [in]  size_t         InputStride,
  [in]  size_t         VectorCount,
  [in]  float          ViewportX,
  [in]  float          ViewportY,
  [in]  float          ViewportWidth,
  [in]  float          ViewportHeight,
  [in]  float          ViewportMinZ,
  [in]  float          ViewportMaxZ,
  [in]  FXMMATRIX      Projection,
  [in]  CXMMATRIX      View,
  [in]  CXMMATRIX      World
) noexcept;

Parameter

[out] pOutputStream

Adresse des ersten XMFLOAT3 im Zieldatenstrom.

[in] OutputStride

Stride in Bytes zwischen Vektoren im Zieldatenstrom.

[in] pInputStream

Adresse des ersten XMFLOAT3-Datenstroms , der transformiert werden soll. X, Y sind in Pixeln, während Z 0,0 (bei ViewportMinZ) bis 1,0 (bei ViewportMaxZ) ist.

[in] InputStride

Stride in Bytes zwischen Vektoren im Eingabedatenstrom.

[in] VectorCount

Anzahl der zu transformierenden Vektoren.

[in] ViewportX

Pixelkoordinate der oberen linken Ecke des Viewports. Sofern Sie nicht in einer Teilmenge der Oberfläche rendern möchten, kann dieser Parameter auf 0 festgelegt werden.

[in] ViewportY

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 Parameter auf 0 festgelegt werden.

[in] ViewportWidth

Breite der Cliplautstärke in Pixeln. Sofern Sie nicht nur in einer Teilmenge der Oberfläche rendern, sollte dieser Parameter auf die Breite der Renderzieloberfläche festgelegt werden.

[in] ViewportHeight

Höhe der Cliplautstärke in Pixeln. Sofern Sie nicht nur für eine Teilmenge der Oberfläche rendern, sollte dieser Parameter auf die Höhendimension der Renderzieloberfläche festgelegt werden.

[in] ViewportMinZ

Zusammen mit ViewportMaxZ 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 0,0f fest. Das Beschneiden wird nach dem Anwenden der Projektionsmatrix ausgeführt.

[in] ViewportMaxZ

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,0f fest. Das Beschneiden wird nach dem Anwenden der Projektionsmatrix ausgeführt.

[in] Projection

Projektionsmatrix.

[in] View

Ansichtsmatrix.

[in] World

Weltmatrix.

Rückgabewert

Gibt die Adresse des ersten XMFLOAT3 im Zieldatenstrom zurück.

Hinweise

Die Parameter ViewportX, ViewportY, ViewportWidth und ViewportHeight beschreiben die Position und die Dimensionen 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 Parameter 0, 0, 640 bzw. 480 sein. ViewportMinZ und ViewportMaxZ sind in der Regel auf 0,0f und 1,0f festgelegt, können jedoch auf andere Werte festgelegt werden, um bestimmte Effekte zu erzielen.

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.

Anforderungen


Zielplattform	Windows
Kopfzeile	directxmath.h (DirectXMath.h einschließen)

Weitere Informationen

3D-Vektortransformationsfunktionen der DirectXMath-Bibliothek

XMVector3Unproject

Freigeben über