Compartilhar via


Método IDirect3DDevice9::ColorFill (d3d9helper.h)

Permite que um aplicativo preencha uma área retangular de uma superfície D3DPOOL_DEFAULT com uma cor especificada.

Sintaxe

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

Parâmetros

[in] pSurface

Tipo: IDirect3DSurface9*

Ponteiro para a superfície a ser preenchida.

[in] pRect

Tipo: const RECT*

Ponteiro para o retângulo de origem. Usar NULL significa que toda a superfície será preenchida.

[in] color

Tipo: D3DCOLOR

Cor usada para preenchimento.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Esse método só pode ser aplicado a um destino de renderização, a uma superfície de textura de destino de renderização ou a uma superfície simples fora da tela com um tipo de pool de D3DPOOL_DEFAULT.

IDirect3DDevice9::ColorFill funcionará com todos os formatos. No entanto, ao usar um dispositivo de referência ou software, os únicos formatos com suporte são 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 e D3DFMT_A32B32G32R32F.

Ao usar um driver DirectX 7 ou DirectX 8.x, os únicos formatos YUV com suporte são D3DFMT_UYVY e D3DFMT_YUY2.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

D3DPOOL

IDirect3DDevice9