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 保存時に使用するファイル形式を指定します。 この関数では、ポータブル Pixmap (.ppm) と Targa/Truevision Graphics Adapter (.tga) を除 くすべてのD3DXIMAGE_FILEFORMAT 形式への保存がサポートされています。
-
pSrcTexture [in]
-
保存するテクスチャを含む IDirect3DBaseTexture9 インターフェイスへのポインター。
-
pSrcPalette [in]
-
型: const PALETTEENTRY*
256 色のパレットを含む PALETTEENTRY 構造体へのポインター。 このパラメーターは、NULL でもかまいません。
戻り値
種類: HRESULT
関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は次のようになります:D3DERR_INVALIDCALL
解説
コンパイラ設定によって、関数のバージョンも決定されます。 Unicode が定義されている場合、関数呼び出しは D3DXSaveTextureToFileW に解決されます。 それ以外の場合、ANSI 文字列が使用されているため、関数呼び出しは D3DXSaveTextureToFileA に解決されます。
この関数は、圧縮テクスチャ形式との間の変換を処理します。
ボリュームが非動的であり (作成時に使用パラメーターが 0 に設定されているため)、ビデオ メモリ (D3DPOOL_DEFAULTに設定されたメモリ プール) にある場合、D3DX はビデオ メモリ内にある非動的ボリュームをロックできないため、 D3DXSaveTextureToFile は失敗します。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|
関連項目