XMVector3Unproject-Funktion (directxmath.h)

Artikel
02/26/2024

Projiziert einen 3D-Vektor aus dem Bildschirmbereich in den Objektraum.

Syntax

XMVECTOR XM_CALLCONV XMVector3Unproject(
  [in] FXMVECTOR V,
  [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

[in] V

3D-Vektor im Bildschirmbereich, der in den Objektraum projiziert wird. X und Y sind in Pixel, während Z 0,0 (bei ViewportMinZ) bis 1,0 (bei ViewportMaxZ) ist.

[in] ViewportX

Pixelkoordinate der linken oberen 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 Pixel. Sofern Sie nicht nur eine Teilmenge der Oberfläche rendern, sollte dieser Parameter auf die Breitendimension der Renderzieloberfläche festgelegt werden.

[in] ViewportHeight

Höhendimension der Cliplautstärke in Pixel. Sofern Sie nicht nur 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 Ausschneiden erfolgt nach dem Anwenden der Projektionsmatrix.

[in] ViewportMaxZ

Zusammen mit MinZ: 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 Ausschneiden erfolgt nach dem Anwenden der Projektionsmatrix.

[in] Projection

Projektionsmatrix.

[in] View

Matrix anzeigen.

[in] World

Weltmatrix.

Rückgabewert

Gibt einen Vektor im Objektraum 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 von 640 * 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

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	directxmath.h (einschließlich DirectXMath.h)

Weitere Informationen

3D-Vektortransformationsfunktionen der DirectXMath-Bibliothek

XMVector3UnprojectStream

Freigeben über