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