Microsoft DirectX 8.0 (C++)

IDirect3DCubeTexture8::AddDirtyRect

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

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

パラメータ

FaceType
[in] D3DCUBEMAP_FACES 列挙型のメンバ。キューブ マップのサーフェスを指定する。
pDirtyRect
[in] RECT 構造体へのポインタ。ダーティー領域を指定する。NULL を指定すると、キューブ テクスチャ全体を覆うようにダーティー領域が拡大する。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

パフォーマンスの理由によって、ダーティーな範囲はテクスチャのレベル ゼロに対して記録されるのみである。サブレベルについては、対応する (スケールされた) 矩形またはボックスもダーティーであると仮定される。D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLY なしで LockRectLockBox が呼び出されたとき、ダーティーな範囲は自動的に記録される。また CopyRects 呼び出しの宛先サーフェスはダーティーとしてマークされる。

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DCubeTexture8::GetLevelDescIDirect3DCubeTexture8::LockRectIDirect3DCubeTexture8::UnlockRect