XMVector3Project-Funktion (directxmath.h)

Artikel
08/23/2023

Projizieren Sie einen 3D-Vektor aus dem Objektbereich in den Bildschirmbereich.

Syntax

XMVECTOR XM_CALLCONV XMVector3Project(
  [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 Objektbereich, der in den Bildschirmbereich projiziert wird.

[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 einen Vektor im Bildschirmbereich 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

XMVector3ProjectStream

Freigeben über