Método IDCompositionDevice::CreateMatrixTransform3D (dcomp.h)

Cria um objeto de transformação de matriz 3D 4 por 4.

Sintaxe

HRESULT CreateMatrixTransform3D(
  [out] IDCompositionMatrixTransform3D **matrixTransform3D
);

Parâmetros

[out] matrixTransform3D

Tipo: IDCompositionMatrixTransform3D**

O novo objeto de transformação de matriz 3D. Esse parâmetro não deve ser NULL.

Valor retornado

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Consulte Códigos de Erro do DirectComposition para obter uma lista de códigos de erro.

Comentários

A nova transformação de matriz 3D tem a matriz de identidade como seu valor. A matriz de identidade é a matriz 4 por 4 com as na diagonal main e zeros em outro lugar, conforme mostrado na ilustração a seguir.

Quando uma transformação de identidade é aplicada a um objeto, ela não altera a posição, a forma ou o tamanho do objeto. É semelhante à maneira como multiplicar um número por um não altera o número. Qualquer transformação diferente da transformação de identidade modificará a posição, a forma e/ou o tamanho dos objetos.

Requisitos

Confira também

DCompositionEffectGroup::SetTransform3D

IDCompositionDevice