IDirect3DDevice9::ColorFill-Methode (d3d9helper.h)
Ermöglicht es einer Anwendung, einen rechteckigen Bereich einer D3DPOOL_DEFAULT Oberfläche mit einer angegebenen Farbe zu füllen.
Syntax
HRESULT ColorFill(
[in] IDirect3DSurface9 *pSurface,
[in] const RECT *pRect,
[in] D3DCOLOR color
);
Parameter
[in] pSurface
Typ: IDirect3DSurface9*
Zeiger auf die zu füllende Oberfläche.
[in] pRect
Typ: const RECT*
Zeiger auf das Quellrechteck. Die Verwendung von NULL bedeutet, dass die gesamte Oberfläche gefüllt wird.
[in] color
Typ: D3DCOLOR
Farbe, die zum Füllen verwendet wird.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.
Hinweise
Diese Methode kann nur auf ein Renderziel, eine Renderzieltexturoberfläche oder eine einfache Oberfläche außerhalb des Bildschirms mit einem Pooltyp von D3DPOOL_DEFAULT angewendet werden.
IDirect3DDevice9::ColorFill funktioniert mit allen Formaten. Bei Verwendung eines Referenz- oder Softwaregeräts werden jedoch nur 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 und D3DFMT_A32B32G32R32F unterstützt.
Bei Verwendung eines DirectX 7- oder DirectX 8.x-Treibers werden nur yuv-Formate unterstützt, D3DFMT_UYVY und D3DFMT_YUY2.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9helper.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |