Microsoft DirectX 8.0 (Visual Basic) |
ビューポートまたはビューポート内の矩形セットを指定された RGBA 色にクリアし、深度バッファをクリアし、ステンシル バッファを削除する。
object.Clear( _ Count As Long, _ ClearD3DRect As Any, Flags As CONST_D3DCLEARFLAGS, _ Color As Long, _ Z As Single, _ Stencil As Long)
失敗した場合はエラーが発生し、Err.Number に D3DERR_INVALIDCALL が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
レンダリング ターゲットに深度バッファがアタッチされていないときに D3DCLEAR_ZBUFFER フラグまたは D3DCLEAR_STENCIL フラグを指定すると、このメソッドは失敗する。同様に、深度バッファ フォーマットにステンシル バッファ情報が含まれていない場合に D3DCLEAR_STENCIL フラグを指定すると、このメソッドは失敗する。
以下に示すコードは、Clear をデフォルトの指定で呼び出す方法である。
Dim Device As Direct3DDevice8 ' Flags、Color、Z、および Stencil には ' 有効な値が設定されていると仮定する。 Device.Clear 0, ByVal 0, Flags, Color, Z, Stencil
次のコードは、クリアする矩形の配列を指定して Clear を呼び出す方法を示している。
Dim clearD3dRects(10) device.Clear 10, clearD3dRects(0), Flags, Color, Z, Stencil
クリアする矩形の配列の先頭要素だけを渡すことに注意すること。