IDirect3DDevice9::ColorFill-Methode (d3d9helper.h)

  • Artikel

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

Weitere Informationen

D3DPOOL

IDirect3DDevice9