Funzione D3DXCreatePRTCompBuffer

Articolo
06/13/2023

Crea un buffer PRT (Precomputed radiance Transfer) compresso da un oggetto ID3DXPRTBuffer non compresso. Questa funzione deve essere usata con buffer per vertice o volume.

Sintassi

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

Parametri

Qualità [in]

Tipo: D3DXSHCOMPRESSQUALITYTYPE

Qualità della compressione armonica sferica (SH). Vedere D3DXSHCOMPRESSQUALITYTYPE.

NumClusters [in]

Tipo: UINT

Numero di cluster da usare per la compressione.

NumPCA [in]

Tipo: UINT

Numero di vettori di base pca (Principal Component Analysis) da usare in ogni cluster.

pCB [in]

Tipo: LPD3DXSHPRTSIMCB

Puntatore facoltativo alla funzione di callback LPD3DXSHPRTSIMCB usata per calcolare la percentuale di calcoli di compressione PRT completati. La funzione di callback deve essere implementata per restituire S_OK per continuare a eseguire la routine di compressione. Qualsiasi altro valore interromperà la compressione. Può essere NULL.

lpUserContext [in]

Tipo: LPVOID

Puntatore facoltativo a un valore definito dall'utente passato alla funzione di callback LPD3DXSHPRTSIMCB . In genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce informazioni di contesto per la funzione di callback. Può essere NULL.

pBuffer [in]

Tipo: LPD3DXPRTBUFFER

Indirizzo di un puntatore all'oggetto ID3DXPRTBuffer non compresso che verrà compresso.

ppBuffer [in, out]

Tipo: LPD3DXPRTCOMPBUFFER*

Indirizzo di un puntatore all'oggetto ID3DXPRTCompBuffer di output.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL, E_OUTOFMEMORY.

Requisiti

Requisito	Valore
Intestazione	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni di trasferimento pre-calcolate
D3DXCreatePRTBuffer
D3DXCreatePRTBufferTex