XMVector3ProjectStream 함수(directxmath.h)

아티클
02/29/2024

개체 공간에서 화면 공간으로 3D 벡터 스트림을 프로젝터합니다.

구문

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;

매개 변수

[out] pOutputStream

대상 스트림의 첫 번째 XMFLOAT3 주소입니다.

[in] OutputStride

대상 스트림의 벡터 간 Stride(바이트)입니다.

[in] pInputStream

변환할 스트림의 첫 번째 XMFLOAT3 주소입니다.

[in] InputStride

입력 스트림의 벡터 간 Stride(바이트)입니다.

[in] VectorCount

변환할 벡터 수입니다.

[in] ViewportX

뷰포트의 왼쪽 위 모서리의 픽셀 좌표입니다. 표면의 하위 집합에 렌더링하려는 경우가 아니면 이 매개 변수를 0으로 설정할 수 있습니다.

[in] ViewportY

렌더링 대상 화면에서 뷰포트의 왼쪽 위 모서리에 있는 픽셀 좌표입니다. 표면의 하위 집합에 렌더링하려는 경우가 아니면 이 매개 변수를 0으로 설정할 수 있습니다.

[in] ViewportWidth

클립 볼륨의 너비 차원(픽셀)입니다. 표면의 하위 집합으로만 렌더링하지 않는 한 이 매개 변수는 렌더링 대상 표면의 너비 차원으로 설정해야 합니다.

[in] ViewportHeight

클립 볼륨의 높이 차원(픽셀)입니다. 표면의 하위 집합으로만 렌더링하지 않는 한 이 매개 변수는 렌더링 대상 표면의 높이 차원으로 설정해야 합니다.

[in] ViewportMinZ

ViewportMaxZ와 함께 장면을 렌더링할 깊이 값의 범위, 클립 볼륨의 최소값 및 최대값을 설명하는 값입니다. 대부분의 애플리케이션은 이 값을 0.0f로 설정합니다. 클리핑은 프로젝션 행렬을 적용한 후 수행됩니다.

[in] ViewportMaxZ

MinZ와 함께 장면을 렌더링할 깊이 값의 범위, 클립 볼륨의 최소값 및 최대값을 설명하는 값입니다. 대부분의 애플리케이션은 이 값을 1.0f로 설정합니다. 클리핑은 프로젝션 행렬을 적용한 후 수행됩니다.

[in] Projection

프로젝션 행렬.

[in] View

행렬을 봅니다.

[in] World

세계 행렬.

반환 값

대상 스트림에서 첫 번째 XMFLOAT3 주소를 반환합니다.

설명

ViewportX, ViewportY, ViewportWidth 및 ViewportHeight 매개 변수는 렌더링 대상 표면에서 뷰포트의 위치와 크기를 설명합니다. 일반적으로 애플리케이션은 전체 대상 화면에 렌더링됩니다. 640*480 표면에서 렌더링할 때 이러한 매개 변수는 각각 0, 0, 640 및 480이어야 합니다. ViewportMinZ 및 ViewportMaxZ는 일반적으로 0.0f 및 1.0f로 설정되지만 특정 효과를 얻기 위해 다른 값으로 설정할 수 있습니다.

플랫폼 요구 사항

Windows 8 Windows SDK를 사용하는 Microsoft Visual Studio 2010 또는 Microsoft Visual Studio 2012. Win32 데스크톱 앱, Windows 스토어 앱 및 Windows Phone 8개 앱에서 지원됩니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	directxmath.h(DirectXMath.h 포함)

추가 정보

DirectXMath 라이브러리 3D 벡터 변환 함수

XMVector3Project

Share via