Microsoft DirectX 8.0

DVD サブピクチャ プロパティ セット

DVD サブピクチャ プロパティは、サブピクチャ表示の色、コントラスト、および出力を制御する。

次の情報は、IKsPropertySet メソッドの呼び出しでこのプロパティ セットに使用するために必要な定数およびデータ型の情報を示している。GUID (guidPropSet)、プロパティ ID (dwPropID)、およびプロパティのデータ型 (pPropData) パラメータの値を提供する。

プロパティ セット GUID: AM_KSPROPSETID_DvdSubPic

プロパティ ID指定されたプロパティによって使用されるデータ型
AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON AM_PROPERTY_COMPOSIT_ON
AM_PROPERTY_DVDSUBPIC_HLI AM_PROPERTY_SPHLI
AM_PROPERTY_DVDSUBPIC_PALETTE AM_PROPERTY_SPPAL

次の一覧は、サブピクチャ プロパティの ID とその説明である。

AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON
サブピクチャの表示を有効または無効にする設定専用プロパティ。Microsoft® DirectShow® は、このプロパティに対応する AM_PROPERTY_COMPOSIT_ON ブール型と、このデータ型へのポインタである PAM_PROPERTY_COMPOSIT_ON を定義する。TRUE はサブピクチャを表示することを示し、FALSE は表示しないことを示す。詳細については、Windows 98 DDK の WDM 部分を参照すること。
AM_PROPERTY_DVDSUBPIC_HLI
色またはコントラストを変更するサブピクチャまたは画面の矩形を指定する設定専用プロパティ。データ型は AM_PROPERTY_SPHLI

AM_PROPERTY_DVDSUBPIC_HLI プロパティは設定専用である。このプロパティは、色またはコントラストを変更するサブピクチャまたは画面の矩形を指定する。ここでは、「DVD ビデオの仕様」と異なり、Microsoft DVD ナビゲータがボタンおよびキーボードの情報をすべて解析し、強調表示する矩形を 1 つずつサブピクチャ デコーダに渡す。この結果、強調表示情報がデコーダに送られる回数は、DVD ストリーム内に存在するこの情報の数より多くなる。

強調表示情報はデータ ストリームと非同期に届く。デコーダは、強調表示の開始と終了のタイム スタンプを使用して、強調表示情報とそれに関連するサブピクチャ情報を対応付ける (存在する場合)。要求されたタイム スタンプに対応するサブピクチャ ストリーム情報が届かなかった場合、デコーダは、その強調表示情報をサブピクチャに関連しない独立した情報と見なす。この場合、色およびコントラストの情報は、すべて同じ色として処理される。

このデータは完全な DVD ディスク フォーマットではない。Microsoft では、AM_PROPERTY_SPHLI 型の追加の構造体を提供する。この構造体は、このプロパティのパラメータとして渡され、DVD の強調表示情報から得られる現在選択されているボタンを記述する。

DVD ナビゲータは、キーストローク情報をすべて処理し、ボタン状態が変化するたびに新しい強調表示情報を送る。この情報は、1 度に 1 つのボタンの 1 モードのみを記述する。ここには、ピクセル座標で表された画面の表示矩形、またはサブピクチャの表示 (ある場合) が含まれる。構造体には、色とコントラストの情報も格納されているが、この情報は現在選択されているボタンの現在の状態のみに対応する。フォーマットは DVD の仕様に定義されている。

強調表示情報には開始と終了のタイム スタンプが格納されている。これらの単位はほかのタイム スタンプと同じである。ただし例外が 2 つだけある。0xFFFFFFFF という開始タイム スタンプは、強調表示プロパティが受け取りと同時に有効になることを意味し、0xFFFFFFFF という終了タイム スタンプは、強調表示プロパティを次に受け取るまで有効なことを意味する。

HLISS フィールドは、DVD の仕様に定義されているとおりである。値 0 は、強調表示がすべて無効であり、デコーダでオフにしなければならないことを示す。

AM_PROPERTY_DVDSUBPIC_PALETTE
サブピクチャのパレットを設定する。データ型は AM_PROPERTY_SPPAL

