Direct3DDevice7.Load
Direct3DDevice7.Load メソッドは、転送元テクスチャの矩形領域を、転送先テクスチャの指定された点、またはキューブ環境マップ内の面にロードする。
object.Load( _
DestTex As DirectDrawSurface7, _
xDest As Long, _
yDest As Long, _
SrcTex As DirectDrawSurface7, _
rcSrcRect As RECT, _
flags As Long)
パラメータ
- object
- Direct3DDevice7 オブジェクトを表すオブジェクト式。
- DestTex
- 転送元テクスチャからイメージ データを受け取る DirectDrawSurface7 クラス。キューブ環境マップやミップマップなどの複合テクスチャ サーフェスでは、最上位サーフェスでなければならない。
- xDest and yDest
- このメソッドによってイメージ データがロードされる転送先テクスチャ上の点の x 座標と y 座標。
- SrcTex
- ロードされるイメージ データを格納する DirectDrawSurface7 クラス。キューブ環境マップやミップマップなどの複合テクスチャ サーフェスでは、最上位サーフェスでなければならない。
- rcSrcRect
- このメソッドによってロードされる転送元テクスチャの領域を記述する RECT 型のアドレス。転送元の矩形が転送元テクスチャ全体をカバーする場合、またはこのメソッドを使って、管理下のテクスチャを明示的にロードする場合、このパラメータを Nothing に設定する。
- flags
- キューブ環境マップで、イメージ データを受け取る転送先テクスチャの面を示す値。このパラメータは、以下に示すフラグの任意の組み合わせで作られる。
- 0
- 転送先テクスチャが管理下のテクスチャの場合に必要。
- DDSCAPS2_CUBEMAP_ALLFACES
- 転送元テクスチャにあるイメージ デーがすべての面にロードされる。
- DDSCAPS2_CUBEMAP_NEGATIVEX, DDSCAPS2_CUBEMAP_NEGATIVEY、または DDSCAPS2_CUBEMAP_NEGATIVEZ
- 負の x、y、z 面がイメージ データを受け取る。
- DDSCAPS2_CUBEMAP_POSITIVEX, DDSCAPS2_CUBEMAP_POSITIVEY, or DDSCAPS2_CUBEMAP_POSITIVEZ
- 正の x、y、z 面がイメージ データを受け取る。
エラー コード
メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。
注意
転送先テクスチャは、そのテクスチャを作成したレンダリング デバイスだけでなく、任意のレンダリング デバイスで使用できる。ハードウェア デバイスでは、ロード処理はハードウェア アクセラレーションになる。
ビット処理の場合、このメソッドを呼び出してテクスチャをビデオ メモリにロードする方が望ましい。
このメソッドは、すべてのレベルのミップマップ、キューブ マップ面、パレットおよびカラー キーを転送元テクスチャから転送先テクスチャにコピーする。
このメソッドを使ってミップマップをロードする場合、以下の点に注意する。
- 転送先テクスチャ サーフェスを、転送元テクスチャに含まれるミップ レベルのサブセットにすることができる。この場合、両方のテクスチャに共通のミップ レベルだけがコピーされる。これは、テクスチャ LOD を実装する際に有効である。2 ミップ レベルだけのビデオ メモリ テクスチャを作成し、このメソッドを使って、すべてのミップ レベルで構成された転送元テクスチャからこれらのレベルをコピーすることができる。
- 転送元および転送先サーフェス ポインタは、最上位サーフェスを指さなければならない。
- ミップマップのサブ矩形をロードする場合、サブ矩形はミップマップ チェーンの最上位サーフェスに適用され、下位ミップ レベルごとに 2 つに分割される。