IDirect3DDevice9::ColorFill メソッド

  • [アーティクル]

IDirect3DDevice9::ColorFill メソッド

このメソッドを利用して、アプリケーションは D3DPOOL_DEFAULT サーフェイスの矩形領域を指定した色で塗りつぶすことができる。

構文

HRESULT ColorFill(      
    IDirect3DSurface9 *pSurface,
    CONST RECT *pRect,
    D3DCOLOR color
);

パラメータ

  • pSurface
    [in] 塗りつぶすサーフェイスへのポインタ。
  • pRect
    [in] 転送元矩形へのポインタ。NULLを使用すると、サーフェイス全体が塗りつぶされる。
  • color
    [in] 塗りつぶしに使用する色。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合の戻り値は次のとおり。

D3DERR_INVALIDCALL メソッドの呼び出しが無効である。たとえば、メソッドのパラメータに無効な値が設定されている場合などである。

注意

このメソッドは、プール タイプが D3DPOOL_DEFAULT であるレンダリング ターゲット、レンダリング ターゲットのテクスチャ サーフェイス、およびオフスクリーンの平面サーフェイスにのみ適用できる。

IDirect3DDevice9::ColorFill はどのフォーマットでも使える。ただし、参照デバイスまたはソフトウェア デバイスを使っている場合は、サポートされるフォーマットは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、および D3DFMT_A32B32G32R32F のみである。

Microsoft® DirectX® 7.0 または DirectX 8.x ドライバを使う場合、サポートされる YUV フォーマットは、D3DFMT_UYVY と D3DFMT_YUY2 のみである。

参照

D3DPOOL