IDirect3DCubeTexture9::AddDirtyRect メソッド
IDirect3DCubeTexture9::AddDirtyRect メソッド
キューブ テクスチャ リソースにダーティー領域を追加する。
構文
HRESULT AddDirtyRect(
D3DCUBEMAP_FACES FaceType,
CONST RECT *pDirtyRect
);
パラメータ
- FaceType
[in] D3DCUBEMAP_FACES 列挙型のメンバ。キューブ マップのサーフェイスを識別する。 - pDirtyRect
[in] RECT 構造体へのポインタ。ダーティー領域を指定する。NULL を指定すると、キューブ テクスチャ全体を覆うようにダーティー領域が拡大する。
戻り値
成功した場合は、D3D_OK を返す。
失敗した場合は、D3DERR_INVALIDCALL を返す。
注意
パフォーマンス上の理由から、ダーティー領域はテクスチャのレベル 0 についてのみ記録する。サブレベルについては、対応する (スケーリングされた) 矩形またはボックスもダーティーであるものと想定する。D3DLOCK_NO_DIRTY_UPDATE
または D3DLOCK_READONLY
を指定せずに IDirect3DCubeTexture9::LockRect または IDirect3DVolumeTexture9::LockBox を呼び出すと、ダーティー領域が自動的に記録される。また、IDirect3DDevice9::UpdateSurface の呼び出しにおける転送先サーフェイスは、ダーティーとしてマークされる。
参照
IDirect3DCubeTexture9::GetLevelDesc、IDirect3DCubeTexture9::LockRect、IDirect3DCubeTexture9::UnlockRect