XMVector3UnprojectStream 함수(directxmath.h)
3D 벡터 스트림을 화면 공간에서 개체 공간으로 변환합니다.
구문
XMFLOAT3 *XM_CALLCONV XMVector3UnprojectStream(
[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 주소입니다. X,Y는 픽셀이고 Z는 0.0( ViewportMinZ)에서 1.0( ViewportMaxZ)입니다.
[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 포함) |