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

Permet à une application de remplir une zone rectangulaire d’une surface D3DPOOL_DEFAULT avec une couleur spécifiée.

Syntaxe

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

Paramètres

[in] pSurface

Type : IDirect3DSurface9*

Pointeur vers la surface à remplir.

[in] pRect

Type : const RECT*

Pointeur vers le rectangle source. L’utilisation de null signifie que la surface entière sera remplie.

[in] color

Type : D3DCOLOR

Couleur utilisée pour le remplissage.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Notes

Cette méthode ne peut être appliquée qu’à une cible de rendu, à une surface de texture cible de rendu ou à une surface ordinaire hors écran avec un type de pool de D3DPOOL_DEFAULT.

IDirect3DDevice9::ColorFill fonctionne avec tous les formats. Toutefois, lorsque vous utilisez une référence ou un périphérique logiciel, les seuls formats pris en charge sont 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 et D3DFMT_A32B32G32R32F.

Lorsque vous utilisez un pilote DirectX 7 ou DirectX 8.x, les seuls formats YUV pris en charge sont D3DFMT_UYVY et D3DFMT_YUY2.

Spécifications

Voir aussi

D3DPOOL

IDirect3DDevice9