Función D3DXComputeIMTFromSignal
Calcula el IMT por triángulo a partir de una señal personalizada especificada por la aplicación que varía sobre la superficie de la malla (generalmente con una frecuencia mayor que los datos de vértices). La señal se evalúa a través de una función de devolución de llamada especificada por el usuario.
Sintaxis
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
Puntero a una malla de entrada (vea ID3DXMesh) que contiene la geometría del objeto para calcular el IMT.
-
dwTextureIndex [in]
-
Tipo: DWORD
Índice de coordenadas de textura de base cero que identifica qué conjunto de coordenadas de textura se van a usar.
-
uSignalDimension [in]
-
Tipo: UINT
Número de componentes de cada punto de datos de la señal.
-
fMaxUVDistance [in]
-
Tipo: FLOAT
Distancia máxima entre vértices; el algoritmo continúa subdividiendo hasta que la distancia entre todos los vértices es menor o igual que fMaxUVDistance.
-
dwOptions [in]
-
Tipo: DWORD
Opciones de ajuste de textura. Se trata de una combinación de uno o varios D3DXIMT FLAGS.
-
pSignalCallback [in]
-
Tipo: LPD3DXIMTSIGNALCALLBACK
Puntero a una función de evaluador proporcionada por el usuario, que se usará para calcular el valor de señal en coordenadas U,V arbitrarias. La función sigue el prototipo de LPD3DXIMTSIGNALCALLBACK.
-
pUserData [in]
-
Tipo: VOID*
Puntero a un valor definido por el usuario que se pasa a la función de devolución de llamada de señal. Normalmente, una aplicación usa para pasar un puntero a una estructura de datos que proporciona información de contexto para la función de devolución de llamada.
-
pStatusCallback
-
Tipo: LPD3DXUVATLASCB
Puntero a una función de devolución de llamada para supervisar el progreso del cálculo de IMT.
-
pUserContext
-
Tipo: LPVOID
Puntero a una variable definida por el usuario que se pasa a la función de devolución de llamada de estado. Normalmente, una aplicación usa para pasar un puntero a una estructura de datos que proporciona información de contexto para la función de devolución de llamada.
-
ppIMTData [out]
-
Tipo: LPD3DXBUFFER*
Puntero al búfer (vea ID3DXBuffer) que contiene la matriz IMT devuelta. Esta matriz se puede proporcionar como entrada a las funciones UVAtlas D3DX para priorizar la asignación de espacio de textura en la parametrización de textura.
Valor devuelto
Tipo: HRESULT
Si la función se realiza correctamente, el valor devuelto es D3D_OK; de lo contrario, el valor es D3DERR_INVALIDCALL.
Comentarios
Esta función requiere que la malla de entrada contenga una asignación de textura de señal a malla (es decir, coordenadas de textura). Permite al usuario definir una señal arbitrariamente sobre la superficie de la malla.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también