Compartir a través de

Función XMVector3ProjectStream (directxmath.h)

  • Artículo

Proyecta una secuencia de vectores 3D del espacio de objetos en el espacio de pantalla.

Sintaxis

XMFLOAT3 *XM_CALLCONV XMVector3ProjectStream(
  [out] XMFLOAT3       *pOutputStream,
  [in]  size_t         OutputStride,
  [in]  const XMFLOAT3 *pInputStream,
  [in]  size_t         InputStride,
  [in]  size_t         VectorCount,
  [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

[out] pOutputStream

Dirección del primer XMFLOAT3 de la secuencia de destino.

[in] OutputStride

Intervalo, en bytes, entre vectores de la secuencia de destino.

[in] pInputStream

Dirección del primer XMFLOAT3 de la secuencia que se va a transformar.

[in] InputStride

Intervalo, en bytes, entre vectores del flujo de entrada.

[in] VectorCount

Número de vectores que se van a transformar.

[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 la dirección del primer XMFLOAT3 de la secuencia de destino.

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

XMVector3Project