Função D3DXPlaneTransform (D3dx9math.h)
Observação
A biblioteca do utilitário D3DX foi preterida. Em vez disso, recomendamos que você use DirectXMath .
Transforma um plano por uma matriz. A matriz de entrada é a transposição inversa da transformação real.
Sintaxe
D3DXPLANE* D3DXPlaneTransform(
_Inout_ D3DXPLANE *pOut,
_In_ const D3DXPLANE *pP,
_In_ const D3DXMATRIX *pM
);
Parâmetros
-
pOut [in, out]
-
Tipo: D3DXPLANE*
Ponteiro para a estrutura D3DXPLANE que contém o plano transformado resultante. Confira o exemplo.
-
pP [in]
-
Tipo: const D3DXPLANE*
Ponteiro para a estrutura D3DXPLANE de entrada, que contém o plano que será transformado. O vetor (a,b,c) que descreve o plano deve ser normalizado antes que essa função seja chamada. Confira o exemplo.
-
pM [in]
-
Tipo: const D3DXMATRIX*
Ponteiro para a estrutura D3DXMATRIX de origem, que contém os valores de transformação. Essa matriz deve conter a transposição inversa dos valores de transformação.
Valor retornado
Tipo: D3DXPLANE*
Ponteiro para uma estrutura D3DXPLANE , representando o plano transformado. Esse é o mesmo valor retornado no parâmetro pOut para que essa função possa ser usada como um parâmetro para outra função.
Comentários
Exemplos
Este exemplo transforma um plano aplicando uma escala não 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);
Um plano é descrito por ax + by + cz + dw = 0. O primeiro plano é criado com (a,b,c,d) = (0,1,1,0), que é um plano descrito por y + z = 0. Após o dimensionamento, o novo plano contém (a,b,c,d) = (0, 0,353f, 0,235f, 0), que mostra o novo plano a ser descrito por 0,353y + 0,235z = 0.
O parâmetro pM contém a transposição inversa da matriz de transformação. A transposição inversa é exigida por esse método para que o vetor normal do plano transformado também possa ser transformado corretamente.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também