IDirect3DCubeTexture9::AddDirtyRect メソッド (d3d9.h)

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

構文

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

パラメーター

[in] FaceType

種類: D3DCUBEMAP_FACES

キューブ マップの顔を識別する、 D3DCUBEMAP_FACES 列挙型のメンバー。

[in] pDirtyRect

型: const RECT*

ダーティ領域を指定する RECT 構造体へのポインター。 NULL を指定すると、キューブ テクスチャ全体をカバーするようにダーティ領域が展開されます。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は D3DERR_INVALIDCALL になります。

解説

パフォーマンス上の理由から、ダーティ領域はテクスチャのレベル 0 にのみ記録されます。 サブレベルの場合、対応する (拡大縮小された) 四角形またはボックスもダーティと見なされます。 ダーティリージョンは、 IDirect3DCubeTexture9::LockRect が D3DLOCK_NO_DIRTY_UPDATE または D3DLOCK_READONLYなしで呼び出されたときに自動的に記録されます。 IDirect3DDevice9::UpdateSurface の宛先サーフェスも自動的にダーティマークされます。

D3DLOCK_NO_DIRTY_UPDATEを使用し、ダーティ領域を明示的に指定すると、IDirect3DDevice9::UpdateTexture の効率を向上させることができます。 このメソッドを使用すると、アプリケーションはリソース上のリージョンダーティ指定することで、コピーされるリソースのサブセットを最適化できます。 ただし、配置を最適化するために、ダーティ領域を拡張できます。

要件

関連項目

IDirect3DCubeTexture9

IDirect3DCubeTexture9::GetLevelDesc

IDirect3DCubeTexture9::LockRect

IDirect3DCubeTexture9::UnlockRect