Метод IDirect3DCubeTexture9::AddDirtyRect (d3d9helper.h)

Статья
08/23/2023

Добавляет грязное область в ресурс текстуры куба.

Синтаксис

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. С помощью этого метода приложения могут оптимизировать копируемый подмножество ресурса, указав грязное регионы в ресурсе. Однако грязное регионы могут быть расширены для оптимизации выравнивания.