12.3　静止画再生

一 覧 表

Title 関数仕様

Function MPEG静止画ハンドルの生成

Function Name MPG_SpCreate

No 3.1

　書　式

MpgSp　MPG_SpCreate(StmHn vstm)

　入　力

vstm：ビデオストリームハンドル

　出　力

なし

　関数値

MPEG静止画ハンドル

　機　能

MPEG静止画ストリームを再生するためのハンドルを生成します。静止画データのビデオストリームハンドルを指定します。

一 覧 表

Title 関数仕様

Function MPEG静止画ハンドルの消去

Function Name MPG_SpDestroy

No 3.2

　書　式

Sint32　MPG_SpDestroy(MpgSp mpgsp)

　入　力

mpgsp：MPEG静止画ハンドル

　出　力

なし

　関数値

エラーコード

　機　能

MPEG静止画ハンドルを消去します。

［備考］
　(a) ハンドルは、オーディオ／ビデオともに停止状態であること。
　(b) ハンドルがMPG_MvEntryNext関数によって、次に再生するハンドルとして登録されて
      いないこと。
　(c) 本関数内では、再生の停止関数を実行する。

一 覧 表

Title 関数仕様

Function 静止画の出力先の設定

Function Name MPG_SpSetVideoDest

No 3.3

　書　式

void　MPG_SpSetVideoDest(MpgSp mpgsp, Sint32 dst)

　入　力

mpgsp	：MPEG静止画ハンドル
dst	：出力先

　出　力

なし

　関数値

なし

　機　能

MPEGビデオの出力先を設定します。出力先は以下のとおりです。

(1)出力先

• MPG_OUTDST_DRCTVDP2直接出力
• MPG_OUTDST_HOSTホスト転送出力

　備　考

(ａ)本関数の設定は、MPG_SpStart関数を呼ぶことにより有効となります。

一 覧 表

Title 関数仕様

Function 静止画の終了条件の設定

Function Name MPG_SpSetTermCond

No 3.4

　書　式

void　MPG_SpSetTermCond(MpgSp mpgsp, Sint32 vcnd)

　入　力

mpgsp	：MPEG静止画ハンドル
vcnd	：MPEGビデオストリームの終了条件

　出　力

なし

　関数値

なし

　機　能

ビデオストリームの転送終了条件を設定します。以下の値の論理和を取ることができます。

(1)MPEGビデオストリームの終了条件

・MPG_TCND_EOR	：ＥＯＲビットの立っているセクタを転送したとき
・MPG_TCND_SEC	：ストリーム中にシステムエンドコードが現れたとき
・MPG_TCND_NON	：終了条件を設定しない

一 覧 表

Title 関数仕様

Function 静止画のチャネルの設定

Function Name MPG_SpSetChan

No 3.5

　書　式

void　MPG_SpSetChan(MpgSp mpgsp, Sint32 ch)

　入　力

mpgsp	：MPEG静止画ハンドル
ch	：チャネル番号 (MPG_IGNORE：無指定)

　出　力

なし

　関数値

なし

　機　能

再生対象となるビデオストリームのチャネル番号を指定します。デフォルトは無指定です。
この関数が呼ばれると即座にチャネルが切り替わります。チャネル番号の一致しないデータは、CDバッファ内から順次消去されていきます。

一 覧 表

Title 関数仕様

Function 静止画のストリームIDの設定

Function Name MPG_SpSetId

No 3.6

　書　式

void　MPG_SpSetId(MpgSp mpgsp, Sint32 id)

　入　力

mpgsp	：MPEG静止画ハンドル
id	：ID番号 (MPG_IGNORE：無指定)

　出　力

なし

　関数値

なし

　機　能

再生対象となるビデオのIDを指定します。デフォルトは無指定です。
ID番号の一致しないデータは、CDバッファ内から順次消去されていきます。

一 覧 表

Title 関数仕様

Function 静止画再生の開始

Function Name MPG_SpStart

No 3.7

　書　式

Sint32　MPG_SpStart(MpgSp mpgsp)

　入　力

mpgsp：MPEG静止画ハンドル

　出　力

なし

　関数値

エラーコード

　機　能

静止画の再生を開始します。

　備　考

(ａ)他のストリームを再生中に本関数を呼ぶと、MPG_ERR_PLAYINGを返します。

(ｂ)MPEGデコーダの接続に失敗した場合は、MPG_ERR_MCONを返します。

一 覧 表

Title 関数仕様

Function 静止画再生の停止

Function Name MPG_SpStop

No 3.8

　書　式

Sint32 MPG_SpStop(MpgSp mpgsp)

　入　力

mpgsp：MPEG静止画ハンドル

　出　力

なし

　関数値

エラーコード

　機　能

静止画の再生を停止します。

　備　考

