D3DXLoadVolumeFromResource 関数
リソースからボリュームを読み込みます。
構文
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
パラメーター
-
pDestVolume [in]
-
IDirect3DVolume9 インターフェイスへのポインター。 宛先ボリュームを指定します。
-
pDestPalette [in]
-
型: const PALETTEENTRY*
PALETTEENTRY 構造体 (256 色または NULL のコピー先パレット) へのポインター。
-
pDestBox [in]
-
型: const D3DBOX*
D3DBOX 構造体へのポインター。 コピー先のボックスを指定します。 ボリューム全体を指定するには、このパラメーターを NULL に設定します。
-
hSrcModule [in]
-
種類: HMODULE
リソースが配置されているモジュールへのハンドル、または現在のプロセスの作成に使用されるオペレーティング システムのイメージに関連付けられているモジュールの 場合は NULL 。
-
pSrcResource [in]
-
種類: LPCSTR
ソース イメージのファイル名を指定する文字列へのポインター。 UNICODE または_UNICODEが定義されている場合、このパラメーター型は LPCWSTR、それ以外の場合は LPCSTR です。
-
pSrcBox [in]
-
型: const D3DBOX*
D3DBOX 構造体へのポインター。 ソース ボックスを指定します。 ボリューム全体を指定するには、このパラメーターを NULL に設定します。
-
フィルター [入力]
-
型: DWORD
1 つ以上の D3DX_FILTERの組み合わせで、イメージのフィルター処理方法を制御します。 このパラメーターにD3DX_DEFAULTを指定することは、D3DX_FILTER_TRIANGLE |D3DX_FILTER_DITHER。
-
ColorKey [in]
-
種類: D3DCOLOR
透明な黒に置き換える D3DCOLOR 値、またはカラーキーを無効にする場合は 0。 これは、ソース イメージ形式とは無関係に、常に 32 ビットの ARGB 色です。 アルファは重要であり、通常、不透明な色キーの場合は FF に設定する必要があります。 したがって、不透明な黒の場合、値は0xFF000000と等しくなります。
-
pSrcInfo [in]
-
種類: D3DXIMAGE_INFO*
ソース イメージ ファイル内のデータの説明が入力される D3DXIMAGE_INFO 構造体へのポインター( NULL)。
戻り値
型: HRESULT
関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値には次のいずれかの値を指定できます:D3DERR_INVALIDCALL、D3DXERR_INVALIDDATA。
解説
読み込まれるリソースは、ビットマップ リソース (RT_BITMAP) である必要があります。
この関数は、圧縮テクスチャ形式との間の変換を処理します。
ボリューム テクスチャのレベル 0 以外のサーフェスに書き込んだ場合、ダーティ四角形は更新されません。 D3DXLoadVolumeFromFile が呼び出され、テクスチャがまだダーティされていない場合 (通常の使用シナリオではそうはいかない)、アプリケーションはボリューム テクスチャで IDirect3DVolumeTexture9::AddDirtyBox を明示的に呼び出す必要があります。
この関数は、Unicode 文字列と ANSI 文字列の両方をサポートしています。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|
関連項目