Metodo IDirect3DDevice9::ColorFill (d3d9helper.h)
Consente a un'applicazione di riempire un'area rettangolare di una superficie D3DPOOL_DEFAULT con un colore specificato.
Sintassi
HRESULT ColorFill(
[in] IDirect3DSurface9 *pSurface,
[in] const RECT *pRect,
[in] D3DCOLOR color
);
Parametri
[in] pSurface
Tipo: IDirect3DSurface9*
Puntatore alla superficie da riempire.
[in] pRect
Tipo: const RECT*
Puntatore al rettangolo di origine. L'uso di NULL significa che l'intera superficie verrà riempita.
[in] color
Tipo: D3DCOLOR
Colore utilizzato per il riempimento.
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.
Commenti
Questo metodo può essere applicato solo a una destinazione di rendering, a una superficie di trama di destinazione di rendering o a una superficie fuori schermo con un tipo di pool di D3DPOOL_DEFAULT.
IDirect3DDevice9::ColorFill funzionerà con tutti i formati. Tuttavia, quando si usa un riferimento o un dispositivo software, gli unici formati supportati sono 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.
Quando si usa un driver DirectX 7 o DirectX 8.x, gli unici formati YUV supportati sono D3DFMT_UYVY e D3DFMT_YUY2.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | d3d9helper.h (include D3D9.h) |
| Libreria | D3D9.lib |