(ａ)復活処理中に本関数を呼ぶと、MPEGデコーダの初期化を行いMPG_ERR_RCVを返します。

一 覧 表

Title 関数仕様

Function 静止画のデコードの実行

Function Name MPG_SpDecNext

No 3.9

　書　式

Sint32　MPG_SpDecNext(MpgSp mpgsp, Sint32 bnk)

　入　力

mpgsp	：MPEG静止画ハンドル
bnk	：フレームバンク番号

　出　力

なし

　関数値

エラーコード

　機　能

指定されたフレームバンクに１画面分のイメージを展開します。

【注意】
　最初のピクチャをデコードする時だけ、本関数の実行前にMPG_IsDecReady関数
を使用してデコード準備ができたことを確認してください。
　それ以降は、必ず１フレーム分のデコード時間（2VSYNC）以上の間隔を空けて
本関数を実行してください。通常は、VSYNCやオーディオ再生量などを利用して同
期タイミングを取る必要があります。
　詳細は、CDCマニュアル（MPEGパート）のP.57「デコード同期信号の送出」
（CDC_MpOutDsync関数）を参照してください。

一 覧 表

Title 関数仕様

Function 静止画の動作状態の取得

Function Name MPG_SpGetVideoStat

No 3.10

　書　式

Sint32　MPG_SpGetVideoStat(MpgSp mpgsp)

　入　力

mpgsp：MPEG静止画ハンドル

　出　力

なし

　関数値

現在の動作状態

　機　能

以下のような現在の動作状態を取得します。

(1)現在の動作状態

・MPG_SSTAT_STOP	：停止中
・MPG_SSTAT_PREP	：準備中
・MPG_SSTAT_PLAY	：再生中
・MPG_SSTAT_ERR	：エラー

一 覧 表

Title 関数仕様

Function 静止画のタイムコードの取得

Function Name MPG_SpGetTimeCode

No 3.11

　書　式

void　MPG_SpGetTimeCode(MpgSp mpgsp,Sint32 *hh, Sint32 *mm, Sint32 *ss, Sint32 *pp)

　入　力

mpgsp：MPEG静止画ハンドル

　出　力

hh	：タイムコードの時間　　(0〜23)
mm	：タイムコードの分　　　(0〜59)
ss	：タイムコードの秒　　　(0〜59)
pp	：タイムコードのピクチャ(0〜29)

　関数値

なし

　機　能

ビデオストリーム中にあるタイムコードを取得します。ビデオストリームを再生中でないときは、0を出力します。

　備　考

(ａ)ビデオストリームは、NTSCのドロップフレームでエンコードされている必要があります。

(ｂ)ピクチャをフレームと呼ぶこともあります。

一 覧 表

Title 関数仕様

Function 静止画のMPEGウィンドウの接続

Function Name MPG_SpConnectWin

No 3.12

　書　式

void　MPG_SpConnectWin(MpgSp mpgsp, MpgWn mpgwn, Sint32 bnk)

　入　力

mpgsp	：MPEG静止画ハンドル
mpgwn	：MPEGウィンドウ
bnk	：フレームバンク番号

　出　力

なし

　関数値

なし

　機　能

MPEG静止画ハンドルとMPEGウィンドウを接続します。デコードされた静止画は、このMPEGウィンドウを通して表示されます。

一 覧 表

Title 関数仕様

Function 静止画のMPEGウィンドウの切り離し

Function Name MPG_SpDisconnectWin

No 3.13

　書　式

void　MPG_SpDisconnectWin(MpgSp mpgsp, MpgWn mpgwn, Sint32 bnk)

　入　力

mpgsp	：MPEG静止画ハンドル
mpgwn	：MPEGウィンドウ
bnk	：フレームバンク番号

　出　力

なし

　関数値

なし

　機　能

MPEG静止画ハンドルとMPEGウィンドウの接続を切り離します。

一 覧 表

Title 関数仕様

Function 静止画の出力

Function Name MPG_SpOutput

No 3.14

　書　式

Sint32MPG_SpOutput(MpgSp mpgsp, Sint32 bnk)

　入　力

mpgsp	：MPEG静止画ハンドル
bnk	：フレームバンク番号

　出　力

なし

　関数値

エラーコード

　機　能

静止画を出力します。他のMPEG静止画ハンドルやMPEG動画ハンドルが出力中のときは失敗し、静止画は出力されません。指定されたフレームバンク番号に接続されているMPEGウィンドウが出力されます。VDP2への直接出力が指定されている場合、その指定されているバンクに接続されている直接出力用ウィンドウが使用されます。ホスト転送による出力の場合は、指定されたバンクに接続しているホスト転送用ウィンドウのバッファ領域にイメージデータが転送されます。

　備　考

(ａ)mpgspはホスト出力モードで、かつ動作状態が再生中でなければなりません。そうなっていないときは静止画の出力に失敗します。