Compartir a través de

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

  • Artículo

Permite a una aplicación rellenar un área rectangular de una superficie D3DPOOL_DEFAULT con un color especificado.

Sintaxis

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

Parámetros

[in] pSurface

Tipo: IDirect3DSurface9*

Puntero a la superficie que se va a rellenar.

[in] pRect

Tipo: const RECT*

Puntero al rectángulo de origen. El uso de NULL significa que se rellenará toda la superficie.

[in] color

Tipo: D3DCOLOR

Color usado para rellenar.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Este método solo se puede aplicar a un destino de representación, a una superficie de textura de destino de representación o a una superficie sin formato fuera de pantalla con un tipo de grupo de D3DPOOL_DEFAULT.

IDirect3DDevice9::ColorFill funcionará con todos los formatos. Sin embargo, al usar un dispositivo de referencia o software, los únicos formatos admitidos son 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 y D3DFMT_A32B32G32R32F.

Cuando se usa un controlador DirectX 7 o DirectX 8.x, los únicos formatos YUV admitidos son D3DFMT_UYVY y D3DFMT_YUY2.

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

D3DPOOL

IDirect3DDevice9