D3DX8.LoadVolumeFromMemory
メモリからボリュームをロードする。
object.LoadVolumeFromMemory( _
DestVolume As Direct3DVolume8, _
DestPalette As Any, _
DestBox As Any, _
SrcMemory As Any, _
SrcFormat As Long, _
SrcRowPitch As Long, _
SrcSlicePitch As Long, _
SrcPalette As Any, _
SrcBox As D3DBOX, _
Filter As Long, _
ColorKey As Long)
指定項目
- object
- D3DX8 オブジェクトを表すオブジェクト式。
- DestVolume
- Direct3DVolume8 オブジェクト。イメージを受け取る転送先のボリュームを指定する。
- DestPalette
- 転送先のパレットを表す 256 PALETTEENTRY 型の配列の最初の要素、または ByVal 0。「注意」を参照すること。
- DestBox
- D3DBOX 型。転送先のボックスを指定する。このパラメータを ByVal 0 に設定して、ボリューム全体を指定する。
- SrcMemory
- メモリ内にあるソース ボリュームの左上隅を指定する値。
- SrcFormat
- ソース ボリュームのピクセル フォーマットである、CONST_D3DFORMAT 列挙のメンバ。
- SrcRowPitch
- 転送元のイメージのピッチ (バイト単位)。DXT フォーマット (圧縮されたテクスチャ フォーマット) の場合、この数値はセルで構成される 1 つの行のサイズ (バイト単位) を表す。
- SrcSlicePitch
- 転送元のイメージのピッチ (バイト単位)。DXT フォーマット (圧縮されたテクスチャ フォーマット) の場合、この数値はセルで構成される 1 つのスライスのサイズ (バイト単位) を表す。
- SrcPalette
- 転送元のパレットを表す 256 PALETTEENTRY 型の配列の最初の要素、または ByVal 0。
- SrcBox
- D3DBOX 型。転送元のボックスを指定する。ByVal 0 はこのパラメータの有効な値ではない。
- Filter
- イメージをフィルタリングする方法を制御する、CONST_D3DXENUM 列挙で定義される 1 つ以上のフィルタ フラグの組み合わせ。このパラメータに D3DX_DEFAULT を指定することは、D3DX_FILTER_DITHER OR D3DX_FILTER_TRIANGLE を指定することと等しい。
- ColorKey
- 透明となる値。カラーキーを無効にする場合は 0 を指定する。ソース イメージのフォーマットとは関係なく、これは常に 32 ビットの ARGB カラーである。アルファが有意であり、通常はカラーキーを不透明にする場合は FF を指定する。したがって、不透明な黒の場合、値は &HFF000000 となる。
エラー コード
失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
注意
PALETTEENTRY の詳細については、Microsoft Platform Software Development Kit (SDK) を参照すること。Microsoft DirectX® 8.0 の時点で、PALETTEENTRY 構造体の peFlags メンバは、Platform SDK に説明されているようには機能しない。peFlags メンバは現在、8 ビットのパレット化されたフォーマット用のアルファ チャネルである。
非レベルゼロへの書き込みはアップデートすべきダーティーな矩形とはならない。D3DX8.LoadVolumeFromMemory が呼び出され、サーフェスが既にダーティーではなかった (これは通常の使用シナリオにはない) なら、アプリケーションは明示的にそのサーフェスに Direct3DTexture8.AddDirtyRect を呼び出す必要がある。