OverlayBitmap

OverlayBitmap オブジェクトはビデオストリーム上に線やテキストのようなグラフィック要素を描画するのに使用されます。
イメージストリーム上においてオーバーレイの挿入が可能な場所には以下の3か所がございます。

内部的に、OverlayBitmap オブジェクトはビデオストリームへのテキスト、グラフィック要素の描画にビットマップ(HBITMAP) を使用します。そのサイズと色深度は選択中のデバイスのビデオフォーマットやデバイスとの間に設置されたフレームフィルタによって変わります。よって内部のビットマップは以下のような場合に破棄されることになります。

  • デバイスのビデオフォーマットが変更された場合
  • オーバーレイの前のどこかで色空間の変更が必要になりシンクのビデオフォーマットが変更された 場合
  • デバイスとオーバーレイの間にフレームフィルタが挿入された、もしくは取り除かれた場合
  • デバイスとオーバーレイの間に挿入されたフレームフィルタのパラメータのうち、 イメージストリームのビデオフォーマットに影響するものが変更された場合

オーバーレイのカラーフォーマットはイメージストリーム上でその前後に位置するオブジェクトによって決定します。
また、カラーフォーマットはOverlayBitmap::setColorModeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setColorMode MethodへのコールでモノクロもしくはRGBにすることが可能です。

以下に挙げるの2つのケースではOverlayBitmapオブジェクトの機能は利用できなくなりメソッドOverlayBitmap::canRenderクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setColorMode Methodがfalseを返します。

  • シンクのカラーフォーマットがYUVに設定されている場合
  • オーバーレイの後ろに挿入されているフィルタが入力フォーマットとしてYUVを要求する場合

OverlayBitmapオブジェクトのインスタンスへのポインタはへのコールによって取得することができます。
Grabber::getOverlayクラスライブラリリファレンス＞クラス＞OverlayBitmap＞Grabber::getOverlay Method

インフォメーション

ヘッダファイル: tisudshl
ネームスペース: DShowLib

IC Imaging Control 1.xより導入

メソッド

メソッド 説明
beginPaintクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::beginPaint Method グラフィック描画のためのオーバーレイビットマップの準備を行います。
canRenderクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::canRender Method フレームワークがビデオストリームへのオーバーレイの描画を行えるかどうかを返します。
drawFrameEllipseクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawFrameEllipse Method ライブ画像上に楕円の枠を描画します。
drawFrameRectクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawFrameRect Method ライブ画像上に長方形の枠を描画します。
drawLineクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawLine Method ライブ画像上に線を描画します。
drawSolidEllipseクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawSolidEllipse Method ライブ画像上に楕円を描画します。
drawSolidRectクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawSolidRect Method ライブ画像上に長方形を描画します。
drawTextクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::drawText Method ライブ画像上にテキストを描画します。
endPaintクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::endPaint Method デバイスコンテキストからオーバーレイを解放します。
fillクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::fill Method オーバーレイを特定の色で塗りつぶします。
getColorModeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getColorMode Method OverlayBitmapで選択されたカラーモードを返します。
getColorformatクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getColorformat Method オーバーレイに使用されているカラーフォーマットを返します。
getDCクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getDC Method デバイスコンテキストを返します。
getDropOutColorクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getDropOutColor Method 現在しているドロップアウトカラーを返します。
getEnableクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getEnable Method ライブ画像上にオーバーレイを表示させるかどうかを返します。
getFlipVerticalクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getFlipVertical Method オーバーレイを垂直反転させて表示させるかどうかを返します。
getFontクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getFont Method IFont COM フォントオブジェクトポインタへのポインタを取得します。
getFontBKColorクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getFontBKColor Method テキスト描画の際の背景色を返します。
getFontTransparentクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getFontTransparent Method テキスト描画の際の背景モードを返します。
getFrameTypeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getFrameType Method OverlayBitmapの現在のフォーマットを表すFrameTypeInfoクラスライブラリリファレンス＞クラス＞FrameTypeInfoオブジェクトを返します。
getHeightクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getHeight Method OverlayBitmapの高さを返します。
getPathPositionクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getPathPosition Method OverlayBitmapのパスを返します。
getWidthクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::getWidth Method OverlayBitmapの幅を返します。
setColorModeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setColorMode Method OverlayBitmapのカラーモードを設定します。カラーモードはオーバーレイをカラーもしくはグレースケールで描画するかを決定します。デバイスから送られてきたイメージはオーバーレイの描画前に選択されたフォーマットに変換されます。
setDropOutColorクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setDropOutColor Method ドロップアウトカラーを設定します。
setEnableクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setEnable Method ライブ画像上でのオーバーレイ表示の有効/無効化を行います。
setFlipVerticalクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setFlipVertical Method オーバーレイの垂直反転の有効/無効化を行います。
setFontクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setFont Method OverlayBitmapオブジェクトのフォントを設定します。
setFontBKColorクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setFontBKColor Method テキスト描画の際の背景色を設定します。デバイスが指定の色を表示できない場合はそれに最も近い色を設定します。
setFontTransparentクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setFontTransparent Method テキスト描画の際の背景モードを設定します。

エニュメレーション

エニュメレーション 説明
tOVBColorModeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::tOVBColorMode このエニュメレーションのメンバはsetColorModeクラスライブラリリファレンス＞クラス＞OverlayBitmap＞OverlayBitmap::setColorMode Methodを使ってOverlayBitmapのカラーフォーマットを設定するのに使用されます。