IKsPropertySet インターフェイスを使用して、これらのプロパティをサポートするために設定、取得、およびクエリを行う。

このプロパティ セットでは、次のデータ型が使用される。

データ型説明
AM_COLCON カラー コントラストを指定する。AM_PROPERTY_SPHLI 構造体のサブ構造体。
AM_DVD_YUV DVD YUV サブピクチャ データを指定する。AM_PROPERTY_SPPAL 構造体のサブ構造体。
AM_PROPERTY_COMPOSIT_ON AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON プロパティで使用されるブール値。
AM_PROPERTY_SPHLI DVD の強調表示情報から得られる現在選択されているボタンを記述する。
AM_PROPERTY_SPPAL DVD サブピクチャのパレットを指定する。

AM_COLCON

DVD サブピクチャ プロパティ セット

DVD 強調表示 (HLI) 構造体から得られるカラー コントラストの記述を示す。

構文

 typedef struct _AM_COLCON {
    UCHAR emph1col:4;
    UCHAR emph2col:4;
    UCHAR backcol:4;
    UCHAR patcol:4;
    UCHAR emph1con:4;
    UCHAR emph2con:4;
    UCHAR backcon:4;
    UCHAR patcon:4;
} AM_COLCON, *PAM_COLCON;

メンバ

emph1col
強調色 1。
emph2col
強調色 2。
backcol
背景色。
patcol
パターン色。
emph1con
強調コントラスト 1。
emph2con
強調コントラスト 2。
backcon
背景コントラスト。
patcon
パターン コントラスト。

注意

この構造体は AM_PROPERTY_SPHLI 構造体に含まれる。

AM_DVD_YUV

DVD サブピクチャ プロパティ セット

DVD YUV サブピクチャ データ。

構文

 typedef struct _AM_DVD_YUV {
    UCHAR   Reserved;
    UCHAR   Y;
    UCHAR   U;
    UCHAR   V;
} AM_DVD_YUV, *PAM_DVD_YUV;

メンバ

Reserved
予約済み。
Y
Y の色データ。
U
U の色データ。
V
V の色データ。

注意

この構造体は AM_PROPERTY_SPPAL 構造体に含まれる。

AM_PROPERTY_SPHLI

DVD サブピクチャ プロパティ セット

DVD の強調表示情報から得られる現在選択されているボタンを記述する。

構文

 typedef struct _AM_PROPERTY_SPHLI {
    USHORT  HLISS;      
    USHORT  Reserved;
    ULONG   StartPTM; 
    ULONG   EndPTM;  
    USHORT  StartX;
    USHORT  StartY;
    USHORT  StopX;
    USHORT  StopY;
    AM_COLCON  ColCon; 
} AM_PROPERTY_SPHLI, *PAM_PROPERTY_SPHLI;

メンバ

HLISS
現在選択されているボタンの強調表示状態。
Reserved
内部で使用するために予約済み。使用または設定しないこと。
StartPTM
開始プレゼンテーション時間を 90,000 で割った値。
EndPTM
終了プレゼンテーション時間を 90,000 で割った値。
StartX
現在強調表示されているボタンの開始 x ピクセル座標。
StartY
現在強調表示されているボタンの開始 y ピクセル座標。
StopX
現在強調表示されているボタンの終了 x ピクセル座標。
StopY
現在強調表示されているボタンの終了 y ピクセル座標。
ColCon
カラー コントラストの記述。データ型は AM_COLCON

注意

AM_PROPERTY_DVDSUBPIC_HLI プロパティはこの構造体を使用する。

AM_PROPERTY_SPPAL

DVD サブピクチャ プロパティ セット

DVD サブピクチャのパレットを指定する。

構文

 typedef struct _AM_PROPERTY_SPPAL {
    AM_DVD_YUV sppal[16];
} AM_PROPERTY_SPPAL, *PAM_PROPERTY_SPPAL;

メンバ

sppal
YUV 要素 16 個から成る配列。サブピクチャ コマンド ストリーム内で要求された 4 ビットの色番号に対応する。YUV 要素のデータ型は AM_DVD_YUV

注意

AM_PROPERTY_DVDSUBPIC_PALETTE プロパティはこの構造体を使用する。