D3DXSavePRTBufferToFile-Funktion

Speichert einen vorberechneten PRT-Puffer (Radiance Transfer) auf dem Datenträger.

Syntax

HRESULT D3DXSavePRTBufferToFile(
  _In_ LPCSTR          pFileName,
  _In_ LPD3DXPRTBUFFER pBuffer
);

Parameter

pFileName [in]

Typ: LPCSTR

Name der Datei, in der der Puffer gespeichert werden soll.

pBuffer [in]

Typ: LPD3DXPRTBUFFER

Adresse eines Zeigers auf das Id3DXPRTBuffer-Objekt .

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Bemerkungen

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSavePRTBufferToFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXSavePRTBufferToFileA aufgelöst.

Das PRT-Dateiformat ist eine Binärdatei in Form eines Headers und dann eines Datenblocks.

struct PRTHeader
{
    UINT NumSamples;
    UINT NumCoeffs;
    UINT NumChannels;
    UINT TexWidth;
    UINT TexHeight;
    UINT bIsTex;
};

Für den Fall, dass bIsTex ungleich 0 ist, sollte NumSamples gleich TexWidth * TexHeightsein.

Der Datenblock, der auf den Header folgt, ist NumSamples * NumCoeffs * NumChannels * sizeof(float) Bytes.

Anforderungen

Anforderung Wert
Header
D3DX9Mesh.h
Bibliothek
D3dx9.lib

Siehe auch

Vorberechnete Radianzübertragungsfunktionen