D3DXPlaneTransformArray 函式 (D3dx9math.h)
注意
D3DX 公用程式程式庫已被取代。 建議您改用 DirectXMath 。
依矩陣轉換平面陣列。 描述每個平面的向量必須正規化。
語法
D3DXPLANE* D3DXPlaneTransformArray(
_Inout_ D3DXPLANE *pOut,
_Out_ UINT OutStride,
_In_ const D3DXPLANE *pP,
_In_ UINT PStride,
_In_ const D3DXMATRIX *pM,
_In_ UINT n
);
參數
-
pOut [in， out]
-
類型： D3DXPLANE*
包含所產生轉換平面 之 D3DXPLANE 結構的指標。 請參閱範例。
-
OutStride [out]
-
類型： UINT
每個轉換平面的步幅。
-
pP [in]
-
類型：const D3DXPLANE*
輸入 D3DXPLANE 結構的指標，其中包含要轉換的平面陣列。 在呼叫此函式之前，必須正規化描述平面的向量 (b，c) 。 請參閱範例。
-
PStride [in]
-
類型： UINT
每個非轉換平面的步幅。
-
pM [in]
-
類型：const D3DXMATRIX*
來源 D3DXMATRIX 結構的指標，其中包含轉換值的反向轉置。
-
n [in]
-
類型： UINT
要轉換的平面數目。
傳回值
類型： D3DXPLANE*
D3DXPLANE結構的指標，代表已轉換的平面。 這是 pOut 參數中傳回的相同值，因此此函式可作為另一個函式的參數。
備註
本範例會套用非統一小數位數來轉換一個平面。
#define ARRAYSIZE 4
D3DXPLANE planeNew[ARRAYSIZE];
D3DXPLANE plane[ARRAYSIZE];
for(int i = 0; i < ARRAYSIZE; i++)
{
plane = D3DXPLANE( 0.0f, 1.0f, 1.0f, 0.0f );
D3DXPlaneNormalize( &plane[i], &plane[i] );
}
D3DXMATRIX matrix;
D3DXMatrixScaling( &matrix, 1.0f, 2.0f, 3.0f );
D3DXMatrixInverse( &matrix, NULL, &matrix );
D3DXMatrixTranspose( &matrix, &matrix );
D3DXPlaneTransformArray( &planeNew, sizeof (D3DXPLANE), &plane,
sizeof (D3DXPLANE), &matrix, ARRAYSIZE );
平面是由 ax + by + cz + dw = 0 所描述。 第一個平面是使用 (a，b，d) = (0，1，1，0) 建立，這是 y + z = 0 所描述的平面。 調整之後，新的平面會包含 (a，b，c，d) = (0， 0.353f， 0.235f， 0) ，這會顯示 0.353y + 0.235z = 0 所描述的新平面。
參數 pM 包含轉換矩陣的反向轉置。 此方法需要反向轉置，因此轉換平面的一般向量也可以正確轉換。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