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

Метод IDirect3DDevice9::ColorFill (d3d9.h)

  • Статья

Позволяет приложению заполнять прямоугольную область поверхности D3DPOOL_DEFAULT указанным цветом.

Синтаксис

HRESULT ColorFill(
  [in] IDirect3DSurface9 *pSurface,
  [in] const RECT        *pRect,
  [in] D3DCOLOR          color
);

Параметры

[in] pSurface

Тип: IDirect3DSurface9*

Указатель на заполняемую поверхность.

[in] pRect

Тип: const RECT*

Указатель на исходный прямоугольник. Использование NULL означает, что вся поверхность будет заполнена.

[in] color

Тип: D3DCOLOR

Цвет, используемый для заполнения.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL.

Комментарии

Этот метод может применяться только к целевому объекту отрисовки, поверхности текстуры целевого объекта отрисовки или открытой поверхности вне экрана с типом пула D3DPOOL_DEFAULT.

IDirect3DDevice9::ColorFill будет работать со всеми форматами. Однако при использовании эталонного или программного устройства поддерживаются только D3DFMT_X1R5G5B5, D3DFMT_A1R5G5B5, D3DFMT_R5G6B5, D3DFMT_X8R8G8B8, D3DFMT_A8R8G8B8, D3DFMT_YUY2, D3DFMT_G8R8_G8B8, D3DFMT_UYVY, D3DFMT_R8G8_B8G8, D3DFMT_R16F, D3DFMT_G16R16F, D3DFMT_A16B16G16R16F, D3DFMT_R32F, D3DFMT_G32R32F и D3DFMT_A32B32G32R32F.

При использовании драйвера DirectX 7 или DirectX 8.x поддерживаются только форматы YUV D3DFMT_UYVY и D3DFMT_YUY2.

Требования

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

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

D3DPOOL

IDirect3DDevice9