Fonction D3DXCreatePRTCompBuffer

Article
06/13/2023

Crée une mémoire tampon de transfert de rayonnement précalculée (PRT) compressée à partir d’un objet ID3DXPRTBuffer non compressé. Cette fonction doit être utilisée avec des mémoires tampons par vertex ou de volume.

Syntaxe

HRESULT D3DXCreatePRTCompBuffer(
  _In_    D3DXSHCOMPRESSQUALITYTYPE Quality,
  _In_    UINT                      NumClusters,
  _In_    UINT                      NumPCA,
  _In_    LPD3DXSHPRTSIMCB          pCB,
  _In_    LPVOID                    lpUserContext,
  _In_    LPD3DXPRTBUFFER           pBuffer,
  _Inout_ LPD3DXPRTCOMPBUFFER       *ppBuffer
);

Paramètres

Qualité [in]

Type : D3DXSHCOMPRESSQUALITYTYPE

Qualité de la compression harmonique sphérique (SH). Consultez D3DXSHCOMPRESSQUALITYTYPE.

NumClusters [in]

Type : UINT

Nombre de clusters à utiliser pour la compression.

NumPCA [in]

Type : UINT

Nombre de vecteurs de base de l’analyse des composants principaux (PCA) à utiliser dans chaque cluster.

pCB [in]

Type : LPD3DXSHPRTSIMCB

Pointeur facultatif vers la fonction de rappel LPD3DXSHPRTSIMCB utilisée pour calculer le pourcentage de calculs de compression PRT terminés. La fonction de rappel doit être implémentée pour retourner S_OK afin de continuer à exécuter la routine de compression. Toute autre valeur arrête la compression. Peut être NULL.

lpUserContext [in]

Type : LPVOID

Pointeur facultatif vers une valeur définie par l’utilisateur passée à la fonction de rappel LPD3DXSHPRTSIMCB . Généralement utilisé par une application pour passer un pointeur vers une structure de données qui fournit des informations de contexte pour la fonction de rappel. Peut être NULL.

pBuffer [in]

Type : LPD3DXPRTBUFFER

Adresse d’un pointeur vers l’objet ID3DXPRTBuffer non compressé qui sera compressé.

ppBuffer [in, out]

Type : LPD3DXPRTCOMPBUFFER*

Adresse d’un pointeur vers l’objet ID3DXPRTCompBuffer de sortie.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Spécifications

Condition requise	Valeur
En-tête	D3DX9Mesh.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions de transfert de radiance précalculées
D3DXCreatePRTBuffer
D3DXCreatePRTBufferTex