Platform SDK: DirectX

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 に次のいずれかのエラー コードが設定される。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

注意

転送先テクスチャは、そのテクスチャを作成したレンダリング デバイスだけでなく、任意のレンダリング デバイスで使用できる。ハードウェア デバイスでは、ロード処理はハードウェア アクセラレーションになる。

ビット処理の場合、このメソッドを呼び出してテクスチャをビデオ メモリにロードする方が望ましい。

このメソッドは、すべてのレベルのミップマップ、キューブ マップ面、パレットおよびカラー キーを転送元テクスチャから転送先テクスチャにコピーする。

このメソッドを使ってミップマップをロードする場合、以下の点に注意する。