Função D3DXComputeIMTFromSignal

Calcula IMTs por triângulo de um sinal especificado pelo aplicativo personalizado que varia sobre a superfície da malha (geralmente em uma frequência mais alta do que os dados de vértice). O sinal é avaliado por meio de uma função de retorno de chamada especificada pelo usuário.

Sintaxe

HRESULT D3DXComputeIMTFromSignal(
  _In_  LPD3DXMESH              pMesh,
  _In_  DWORD                   dwTextureIndex,
  _In_  UINT                    uSignalDimension,
  _In_  FLOAT                   fMaxUVDistance,
  _In_  DWORD                   dwOptions,
  _In_  LPD3DXIMTSIGNALCALLBACK pSignalCallback,
  _In_  VOID                    *pUserData,
        LPD3DXUVATLASCB         pStatusCallback,
        LPVOID                  pUserContext,
  _Out_ LPD3DXBUFFER            *ppIMTData
);

Parâmetros

pMesh [in]

Tipo: LPD3DXMESH

Um ponteiro para uma malha de entrada (consulte ID3DXMesh) que contém a geometria do objeto para calcular o IMT.

dwTextureIndex [in]

Tipo: DWORD

Índice de coordenadas de textura baseado em zero que identifica qual conjunto de coordenadas de textura usar.

uSignalDimension [in]

Tipo: UINT

O número de componentes em cada ponto de dados no sinal.

fMaxUVDistance [in]

Tipo: FLOAT

A distância máxima entre os vértices; o algoritmo continua subdividindo até que a distância entre todos os vértices seja menor ou igual a fMaxUVDistance.

dwOptions [in]

Tipo: DWORD

Opções de encapsulamento de textura. Essa é uma combinação de um ou mais SINALIZADORES D3DXIMT.

pSignalCallback [in]

Tipo: LPD3DXIMTSIGNALCALLBACK

Um ponteiro para uma função de avaliador fornecida pelo usuário, que será usada para calcular o valor do sinal em coordenadas U,V arbitrárias. A função segue o protótipo de LPD3DXIMTSIGNALCALLBACK.

pUserData [in]

Tipo: VOID*

Um ponteiro para um valor definido pelo usuário que é passado para a função de retorno de chamada de sinal. Normalmente usado por um aplicativo para passar um ponteiro para uma estrutura de dados que fornece informações de contexto para a função de retorno de chamada.

pStatusCallback

Tipo: LPD3DXUVATLASCB

Um ponteiro para uma função de retorno de chamada para monitorar o progresso da computação IMT.

pUserContext

Tipo: LPVOID

Um ponteiro para uma variável definida pelo usuário que é passada para a função de retorno de chamada status. Normalmente usado por um aplicativo para passar um ponteiro para uma estrutura de dados que fornece informações de contexto para a função de retorno de chamada.

ppIMTData [out]

Tipo: LPD3DXBUFFER*

Um ponteiro para o buffer (consulte ID3DXBuffer) que contém a matriz IMT retornada. Essa matriz pode ser fornecida como entrada para as funções UVAtlas D3DX para priorizar a alocação de espaço de textura na parametrização de textura.

Retornar valor

Tipo: HRESULT

Se a função for bem-sucedida, o valor retornado será D3D_OK; caso contrário, o valor será D3DERR_INVALIDCALL.

Comentários

Essa função requer que a malha de entrada contenha um mapeamento de textura de sinal para malha (ou seja, coordenadas de textura). Ele permite que o usuário defina um sinal arbitrariamente sobre a superfície da malha.

Requisitos

Requisito	Valor
parâmetro	D3DX9Mesh.h
Biblioteca	D3dx9.lib

Confira também

Funções UVAtlas

Usando UVAtlas (Direct3D 9)