Поделиться через


Метод 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.

Комментарии

Из соображений производительности грязное области записываются только для нулевого уровня текстуры. Для вложенных уровней предполагается, что соответствующий (масштабируемый) прямоугольник или прямоугольник также грязное. Грязные области автоматически записываются при вызове IDirect3DCubeTexture9::LockRect без D3DLOCK_NO_DIRTY_UPDATE или D3DLOCK_READONLY. Область назначения IDirect3DDevice9::UpdateSurface также помечается грязное автоматически.

Использование D3DLOCK_NO_DIRTY_UPDATE и явное указание грязное регионов можно использовать для повышения эффективности IDirect3Device9::UpdateTexture. С помощью этого метода приложения могут оптимизировать копируемый подмножество ресурса, указав грязное регионов в ресурсе. Однако грязное регионы можно расширить для оптимизации выравнивания.

Требования

   
Целевая платформа Windows
Header d3d9.h (включая D3D9.h)
Библиотека D3D9.lib

См. также раздел

IDirect3DCubeTexture9

IDirect3DCubeTexture9::GetLevelDesc

IDirect3DCubeTexture9::LockRect

IDirect3DCubeTexture9::UnlockRect