Função XMStoreFloat3x3 (directxmath.h)

  • Artigo

Armazena um XMMATRIX em um XMFLOAT3X3.

Sintaxe

void XM_CALLCONV XMStoreFloat3x3(
  [out] XMFLOAT3X3 *pDestination,
  [in]  FXMMATRIX  M
) noexcept;

Parâmetros

[out] pDestination

Endereço no qual armazenar os dados.

[in] M

Matriz que contém os dados a serem armazenados.

Valor retornado

Nenhum.

Comentários

XMFLOAT3X3 é uma forma de matriz de linha principal. Para gravar dados importantes da coluna, é necessário que o XMMATRIX seja transposto por meio de XMMatrixTranpose antes de chamar a função de repositório.

Essa função usa uma matriz e grava os componentes em nove valores de ponto flutuante de precisão única no endereço fornecido. O componente mais significativo do vetor da primeira linha é gravado nos quatro primeiros bytes do endereço, seguido pelo segundo componente mais significativo da primeira linha, seguido pelo terceiro componente mais significativo da primeira linha. Os três componentes mais significativos da segunda linha são então gravados de maneira semelhante à memória começando no byte 12, seguido pela terceira linha para a memória começando no byte 24.

O pseudocódigo a seguir demonstra a operação da função.

pDestination->_11 = M[0].x; // 4 bytes to address (uint8_t*)pDestination
pDestination->_12 = M[0].y; // 4 bytes to address (uint8_t*)pDestination + 4
pDestination->_13 = M[0].z; // 4 bytes to address (uint8_t*)pDestination + 8

pDestination->_21 = M[1].x; // 4 bytes to address (uint8_t*)pDestination + 12
pDestination->_22 = M[1].y; // 4 bytes to address (uint8_t*)pDestination + 16
pDestination->_23 = M[1].z; // 4 bytes to address (uint8_t*)pDestination + 20

pDestination->_31 = M[2].x; // 4 bytes to address (uint8_t*)pDestination + 24
pDestination->_32 = M[2].y; // 4 bytes to address (uint8_t*)pDestination + 28
pDestination->_33 = M[2].z; // 4 bytes to address (uint8_t*)pDestination + 32

Requisitos da plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho directxmath.h

Confira também

Funções do Repositório de Vetores da Biblioteca DirectXMath