setvideo コマンド

  • [アーティクル]

setvideo コマンドは、ビデオの再生とキャプチャに関連付けられている値を設定します。 デジタル ビデオおよび VCR デバイスはこのコマンドを認識します。

このコマンドを送信するには、lpszCommand パラメーターを次のように設定して mciSendString 関数を呼び出します。

_stprintf_s(
  lpszCommand, 
  TEXT("setvideo %s %s %s"), 
  lpszDeviceID, 
  lpszVideo, 
  lpszFlags
);

パラメーター

lpszDeviceID

MCI デバイスの識別子。 この識別子またはエイリアスは、デバイスを開いたときに割り当てられます。

lpszVideo

ビデオの再生とキャプチャのフラグを設定します。 次の表に、 setvideo コマンドを認識するデバイスの種類と、各種類で使用されるフラグを示します。

値 説明 説明
digitalvideo アルゴリズム アルゴリズムbitsperpel を使用して明るさをカウントして clocktimecolor を係数化し、値に対するガンマ因子のコントラストを halftoneinputkey 色から r:g:bキー インデックスから offonoutput のインデックスに因数化する インデックスを基準にした期間パレットの色を newrgb パレット ハンドルに渡して、品質記述子レコードのフレーム レートを処理して、ソースからソース番号への係数を引き続きアルゴリズム アルゴリズムに基づいてオフシャープネスでレコードオフシャープネスをレートする
ビデオデッキ オフレコード トラックの番号レコードを入力する offonmonitor track_numberオフ レコードオンレコードトラックtrack_numberオフトラックtrack_numbertrack_number番号トラックを入力するオンソース

次の表に、 lpszVideo パラメーターで指定できるフラグとその意味を示します。

値 説明
アルゴリズム アルゴリズム 後続の 予約 コマンドまたは レコード コマンドで使用するビデオ圧縮アルゴリズムを指定します。 デバイスでサポートされるアルゴリズムは、デバイス固有です。 MCI は 、アルゴリズムの定数 "mpeg" と "h261" を定義します。指定したアルゴリズムが現在のファイル形式と競合する場合、ファイル形式はアルゴリズムの既定の形式に変更されます。
カウントする bitsperpel capture または record コマンドを使用してデータを保存するための 1 ピクセルあたりのビット数を設定します。
要因に明るさ ビデオの明るさレベルを設定します。
clocktime "over" フラグで指定された時間がミリ秒単位であることを示します。 時間は絶対であり、ワークスペースの再生に伴うステップではありません。
要素に色を設定する 彩度レベルを設定します。
要因に対するコントラスト ビデオ コントラスト レベルを設定します。
値 へのガンマ ガンマ補正指数に 1000 を乗算して指定します。 たとえば、指数部 2.2 を指定するには、値に 2200 を使用 します。 1.0 (1000) のガンマ値は、ガンマ補正が適用されていないことを示します。 ガンマ補正は、プレゼンテーション ソースでエンコードされた強度と表示される明るさのマッピングを調整します。
ハーフトーン 既定のパレットの代わりにハーフトーン パレットを使用します。 このフラグは、MCIAVI デジタル ビデオ ドライバーによってのみ認識されます。
input "明るさ"、"色"、"コントラスト"、"ガンマ"、"シャープネス"、または "濃淡" フラグを変更して、入力信号に影響を与え、記録される内容を変更します。 可能であれば、入力を監視する場合の既定値です。
r:g:b に対するキーの色 キーの色を設定します。 r:g:b 変数は RGB 値です。 コロン (:)個々の赤、緑、青の値を区切ります。
インデックスへのキー インデックス キー インデックスを設定します。 index 変数は、物理パレット インデックスです。
番号を入力するモニター 録音ソース入力の選択を変更せずに、VCR 出力に渡すソース入力を制御します。 型には、"output" または有効な入力ソースのいずれかを指定できます。 "number" が指定されていない場合は、その型の最初の入力が選択されます。
offon ビデオの表示を有効または無効にします。 ビデオを無効にすると、 put "destination" 四角形 (またはその既定の現在のウィンドウのクライアント領域) のピクセルが純色に設定されます。 フレーム バッファーには影響しません。ワークスペースでも外部入力でも、ビデオ ソースは、フレーム バッファーに新しいイメージを格納し続ける可能性があります。 ビデオが有効になるまでは表示されません。 ウィンドウの "state" コマンドを使用して、ウィンドウを非表示にすることができます。 既定値は setvideo "on" です。
output "明るさ"、"色"、"コントラスト"、"ガンマ"、"シャープネス"、または "濃淡" フラグを変更して、表示される信号のみを変更し、記録される内容を変更しないようにします。 可能であれば、ファイルを監視する場合の既定値です。
期間を超える 因子変数を使用する変更に要する時間を指定します。 期間の単位は現在の時刻形式です。 変更は、ワークスペースの再生に伴うステップで行われます。 再生が中断されると、プレイが続行されるまで変更も中断されます。 "over" が使用されていないか、サポートされていない場合、変更はすぐに行われます。
インデックスを newrgb に対するパレットの色 新しいパレットの色を設定します。 変更する色とパレットのインデックスは、 色 と インデックス のパラメーターによって指定されます。新しい色は newrgb によって指定されます。 このフラグは、MCIAVI デジタル ビデオ ドライバーによってのみ認識されます。
処理するパレット ハンドル デバイスがレンダリングに使用する必要があるパレットへのハンドルを指定します。 このアイテムは、パレットを使用するデバイスでのみサポートされています。 handle が 0 の場合は、既定のパレットが使用されます。デジタルビデオデバイスは、このコマンドで渡されたパレットを解放しないでください。 アプリケーションは、デバイスを閉じてから解放する必要があります。
品質 記述子 ビデオがファイルに記録されるときに実行されるビデオ圧縮の特性を指定します。 すべてのデバイスは、"low"、"medium"、"high" の 3 つの記述子をサポートしています。 既定値はデバイス固有です。 これらの名前の重要性は、アルゴリズムとデバイスによって異なります。 デバイスは、追加の記述子名を定義する場合があります。 quality コマンドを使用して、追加の記述子名を定義できます。"algorithm" フラグが使用されていない場合、記述子は現在のアルゴリズムに適用されます。
フレーム レートをレートに記録する モーション ビデオの記録を設定します。 記録 レート は、1 秒あたりのフレーム数に 1000 を乗算して指定します。 たとえば、1 秒あたり 29.97 フレームの NTSC フレーム レートは 29970 として表されます。
レコードオンレコードオフ ビデオ データの記録を有効または無効にします。 ビデオ データの記録が既定です。
レコードトラック track_number オフ 次の record コマンドでビデオが記録されないように、ビデオ ソースの選択をクリアします。 「トラック」は独立したトラック選択を可能にする。 "track" が指定されていない場合は、既定値の 1 が想定されます。 ビデオ録画をオフにする前に、最初に セット の "アセンブル レコードオフ" コマンドを発行する必要がある場合があります。
レコード トラック track_number 次の record コマンドで記録するビデオ ソースを選択します。 「トラック」は独立したトラック選択を可能にする。 トラック2はHi8のPCMトラックに対応しています。 "track" が指定されていない場合は、既定値の 1 が想定されます。
因数に対するシャープネス ビデオの鮮明度レベルを設定します。
source から source number の値 ビデオ入力のソースを設定します。 これは通常、外部コネクタに対応します。 source に定義されている定数には、"rgb"、"pal"、"ntsc"、"svideo"、および "secam" があります。 指定した型の入力が複数存在する場合、省略可能な "number" 値 は目的の入力を示します。 たとえば、 setvideo "source to ntsc number 2" は、2 番目の NTSC 入力を指定します。"to" ソース を省略すると、 リスト "video source" コマンドで定義されているとおりに絶対ソースが使用されます。
source to typenumber テープに記録するビデオ ソースを選択します。 種類 は、"チューナー"、"line"、"svideo"、"aux"、"generic"、"mute"、または "rgb" である必要があります。
引き続き アルゴリズム アルゴリズム capture コマンドで使用される静止画像圧縮アルゴリズムを指定します。 すべてのデバイスで "none" の アルゴリズム がサポートされている必要があります。これは、圧縮がないことを意味します。 既定値です。 この場合、デジタル ビデオ デバイスは、静止画像を RGB デバイスに依存しないビットマップとして保存します。 デバイスでは、追加のアルゴリズムのデバイス固有の一覧もサポートされている場合があります。
引き続き品質 記述子 静止画像のキャプチャ中に実行される静止画像圧縮の特性を指定します。 すべてのデバイスは、記述子 "low"、"medium"、"high" をサポートしています。 既定値はデバイス固有です。"algorithm" フラグが使用されていない場合、 記述子 は現在のアルゴリズムに適用されます。
quality コマンドを使用して、他の記述子名を定義できます。
stream to number ワークスペースから再生されるビデオ ストリームを指定します。 ストリームが指定されておらず、既定のストリームがファイル形式で定義されていない場合は、物理的に最初にインターリーブされたビデオ ストリームが再生されます。
要素に濃淡 イメージの濃淡を設定します。 通常、この調整は、250 が緑、750 が赤色、0 (または

lpszFlags

"wait"、"notify"、"test"、またはこれらの組み合わせを指定できます。 これらのフラグの詳細については、「 待機、通知、テスト フラグ」を参照してください。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

VCR デバイスの場合、setvideo を個々のトラックをオフにするフラグ ("トラック track_number オフ") を使用すると、アプリケーションがコマンドを実行できなかったことを示すステータス メッセージを受信する可能性があります。一部の VCR では、個々のトラックではなく、トラックの組み合わせのみをオフにできます。たとえば、最初のオーディオ トラックとビデオ カセットのビデオ トラックなどです。 この場合は、 setaudio と setvideo を使用して、組み合わせを構成する他のトラックをオフにし続けます。 ドライバーは、組み合わせの最後のトラックをオフにするコマンドを受け取ると、トラックをオフにします。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]

関連項目

Mci

MCI コマンド文字列

キャプチャ

list

put

record

予約

set

setaudio

ウィンドウ