次の方法で共有


IDirect3DCubeTexture9::AddDirtyRect

ダーティ領域をキューブ テクスチャー リソースに追加します。

HRESULT 
AddDirtyRect(
  D3DCUBEMAP_FACES FaceType,
  CONST RECT * pDirtyRect
);

パラメータ

  • FaceType
    D3DCUBEMAP_FACES 列挙型のメンバー。キューブ マップの面を識別します。
  • pDirtyRect
    ダーティ領域を指定する RECT 構造体へのポインターです。NULL を指定すると、キューブ テクスチャー全体を覆うようにダーティ領域が拡大します。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合、次のいずれかを返します。D3DERR_INVALIDCALL

解説 

パフォーマンス上の理由から、ダーティ領域はレベル ゼロのテクスチャーについてのみ記録されます。サブレベルの場合、対応する (倍率設定された) 矩形またはボックスもダーティであることを前提としています。ダーティ領域は、D3DLOCK_NO_DIRTY_UPDATED3DLOCK_READONLY も指定しないで IDirect3DCubeTexture9::LockRect が呼び出されると、自動的に記録されます。IDirect3DDevice9::UpdateSurface の処理後のサーフェスも自動的にダーティとしてマークされます。

D3DLOCK_NO_DIRTY_UPDATE を使用し、ダーティ領域を明示的に指定することで、IDirect3DDevice9::UpdateTexture の効率を高めることもできます。このメソッドを使用することで、リソース上のダーティ領域を指定してコピーされるリソースのサブセットを最適化できます。ただし、ダーティ領域を展開してアライメントを最適化できます。

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

IDirect3DCubeTexture9::GetLevelDesc, IDirect3DCubeTexture9::LockRect, IDirect3DCubeTexture9::UnlockRect