Funzione D3DXPlaneTransform (D3dx9math.h)
Nota
La libreria di utilità D3DX è deprecata. È consigliabile usare invece DirectXMath .
Trasforma un piano in base a una matrice. La matrice di input è il trasposto inverso della trasformazione effettiva.
Sintassi
D3DXPLANE* D3DXPlaneTransform(
_Inout_ D3DXPLANE *pOut,
_In_ const D3DXPLANE *pP,
_In_ const D3DXMATRIX *pM
);
Parametri
-
pOut [in, out]
-
Tipo: D3DXPLANE*
Puntatore alla struttura D3DXPLANE che contiene il piano trasformato risultante. Vedere l'esempio.
-
pP [in]
-
Tipo: const D3DXPLANE*
Puntatore alla struttura D3DXPLANE di input, che contiene il piano che verrà trasformato. Il vettore (a,b,c) che descrive il piano deve essere normalizzato prima che venga chiamata questa funzione. Vedere l'esempio.
-
pM [in]
-
Tipo: const D3DXMATRIX*
Puntatore alla struttura D3DXMATRIX di origine, che contiene i valori di trasformazione. Questa matrice deve contenere il trasposto inverso dei valori di trasformazione.
Valore restituito
Tipo: D3DXPLANE*
Puntatore a una struttura D3DXPLANE che rappresenta il piano trasformato. Questo è lo stesso valore restituito nel parametro pOut in modo che questa funzione possa essere usata come parametro per un'altra funzione.
Commenti
Esempi
In questo esempio viene trasformato un piano applicando una scala non uniforme.
D3DXPLANE planeNew;
D3DXPLANE plane(0,1,1,0);
D3DXPlaneNormalize(&plane, &plane);
D3DXMATRIX matrix;
D3DXMatrixScaling(&matrix, 1.0f,2.0f,3.0f);
D3DXMatrixInverse(&matrix, NULL, &matrix);
D3DXMatrixTranspose(&matrix, &matrix);
D3DXPlaneTransform(&planeNew, &plane, &matrix);
Un piano è descritto da ax + by + cz + dw = 0. Il primo piano viene creato con (a,b,c,d) = (0,1,1,0), che è un piano descritto da y + z = 0. Dopo il ridimensionamento, il nuovo piano contiene (a,b,c,d) = (0, 0,353f, 0,235f, 0), che mostra il nuovo piano da descrivere da 0,353y + 0,235z = 0.
Il parametro pM contiene il trasposto inverso della matrice di trasformazione. Il trasposto inverso è richiesto da questo metodo in modo che anche il vettore normale del piano trasformato possa essere trasformato correttamente.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche