IDirect3DVolumeTexture9::AddDirtyBox

  • [アーティクル]

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

HRESULT 
AddDirtyBox(
  CONST D3DBOX * pDirtyBox
);

パラメータ

  • pDirtyBox
    追加するダーティー領域を指定する D3DBOX 構造体へのポインター。NULL を指定すると、ボリューム テクスチャー全体を覆うダーティ領域となります。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、D3DERR_INVALIDCALL を返します。

解説　

パフォーマンス上の理由から、ダーティ領域はレベル ゼロのテクスチャーについてのみ記録されます。サブレベルの場合、対応する (スケーリングされた) ボックスもダーティであることを前提としています。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで IDirect3DVolumeTexture9::LockBox を呼び出した場合、ダーティ領域も自動的に記録されます。

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

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容