Método IDirect3DDevice9::ColorFill (d3d9.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 | d3d9.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |