D3DXSaveTextureToFile 関数

テクスチャをファイルに保存します。

構文

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

パラメーター

pDestFile [in]

型: LPCTSTR

コピー先イメージのファイル名を指定する文字列へのポインター。 コンパイラ設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。 それ以外の場合、文字列データ型は LPCSTR に解決されます。 「解説」を参照してください。

DestFormat [in]

型: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT 保存時に使用するファイル形式を指定します。 この関数は、ポータブル Pixmap (.ppm) と Targa/Truevision グラフィックス アダプター (.tga) を除くすべての D3DXIMAGE_FILEFORMAT 形式への保存をサポートします。

pSrcTexture [in]

型: LPDIRECT3DBASETEXTURE9

保存するテクスチャを含む IDirect3DBaseTexture9 インターフェイスへのポインター。

pSrcPalette [in]

型: const PALETTEENTRY*

256 色のパレットを含む PALETTEENTRY 構造体へのポインター。 このパラメーターは、NULL でもかまいません。

戻り値

型: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は次のようになります:D3DERR_INVALIDCALL

解説

コンパイラ設定によって、関数のバージョンも決定されます。 Unicode が定義されている場合、関数呼び出しは D3DXSaveTextureToFileW に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXSaveTextureToFileA に解決されます。

この関数は、圧縮されたテクスチャ形式との間の変換を処理します。

ボリュームが非動的で (作成時に使用パラメーターが 0 に設定されているため)、ビデオ メモリ (D3DPOOL_DEFAULTに設定されたメモリ プール) にある場合、D3DX はビデオ メモリ内にある非動的ボリュームをロックできないため、 D3DXSaveTextureToFile は失敗します。

必要条件

要件
ヘッダー
D3dx9tex.h
ライブラリ
D3dx9.lib

関連項目

D3DX 9 のテクスチャ関数

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile