Microsoft DirectX 8.0 |
IAMTimecodeDisplay インターフェイスは、外部の SMPTE/MIDI タイムコード ディスプレイ デバイスの動作を定義するプロパティとメソッドを備えている。このインターフェイスは、IAMExtDevice、IAMExtTransport、およびその他のタイムコード インターフェイスと共に実装し、VCR などのように、タイムコード データを読み取り、生成、または表示できる外部デバイスを制御する。このインターフェイスでは、VCR または同様の外部デバイスに組み込まれている物理的なタイムコード キャラクタ ジェネレータの表示を制御する。
SMPTE タイムコードの詳細については、「SMPTE タイムコード」を参照すること。
外部のタイムコード リーダーまたはタイムコード ジェネレータにおけるタイムコード表示を制御する外部デバイス フィルタで、このインターフェイスを実装する。タイムコード リーダーまたはタイムコード ジェネレータは、VCR に組み込むことも、個別の外部デバイスとして扱うこともできる。外部デバイスがタイムコードを表示できない場合、または統合ハードウェアやオーバーレイ ハードウェアを持たない内蔵カードによってタイムコードが生成されている場合は、このインターフェイスを実装してはならない。
このインターフェイスは、Microsoft® DirectShow® フィルタ グラフ内でのレンダリングを目的とするものではない。純粋に外部デバイスの表示で使用するものである。
外部デバイスとタイムコード情報の表示方法をアプリケーションで制御する必要がある場合は、このインターフェイスを使用する。
ハードウェア要件については、「IAMExtTransport インターフェイス」を参照すること。
vtable 順のメソッド
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを取得する。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IAMTimecodeDisplay メソッド 説明 GetTCDisplayEnable 外部デバイスのタイムコード キャラクタ ジェネレータ出力が有効かどうかを判別する。 SetTCDisplayEnable 外部デバイスのタイムコード キャラクタ出力ジェネレータを有効または無効にする。 GetTCDisplay タイムコード キャラクタ ジェネレータ出力の現在の設定を取得する。 SetTCDisplay タイムコード キャラクタ ジェネレータ出力の特性を設定する。
タイムコード キャラクタ ジェネレータ出力の現在の設定を取得する。
構文
HRESULT GetTCDisplay(
long Param,
long *pValue
);
パラメータ
- Param
- [in] タイムコードの表示特性。設定を取得する元となる、次の項目のいずれかを指定する。
ED_TCD_BORDER 黒色の文字で白色の境界、または白色の文字で黒色の境界 ED_TCD_INTENSITY 文字の輝度 (明るさ) ED_TCD_INVERT 白色のバックグラウンドに黒色の文字、または黒色のバックグラウンドに白色の文字 ED_TCD_POSITION 文字の位置 ED_TCD_SIZE 文字のサイズ ED_TCD_SOURCE 表示するデータのソース ED_TCD_TRANSPARENCY 文字の透明度 - pValue
- [out] Param で指定されるパラメータの現在の設定値へのポインタ。このパラメータは、次のいずれかの値を取得する。
ED_TCD_SOURCE が Param に指定されている場合は、次のいずれかが返される。
ED_TCG タイムコード ジェネレータ ED_TCR タイムコード リーダー ED_TCD_SIZE が Param に指定されている場合は、次のいずれかが返される。
ED_LARGE 大 ED_MED 中 ED_SMALL 小 ED_TCD_POSITION が Param に指定されている場合は、次のいずれかが返される。
ED_BOTTOM 下 ED_MIDDLE 中 ED_TOP 上 上の値と、次のいずれかが組み合わされて返される。
ED_CENTER 中央 ED_LEFT 左 ED_RIGHT 右 ED_TCD_INTENSITY が Param に指定されている場合は、次のいずれかが返される。
ED_HIGH 高 ED_LOW 低 ED_TCD_TRANSPARENCY が Param に指定されている場合は、0 から 4 の範囲の値が返される。0 は完全に不透明なことを表す。
ED_TCD_INVERT が Param に指定されている場合は、次のいずれかが返される。
OAFALSE 白色のバックグラウンドに黒色の文字 OATRUE 黒色のバックグラウンドに白色の文字 ED_TCD_BORDER が Param に指定されている場合は、次のいずれかが返される。
OAFALSE 黒色の文字で白色の境界 OATRUE 白色の文字で黒色の境界
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。
参照
外部デバイスのタイムコード キャラクタ ジェネレータ出力が有効かどうかを判別する。
構文
HRESULT GetTCDisplayEnable(
long *pState
);
パラメータ
- pState
- [out] タイムコード キャラクタ ジェネレータ出力が有効かどうかを示す値へのポインタ。OATRUE は有効であることを表し、OAFALSE は無効であることを表す。
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。
注意
このメソッドは、フィルタ グラフ内でのキャラクタ レンダリングを目的とするものではなく、純粋にハードウェアの表示を目的とするものである。このメソッドを使用する前に、外部のタイムコード リーダーまたはタイムコード ジェネレータが表示機能を備えていることを確認する必要がある。
参照
タイムコード キャラクタ ジェネレータ出力の特性を設定する。
構文
HRESULT SetTCDisplay(
long Param,
long Value
);
パラメータ
- Param
- [in] タイムコードの表示特性。値を設定する次のいずれかのプロパティを指定する。
ED_TCD_BORDER 黒色の文字で白色の境界、または白色の文字で黒色の境界 ED_TCD_INTENSITY 文字の輝度 (明るさ) ED_TCD_INVERT 白色のバックグラウンドに黒色の文字、または黒色のバックグラウンドに白色の文字 ED_TCD_POSITION 文字の位置 ED_TCD_SIZE 文字のサイズ ED_TCD_SOURCE 表示するデータのソース ED_TCD_TRANSPARENCY 文字の透明度 - Value
- [in] Param で指定されるパラメータの設定値。次のいずれかを指定する必要がある。
ED_TCD_SOURCE が Param に指定されている場合は、次のいずれかを設定する。
ED_TCG タイムコード ジェネレータ ED_TCR タイムコード リーダー ED_TCD_SIZE が Param に指定されている場合は、次のいずれかを設定する。
ED_LARGE 大 ED_MED 中 ED_SMALL 小 ED_TCD_POSITION が Param に指定されている場合は、次のいずれかを設定する。
ED_BOTTOM 下 ED_MIDDLE 中 ED_TOP 上 上の値と、次のいずれかを組み合わせて指定する。
ED_CENTER 中央 ED_LEFT 左 ED_RIGHT 右 ED_TCD_INTENSITY が Param に指定されている場合は、次のいずれかを設定する。
ED_HIGH 高 ED_LOW 低 ED_TCD_TRANSPARENCY が Param に指定されている場合は、0 から 4 の範囲の値を設定する。0 は完全に不透明で、4 は可能な限り暗い。
ED_TCD_INVERT が Param に指定されている場合は、次のいずれかを設定する。
OAFALSE 白色の上に黒色 OATRUE 黒色の上に白色 ED_TCD_BORDER が Param に指定されている場合は、次のいずれかを設定する。
OAFALSE 黒色の文字で白色の境界 OATRUE 白色の文字で黒色の境界
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。
参照
外部デバイスのタイムコード キャラクタ出力ジェネレータを有効または無効にする。
構文
HRESULT SetTCDisplayEnable(
long State
);
パラメータ
- State
- [in] タイムコード キャラクタ出力ジェネレータを有効または無効にする値。OATRUE を指定すると有効になり、OAFALSE を指定すると無効になる。
戻り値
インターフェイスの実装に応じた HRESULT 値を返す。
注意
このメソッドは、フィルタ グラフ内でのキャラクタ レンダリングを目的とするものではなく、純粋にハードウェアの表示を目的とするものである。このメソッドを使用する前に、外部のタイムコード リーダーまたはタイムコード ジェネレータが表示機能を備えていることを確認する必要がある。
参照