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
ターゲット ストリーム内のベクトル間のストライド (バイト単位)。
[in] pInputStream
変換されるストリーム内の最初の XMFLOAT3 のアドレス。 X,Y はピクセル単位で、Z は 0.0 ( ViewportMinZ の場合) から 1.0 ( ViewportMaxZ の場合) です。
[in] InputStride
入力ストリーム内のベクトル間のストライド (バイト単位)。
[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 を含む) |