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