Función XMVector3Project (directxmath.h)
Proyecta un vector 3D del espacio de objetos en el espacio de pantalla.
Sintaxis
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;
Parámetros
[in] V
Vector 3D en el espacio de objetos que se proyectará en el espacio de pantalla.
[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 pantalla.
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
| Plataforma de destino | Windows |
| Encabezado | directxmath.h (incluir DirectXMath.h) |
Consulte también
Funciones de transformación de vectores 3D de la biblioteca DirectXMath