Compartir a través de

Función XMVector3Unproject (directxmath.h)

  • Artículo

Proyecta un vector 3D desde el espacio de pantalla hasta el espacio de objetos.

Sintaxis

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;

Parámetros

[in] V

Vector 3D en el espacio de pantalla que se proyectará en el espacio de objetos. X e Y están en píxeles, mientras que Z es de 0,0 (en ViewportMinZ) a 1,0 (en ViewportMaxZ).

[in] ViewportX

Coordenada de píxel de la esquina superior izquierda de la ventanilla. A menos que desee representar en un subconjunto de la superficie, este parámetro se puede establecer en 0.

[in] ViewportY

Coordenada de píxel de la esquina superior izquierda de la ventanilla en la superficie de destino de representación. A menos que desee representar en un subconjunto de la superficie, este parámetro se puede establecer en 0.

[in] ViewportWidth

Dimensión de ancho del volumen de clip, en píxeles. A menos que solo se represente en un subconjunto de la superficie, este parámetro debe establecerse en la dimensión de ancho de la superficie de destino de representación.

[in] ViewportHeight

Dimensión de alto del volumen del clip, en píxeles. A menos que solo se represente en un subconjunto de la superficie, este parámetro debe establecerse en la dimensión height de la superficie de destino de representación.

[in] ViewportMinZ

Junto con ViewportMaxZ, valor que describe el intervalo de valores de profundidad en los que se va a representar una escena, los valores mínimo y máximo del volumen de recorte. La mayoría de las aplicaciones establecen este valor en 0,0f. El recorte se realiza después de aplicar la matriz de proyección.

[in] ViewportMaxZ

Junto con MinZ, valor que describe el intervalo de valores de profundidad en el que se va a representar una escena, los valores mínimo y máximo del volumen de recorte. La mayoría de las aplicaciones establecen este valor en 1.0f. El recorte se realiza después de aplicar la matriz de proyección.

[in] Projection

Matriz de proyección.

[in] View

Matriz de vistas.

[in] World

Matriz mundial.

Valor devuelto

Devuelve un vector en el espacio de objetos.

Comentarios

Los parámetros ViewportX, ViewportY, ViewportWidth y ViewportHeight describen la posición y las dimensiones de la ventanilla en la superficie de destino de representación. Normalmente, las aplicaciones se representan en toda la superficie de destino; cuando se representa en una superficie de 640*480, estos parámetros deben ser 0, 0, 640 y 480, respectivamente. ViewportMinZ y ViewportMaxZ se establecen normalmente en 0.0f y 1.0f, pero se pueden establecer en otros valores para lograr efectos específicos.

Requisitos de la plataforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK para Windows 8. Compatible con aplicaciones de escritorio Win32, aplicaciones de la Tienda Windows y Windows Phone 8 aplicaciones.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado directxmath.h (incluir DirectXMath.h)

Consulte también

Funciones de transformación de vectores 3D de la biblioteca DirectXMath

XMVector3UnprojectStream