Fonction XMVector3Unproject (directxmath.h)

Article
02/26/2024

Projette un vecteur 3D de l’espace d’écran dans l’espace objet.

Syntaxe

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;

Paramètres

[in] V

Vecteur 3D dans l’espace d’écran qui sera projeté dans l’espace objet. X et Y sont en pixels, tandis que Z est de 0,0 (chez ViewportMinZ) à 1,0 (à ViewportMaxZ).

[in] ViewportX

Coordonnées de pixels du coin supérieur gauche de la fenêtre d’affichage. Sauf si vous souhaitez effectuer un rendu sur un sous-ensemble de la surface, ce paramètre peut être défini sur 0.

[in] ViewportY

Coordonnée de pixels du coin supérieur gauche de la fenêtre d’affichage sur la surface de la cible de rendu. Sauf si vous souhaitez effectuer un rendu sur un sous-ensemble de la surface, ce paramètre peut être défini sur 0.

[in] ViewportWidth

Dimension de largeur du volume du clip, en pixels. Sauf si vous effectuez un rendu uniquement sur un sous-ensemble de la surface, ce paramètre doit être défini sur la dimension de largeur de la surface cible de rendu.

[in] ViewportHeight

Dimension de hauteur du volume du clip, en pixels. Sauf si vous effectuez un rendu uniquement sur un sous-ensemble de la surface, ce paramètre doit être défini sur la dimension de hauteur de la surface cible de rendu.

[in] ViewportMinZ

Avec ViewportMaxZ, valeur décrivant la plage de valeurs de profondeur dans laquelle une scène doit être rendue, les valeurs minimales et maximales du volume de clip. La plupart des applications définissent cette valeur sur 0,0f. Le découpage est effectué après l’application de la matrice de projection.

[in] ViewportMaxZ

Avec MinZ, valeur décrivant la plage de valeurs de profondeur dans laquelle une scène doit être rendue, les valeurs minimales et maximales du volume de clip. La plupart des applications définissent cette valeur sur 1.0f. Le découpage est effectué après l’application de la matrice de projection.

[in] Projection

Matrice de projection.

[in] View

Matrice d’affichage.

[in] World

Matrice mondiale.

Valeur retournée

Retourne un vecteur dans l’espace d’objet.

Remarques

Les paramètres ViewportX, ViewportY, ViewportWidth et ViewportHeight décrivent la position et les dimensions de la fenêtre d’affichage sur la surface cible de rendu. En règle générale, les applications s’affichent sur l’ensemble de la surface cible ; lors du rendu sur une surface 640*480, ces paramètres doivent être 0, 0, 640 et 480, respectivement. ViewportMinZ et ViewportMaxZ sont généralement définis sur 0.0f et 1.0f, mais peuvent être définis sur d’autres valeurs pour obtenir des effets spécifiques.

Configuration requise pour la plateforme

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le SDK Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et les applications Windows Phone 8.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	directxmath.h (inclure DirectXMath.h)

Voir aussi

Fonctions de transformation vectorielle 3D de la bibliothèque DirectXMath

XMVector3UnprojectStream

Partager via