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 のみである。
参照