Microsoft DirectX 8.0 |
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_HLI プロパティは設定専用である。このプロパティは、色またはコントラストを変更するサブピクチャまたは画面の矩形を指定する。ここでは、「DVD ビデオの仕様」と異なり、Microsoft DVD ナビゲータがボタンおよびキーボードの情報をすべて解析し、強調表示する矩形を 1 つずつサブピクチャ デコーダに渡す。この結果、強調表示情報がデコーダに送られる回数は、DVD ストリーム内に存在するこの情報の数より多くなる。
強調表示情報はデータ ストリームと非同期に届く。デコーダは、強調表示の開始と終了のタイム スタンプを使用して、強調表示情報とそれに関連するサブピクチャ情報を対応付ける (存在する場合)。要求されたタイム スタンプに対応するサブピクチャ ストリーム情報が届かなかった場合、デコーダは、その強調表示情報をサブピクチャに関連しない独立した情報と見なす。この場合、色およびコントラストの情報は、すべて同じ色として処理される。
このデータは完全な DVD ディスク フォーマットではない。Microsoft では、AM_PROPERTY_SPHLI 型の追加の構造体を提供する。この構造体は、このプロパティのパラメータとして渡され、DVD の強調表示情報から得られる現在選択されているボタンを記述する。
DVD ナビゲータは、キーストローク情報をすべて処理し、ボタン状態が変化するたびに新しい強調表示情報を送る。この情報は、1 度に 1 つのボタンの 1 モードのみを記述する。ここには、ピクセル座標で表された画面の表示矩形、またはサブピクチャの表示 (ある場合) が含まれる。構造体には、色とコントラストの情報も格納されているが、この情報は現在選択されているボタンの現在の状態のみに対応する。フォーマットは DVD の仕様に定義されている。
強調表示情報には開始と終了のタイム スタンプが格納されている。これらの単位はほかのタイム スタンプと同じである。ただし例外が 2 つだけある。0xFFFFFFFF という開始タイム スタンプは、強調表示プロパティが受け取りと同時に有効になることを意味し、0xFFFFFFFF という終了タイム スタンプは、強調表示プロパティを次に受け取るまで有効なことを意味する。
HLISS フィールドは、DVD の仕様に定義されているとおりである。値 0 は、強調表示がすべて無効であり、デコーダでオフにしなければならないことを示す。
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 サブピクチャのパレットを指定する。 |
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;
メンバ
注意
この構造体は AM_PROPERTY_SPHLI 構造体に含まれる。
DVD YUV サブピクチャ データ。
構文
typedef struct _AM_DVD_YUV { UCHAR Reserved; UCHAR Y; UCHAR U; UCHAR V; } AM_DVD_YUV, *PAM_DVD_YUV;
メンバ
注意
この構造体は AM_PROPERTY_SPPAL 構造体に含まれる。
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 プロパティはこの構造体を使用する。
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 プロパティはこの構造体を使用する。