D3DXSaveVolumeToFile

  • [アーティクル]

ボリュームをディスクのファイルに保存します。

HRESULT 
D3DXSaveVolumeToFile(
  LPCTSTR pDestFile,
  D3DXIMAGE_FILEFORMAT DestFormat,
  LPDIRECT3DVOLUME9 pSrcVolume,
  CONST PALETTEENTRY * pSrcPalette,
  CONST D3DBOX * pSrcBox
);

パラメータ

  • pDestFile
    処理後のイメージのファイル名を指定する文字列へのポインターです。コンパイラーの設定で Unicode が必要な場合、データ型 LPCTSTR は LPCWSTR に解決されます。それ以外の場合、文字列データ型は LPCSTR に解決されます。「解説」を参照してください。
  • DestFormat
    保存時に使用されるファイル形式を指定する D3DXIMAGE_FILEFORMAT です。この関数は、すべての D3DXIMAGE_FILEFORMAT 形式への保存をサポートします。ただし、ポータブル ピクセルマップ (.ppm) および Targa/Truevision Graphics Adapter (.tga) についてはサポートしません。
  • pSrcVolume
    保存するイメージを含む IDirect3DVolume9 インターフェイスへのポインターです。
  • pSrcPalette
    256 色パレットを含む PALETTEENTRY 構造体へのポインターです。このパラメーターは NULL でもかまいません。
  • pSrcBox
    D3DBOX 構造体へのポインターです。転送元のボックスを指定します。ボリューム全体を指定する場合は、このパラメーターを NULL にします。

戻り値

成功すると、D3D_OK を返します。失敗した場合は、次の値を返します。D3DERR_INVALIDCALL

解説　

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

この関数は、圧縮されたテクスチャー フォーマット間の変換を処理します。

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

要件

ヘッダー: D3dx9tex.h 宣言

ライブラリ: D3dx9.lib 内容

関連項目

D3DXSaveSurfaceToFile, D3DXSaveTextureToFile, D3DXSaveVolumeToFileInMemory