Sofdec再生ハンドルの状態を表します。

互換性のために旧定義も宣言は残してあります。

MWE_PLY_STAT_STOP

MWE_PLY_STAT_PREP

MWE_PLY_STAT_PLAYING

MWE_PLY_STAT_PLAYEND

MWE_PLY_STAT_ERROR

デコーダへ設定する垂直同期周波数（Vsync周波数）です。

ムービのデコード方法を示します。

表示するフレームの合成モードです。

本ライブラリで再生するファイルの種別です。

互換性のために旧定義も宣言は残してあります。

MWE_PLY_FTYPE_SFD

MWE_PLY_FTYPE_MPV

デコード済データを格納するバッファのデータ形式です。

互換性のために旧定義も宣言は残してあります。

MWE_PLY_BUFFMT_MB_YCC420

MWE_PLY_BUFFMT_MB_ARGB8888

MWE_PLY_BUFFMT_PLN_YCC420

オーディオのボリューム値です。

オーディオのLRチャンネルです。

互換性のために旧定義も宣言は残してあります。

MWD_CH_L

MWD_CH_R

オーディオのパンポットです。

MWSFD_PAN_AUTOの場合は、音声データがモノラルかステレオによって自動的に設定されます。

互換性のために旧定義も宣言は残してあります。

MWD_PAN_LEFT

MWD_PAN_CENTER

MWD_PAN_RIGHT

MWD_PAN_AUTO

出力バッファ幅のデフォルト値です。

ルミナンスキー合成の透過キーです。

ソース映像の操作方式の違いを表します。

Sofdecデータのビデオストリームを攻勢する基本画像のタイプです。

互換性のために旧定義も宣言は残してあります。

MWE_PLY_PTYPE_I

MWE_PLY_PTYPE_P

MWE_PLY_PTYPE_B

MWE_PLY_PTYPE_D

フレームのYUV変換モードを表します。

アプリケーションが自前でフレーム変換処理を行うときに参照してください。

再生するビデオの同期モードです。

互換性のために旧定義も宣言は残してあります。

MWD_PLY_SYNC_AUDIO

MWD_PLY_SYNC_VSYNC

MWD_PLY_SYNC_NONE

フレーム取得の同期モードです。

ＺムービのＺ値範囲と最小値、最大値です。

アプリケーションが自前でＺ値変換処理を行うときに参照してください。

ビデオコーデックの種別です。

ncount：再生サンプル数（時刻）

tscale：サンプリング周波数（時刻の単位）（単位:ヘルツ）

なし

実時間（秒）

mwPlyGetTime関数で取得した値を、実時間（秒）に変換する。

互換性のために旧定義も宣言は残してあります。

MWD_PLY_TIME2SEC(ncount, tscale)

ncount：再生サンプル数（時刻）

tscale：サンプリング周波数（時刻の単位）（単位:ヘルツ）

なし

実時間（ミリ秒）

mwPlyGetTime関数で取得した値を、実時間（秒）に変換する。

互換性のために旧定義も宣言は残してあります。

MWD_PLY_TIME2MSEC(ncount, tscale)

npool：ハンドル生成パラメータのフレームプール数 nfrm_pool_wk

size1pic：１ピクチャあたりの最大ユーザデータサイズ

なし

ピクチャユーザデータ用バッファサイズ（byte）

mwPlyAttachPicUsrBuf関数で設定するバッファのサイズを計算します。

picnum：時刻情報を保持するピクチャ数

なし

ビデオPTS処理用作業領域サイズ（byte）

mwPlySetVideoPts関数で設定するバッファのサイズを計算します。

引数指定するピクチャ数は、通常は90枚（3秒分）指定すれば充分です。

データの再生を制御するためのハンドルです。

mwPlyCreateSofdec関数でSofdec再生ハンドルを生成します。

本ライブラリの初期化関数に設定するパラメータ構造体です。

互換性のために旧定義も宣言は残してあります。

MWS_PLY_INIT_SFD型

Sofdec再生ハンドルを生成する時に、設定するパラメータの構造体です。

同時読み込みストリーム数 max_stm は、同時に読み込むSofdecファイル／ADXファイル／データファイルの合計値です。

フレームプール数の最大値は14です。

互換性のために旧定義も宣言は残してあります。

MWS_PLY_CPRM_SFD型

デコード結果として取得できるフレームの情報です。

互換性のために旧定義も宣言は残してあります。

MWS_PLY_FRM型

mwPlyGetSubtitle関数で取得できる字幕データパラメータの情報構造体です。

再生情報取得関数で使用する再生情報の構造体です。

mwPlyGetHdrInf関数で取得できるファイルヘッダの情報構造体です。

ライブラリに登録するメモリ割当関数の型です。

obj：登録オブジェクト

size：確保するメモリサイズ

確保したメモリのポインタ

なし

ライブラリに登録するメモリ解放関数の型です。

obj：登録オブジェクト

ptr：解放するメモリのポインタ

なし

なし

デコード出力バッファフォーマットがMWSFD_BUFFMT_PLN_YCC420の場合の、詳細情報です。

互換性のために旧定義も宣言は残してあります。

MWS_PLY_YCC_PLANE型

ライブラリに登録するＺ変換用コールバック関数の型です。

orgtbl ：デコード結果からＺ値(0x00000000〜0x7FFFFFFF)への変換テーブルポインタ。テーブルの実体はMWPLYハンドルの作業領域内にあります。

znear ：Zのnear値

zfar ：Zのfar 値

ztbl ：Ｚ値(0x00000000〜0x7FFFFFFF)からＺバッファ内容への変換テーブルポインタ。テーブルの型はアプリケーションの呼び出した関数（mwPlyFxCnvZ16関数またはmwPlyFxCnvZ32関数）に応じて、Sint16かSint32にキャストして使用します。テーブルの実体はMWPLYハンドルの作業領域内にあります。

なし

供給されたデータサイズと消費したデータサイズを表します。

デコーダの各モジュールに供給された流量カウンタを表します。

ライブラリに登録する外部クロック関数の型です。

usrobj ：登録オブジェクト

time ：再生時刻

tunit ：時刻単位

なし

ビデオコーデック固有のフレーム情報構造体です。

MPEG-2のビットストリーム内の情報をそのまま記録する構造体です。

MPEG-1, SofdecVideoの場合もこの値は有効です。

iprm：初期化パラメータ

なし

なし

ライブラリを初期化します。

初期化パラメータを変更したい場合は、mwPlyFinishSfdFx関数を実行し、一旦ライブラリを終了した後に、再度初期化を行ってください。

多重に初期化を行っても、初期化パラメータの変更は反映されません。

memset(&iprm, 0, sizeof(MwsfdInitPrm));         // 予約メンバのゼロ設定
iprm.vhz            = MWSFD_VHZ_59_94;          // NTSC(59.94Hz)
iprm.dec_svr        = MWSFD_DEC_SVR_IDLE;       // アイドルスレッドデコード
mwPlyInitSfdFx(&iprm);

なし

なし

なし

ライブラリを終了します。

cprm：ハンドルの生成パラメータ

なし

ライブラリ作業領域サイズ（単位:バイト）

ライブラリ作業領域サイズを計算します。

使用例はmwPlyCreateSofdec関数の説明を参照してください。

cprm：ハンドルの生成パラメータ

なし

Sofdec再生ハンドル

ハンドルを生成します。同時に生成できるハンドルの最大数は８です。

mwPlyCalcWorkCprmSfd関数でライブラリ作業領域サイズを計算し、ハンドル生成パラメータのwksizeメンバで指定します。

memset(&cprm, 0, sizeof(MwsfdCrePrm));      // 予約メンバのゼロ設定
cprm.compo_mode     = MWSFD_COMPO_AUTO;     // 合成モード（自動）
cprm.ftype          = MWSFD_FTYPE_SFD;      // 再生ファイルタイプ（Sofdecデータ：オーディオ＋ビデオ）
cprm.max_bps        = 6 * 1000 * 1000;      // 最大ビットレート：6Mbit/sec
cprm.max_width      = 640;                  // 画像サイズ：640x480
cprm.max_height     = 480; 
cprm.nfrm_pool_wk   = 2;                    // フレームプール数
cprm.max_stm        = 1;                    // 最大1ストリーム
cprm.buffmt         = MWSFD_BUFFMT_DEFAULT; // デコード出力フォーマット
cprm.wksize = mwPlyCalcWorkCprmSfd(&cprm);  // ライブラリ作業領域サイズの計算
cprm.work           = malloc(cprm.wksize);  // ライブラリ作業領域の確保
ply = mwPlyCreateSofdec(&cprm);

mwply：Sofdec再生ハンドル

なし

なし

ハンドルを消去します。

mwply：Sofdec再生ハンドル

fname：再生するSofdecデータのファイル名

なし

なし

ファイル指定によるSofdecデータの再生を開始します。

mwply：Sofdec再生ハンドル

なし

なし

ムービ再生を停止します。

完了復帰の関数で、この関数から戻るとハンドル状態はSTOPになります。

再生途中に呼び出した場合は処理に時間がかかる場合があります。

mwply：Sofdec再生ハンドル

なし

なし

ムービ再生の停止リクエストを発行します。

即時復帰の関数で、この関数から戻ってもハンドル状態はすぐには遷移しません。

停止リクエストを発行したあとはアプリケーションのメインループをムービ再生中と同じように(Vsync待ち含む)動かす必要があります。

デコード中止とファイル読み込み中止が終わると、ADXM_ExecMain関数内で停止処理を行い、ハンドル状態をSTOPに遷移させます。

再生が停止したかどうかはハンドル状態がSTOPになったかどうかで判定してください。

mwPlyRequestStop関数を使ってムービを停止する場合は、特定の関数の処理が重くなることはありません。

代わりに停止するまでに不定の時間がかかります。

mwply：Sofdec再生ハンドル

なし

ハンドルの状態

Sofdec再生ハンドルの状態を取得します。

mwply：Sofdec再生ハンドル

frm：フレーム情報

なし

デコード済データを、表示タイミングに合わせて取得します。

(a) フレームが取得できなかった場合、frm.bufadrがNULLになります。

(b) 不要になったフレームは、mwPlyRelCurFrm関数で速やかに解放してください。

mwPlyGetFrm関数/mwPlyRelFrm関数との併用は出来ません。

for (;;) {
    MwsfdFrmObj frm;
    /* Main Loop */
    ADXM_ExecMain();
    mwPlyGetCurFrm(mwply, &frm);
    if (frm.bufadr != NULL) {
        /* Conversion of frame */
        /* Transfer texture to VRAM */
        UsrLoadMvFrmFx(mwply, &frm);
        mwPlyRelCurFrm(mwply);
    }
    UsrDrawMv();
}

mwply：Sofdec再生ハンドル

なし

なし

mwPlyGetCurFrm関数で取得したフレームを解放します。

mwPlyGetFrm関数/mwPlyRelFrm関数との併用は出来ません。

使用例はmwPlyGetCurFrm関数の説明を参照してください。

mwply：Sofdec再生ハンドル

ncount：再生サンプル数（時刻）

tscale：サンプリング周波数（時刻の単位）（単位:ヘルツ）

なし

再生時間を計算するためのパラメータを取得します。

Sofdec内部の再生時間は、ある周波数を「単位」として表現されています。

通常はオーディオチャネルをマスタークロックとして時間管理を行うため、再生時間はオーディオのサンプリング周波数を単位とした、オーディオサンプル数で表現されます。

オーディオチャネルのないムービの場合はVsyncがマスタークロックとして使用され、再生時間はVsync周波数を単位とした、Vsyncカウント数で表現されます。

　実際の時間は、時間値÷時間単位で計算します。以下のマクロが使用できます。

sec = MWSFD_TIME2SEC(ncount , tscale); // 秒単位

msec = MWSFD_TIME2MSEC(ncount , tscale); // ミリ秒単位

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：ポーズする、OFF：ポーズ解除する）

なし

なし

動画再生のポーズおよびポーズ解除を行います。

(a) mwPlyPause関数で設定したポーズ状態はSofdec再生ハンドルの状態とは独立に管理されます。

(b) 現在のポーズ状態を問い合わせるには、mwPlyIsPause関数を使用します。

(c) ビデオのみ再生の場合はポーズ中にポーズを実行するとコマ送りになります。

mwply：Sofdec再生ハンドル

なし

TRUE：ポーズ状態である。

FALSE：ポーズ状態でない。

ポーズ状態か否かを問い合わせます。

Sofdec再生ハンドルの状態とは独立に、mwPlyPause関数で設定した結果を返します。

mwply：Sofdec再生ハンドル

frmid：取得できたフレームのフレームID（変数実体はユーザが定義）

frm：取得できたフレームのフレーム情報構造体（変数実体はユーザが定義）

TRUE：フレームが取得できた

FALSE：フレームが取得できなかった

・表示時刻になっているフレームを取得する。

・古いフレームを解放しなくても、新しいフレームを取得できる。

・同一フレームは一度だけ取得できる。

・フレーム内容はmwPlyRelFrm関数で解放するか、mwPlyStop関数実行まで保持。

・mwPlyGetFrm関数とmwPlyRelFrm関数は同一スレッド内で実行すること。

・mwPlyGetCurFrm関数/mwPlyRelCurFrm関数との併用は禁止。

mwply：Sofdec再生ハンドル

frmid：フレームID

なし

なし

・引数frmidで指定したフレームを解放する。

・同じフレームIDに対しての解放は１度のみ。２度目以降はエラーコールバック。

・フレームを取得した順番と解放する順番は一致しなくてよい。

・mwPlyGetFrm関数とmwPlyRelFrm関数は同一スレッド内で実行すること。

・mwPlyGetCurFrm関数/mwPlyRelCurFrm関数との併用は禁止。

mwply：Sofdec再生ハンドル

patid：パーティションID

fid：ファイルID

なし

なし

AFSファイル内のSofdecファイルをFID指定により再生開始します。

static char ptinfo[ADXF_CALC_PTINFO_FMGL_SIZE(MAX_INSIDE)];
/* パーティション情報を読み込む */
ADXF_LoadPartitionFmgLongNw(ptid, "movie.afs", NULL, ptinfo);
for(;;) {
    if (ADXF_GetPtStat(ptid) == ADXF_STAT_READEND) {
    break;
    }
    ADXM_ExecMain();
}
/* FID 0番を再生する */
mwPlyStartAfs(mwply, ptid, 0);

mwply ：Sofdec再生ハンドル

fname ：Sofdecデータを含むファイル名

offset_sct ：ファイル先頭からSofdecデータ先頭までのオフセット[セクタ単位]

range_sct ：Sofdecデータのサイズ[セクタ単位]

なし

なし

ファイルの途中にSofdecデータがある場合に、ファイル内の範囲指定によってSofdecデータを再生開始します。

ユーザ独自形式のパックファイルなどにSofdecデータを入れる場合に使用してください。

mwply：Sofdec再生ハンドル

sji：SJハンドル

なし

なし

SJハンドルで指定したメモリ内のSofdecファイルを再生開始します。

mwply ：Sofdec再生ハンドル

なし

なし

mwPlyStartSj関数で再生を開始したハンドルに対して、データ供給終了を通知します。ムービデータをSJに入力し終えた時点でmwPlyTermSupply関数を実行してください。mwPlyTermSupply関数の実行後、全ての入力データをデコードし終わるとSofdec再生ハンドルはPLAYEND状態に遷移します。

mwply：Sofdec再生ハンドル

addr：メモリアドレス

len：データサイズ

なし

なし

アドレス指定によりメモリ内のSofdecファイルを再生開始します。

・ループ再生／連続再生はできません。

・SFD形式のファイルのみ再生可能です。MWSFD_FTYPE_MPVのファイルは再生できません。

オンメモリのムービを再生する方法としてADXのメモリファイルシステム(MFS)を使用する方法があります。

MFSはオンメモリのデータに対して、通常のファイル再生APIを利用できるようにするものです。

MFSを使うことによって、オンメモリデータのループ再生や連続再生も可能になります。

MFSについてはADXサンプルプログラムadxmfsを参照してください。

mwply：Sofdec再生ハンドル

fname：ファイル名

なし

なし

Sofdecファイルのループ再生を開始します。

(a) 取得できる時刻はループ後も連続になり、ストリーム先頭に戻っても０になりません。

(b) 再生時間が再生時間上限に達すると、ストリームの途中であっても再生を終了し、Sofdec再生ハンドルはMWSFD_STAT_PLAYEND状態になります。再生時間上限についてはmwPlySetLimitTime関数、mwPlyGetLimitTime関数の説明を参照してください。

(c) ストリームの区切りで再生終了したい場合はmwPlyReleaseLp関数を利用してください。

(d) 再生時間が極端に短い（2秒未満程度）場合はファイルの読み込みが間に合わず、スムーズに連続再生できない可能性があります。

(e) mwPlySetInfiniteSingleLoop関数を使うことで、無限ループ再生を行うことが可能です。

mwply：Sofdec再生ハンドル

なし

なし

ループ再生を解除します。

この設定の後、ストリームの終端になると再生が終了します。

ストリーム終端近くを再生中に解除支持が行われると、さらにもう一度再生したあとに終了することがあります。

mwply：Sofdec再生ハンドル

patid：パーティションID

fid：ファイルID

なし

なし

AFSファイル内のSofdecファイルをFID指定によりループ再生を開始します。

ファイルの指定方法が異なる以外は、mwPlyStartFnameLp関数と同機能です。

mwply ：Sofdec再生ハンドル

fname ：Sofdecデータを含むファイル名

offset_sct ：ファイル先頭からSofdecデータ先頭までのオフセット[セクタ単位]

range_sct ：Sofdecデータのサイズ[セクタ単位]

なし

なし

ファイルの途中にSofdecデータがある場合に、ファイル内の範囲指定によってSofdecデータをループ再生します。

ユーザ独自形式のパックファイルなどにSofdecデータを入れる場合に使用してください。

mwply ：Sofdec再生ハンドル

sw ：切り替えスイッチ（ON：無限ループ再生する、OFF：無限ループ再生しない）

なし

なし

無限ループ再生機能の有効無効設定を行います。デフォルトは無効(OFF)です。

Sofdecの再生時間には上限があり、ループ再生や連続再生をしていても再生時間上限になると再生を終了します。

「無限ループ再生」機能とは、単一ファイルのループ再生に限定されますが、再生時間上限になる前に自動的に再スタートをかけることで見かけ上、無限にループ再生するようにする機能です。

再スタート処理はADXM_ExecMain関数内で実行します。

再スタートをかける時には一時的にムービ再生が途切れますが、アプリケーションから見たハンドル状態はPLAYINGのままです。

再スタートがかかると、再生時刻やフレームIDなどの情報は全てリセットされます。

再スタートをかけるタイミングは、ループ再生しているムービの尺に合わせて再生時間上限よりも前にムービの終端にあわせて実行します。そのためムービの途中で再スタートがかかるようなことはありません。

無限ループ再生機能が使用できるのは以下の再生開始関数を使用した場合のみです。

　- mwPlyStartFnameLp

　- mwPlyStartAfsLp

　- mwPlyStartFnameRangeLp

　- mwPlyStartLsnLp

これら以外の再生開始関数を使った場合は、たとえ本関数で無限ループ再生機能を有効にしていても再生時間上限になると再生終了します。

例えば「単一ファイルのループ再生」という処理は同じでも、次の場合は無限ループ再生機能は動作しません。

＜無限ループ再生できない例＞

mwPlyEntryFname(ply, loopmovie.sfd);

mwPlyStartSeamless(ply);

mwPlySetSeamlessLp(ply, ON);

自動的に再スタートした回数はmwPlyGetInfiniteLoopCount関数で取得できます。

mwply ：Sofdec再生ハンドル

なし

再スタート回数。

無限ループ再生機能により、自動的に再スタートがかかった場合、再生時刻やフレームIDはリセットされます。

本関数により、再スタートした回数を取得することができます。

取得できる値は「再スタートした回数」であって、ループ再生した回数ではないのでご注意ください。

mwply：Sofdec再生ハンドル

fname：ファイル名

なし

なし

シームレス連続再生するファイルを再生リストに登録します。

(a) 登録したファイルは、そのファイルの再生終了後に再生リストから消去されます。

(b) 再生開始前に複数のファイルを登録することも、再生中に追加登録することもできます。

(c) 再生中の登録の場合は、登録タイミングによってはファイル読み込みが間に合わずスムーズに連続再生できない可能性があります。

(d) 再生リストにはファイル名文字列へのポインタが登録されます。したがって、ファイル名文字列は再生期間中は保持される必要があります。AUTO変数などでファイル名を指定すると、ファイル名領域が保持されず、途中で再生ができなくなります。

/* ４つのムービを連続再生して終了状態にする */
mwPlyEntryFname(mwply, "movie1.sfd");
mwPlyEntryFname(mwply, "movie2.sfd");
mwPlyEntryFname(mwply, "movie3.sfd");
mwPlyEntryFname(mwply, "movie4.sfd");
mwPlyStartSeamless(mwply);              /* 連続再生の開始 */
mwPlyReleaseSeamless(mwply);            /* 連続再生エントリ終了の通知 */

mwply：Sofdec再生ハンドル

なし

なし

シームレス連続再生を開始します。

(a) 取得できる時刻はループ後も連続になり、ストリーム先頭に戻っても０になりません。

(b) 再生時間が再生時間上限に達すると、ストリームの途中であっても再生を終了し、Sofdec再生ハンドルはMWSFD_STAT_PLAYEND状態になります。再生時間上限につ(c) ストリームの区切りで再生終了したい場合はmwPlyReleaseSeamless関数を利用してください。

(d) 再生時間が極端に短い（2秒未満程度）ファイルが登録されている場合はファイルの読み込みが間に合わず、スムーズに連続再生できない可能性があります。

(e) 無限ループ再生機能（mwPlySetInfiniteSingleLoop関数参照）を使うことはできません。

使用例はmwPlyEntryFname関数の説明を参照してください。

mwply：Sofdec再生ハンドル

なし

なし

シームレス連続再生のファイルエントリを終了します。

再生リストに登録したすべてのファイルを再生したあとに再生終了します。

使用例はmwPlyEntryFname関数の説明を参照してください。

mwply：Sofdec再生ハンドル

flg：ループ設定フラグ（1：ループON, 0：ループOFF）

なし

なし

連続再生に登録済みのファイルをループ再生する設定をします。

例えば３つのファイルをループ再生する場合、次のように呼び出してください。
　mwPlyEntryFname(mwply, "file01.sfd");	// １番目のファイル登録
　mwPlyEntryFname(mwply, "file02.sfd");	// ２番目のファイル登録
　mwPlyEntryFname(mwply, "file03.sfd");	// ３番目のファイル登録
　mwPlySetSeamlessLp(mwply, ON);		// ループ再生設定
　mwPlyStartSeamless(mwply);				// 再生開始

mwply：Sofdec再生ハンドル

なし

ファイル数

現在登録されているファイル数を取得します。

/* エントリ済みのファイル数およびファイル名を取得する */
num_entry = mwPlyGetNumSlFiles(mwply);
for (i = 0; i < num_entry; i++) {
    printf("%s\n", mwPlyGetSlFname(mwply, i));
}

mwply：Sofdec再生ハンドル

stm_no：読み込み中ファイルからの相対ファイル序数（0〜）

なし

ファイル名

シームレス連続再生に登録してあるファイル名を取得します。

使用例はmwPlyGetNumSlFiles関数の説明を参照してください。

mwply：Sofdec再生ハンドル

patid：パーティションID

fid：ファイルID

なし

なし

AFSファイル内のSofdecファイルをシームレス連続再生ファイルとして登録します。

登録ファイルの指定方法が異なる以外はmwPlyEntryFname関数と同機能です。

mwply ：Sofdec再生ハンドル

fname ：Sofdecデータを含むファイル名

offset_sct ：ファイル先頭からSofdecデータ先頭までのオフセット[セクタ単位]

range_sct ：Sofdecデータのサイズ[セクタ単位]

なし

なし

ファイルの途中にSofdecデータがある場合に、ファイル内の範囲指定によってSofdecデータをシームレス連続再生に登録します。

ユーザ独自形式のパックファイルなどにSofdecデータを入れる場合に使用してください。

mwply：Sofdec再生ハンドル

vol：ボリューム値（最小：-960 〜 最大：0）

なし

なし

音声出力のボリューム値を設定します。

mwply：Sofdec再生ハンドル

なし

ボリューム値（最小：-960 〜 最大：0）

現在、設定されている音声出力のボリューム値を取得します。

mwply：Sofdec再生ハンドル

chno：チャンネル番号（MWSFD_CH_L / MWSFD_CH_R）

pan：パンポット設定値（-15 〜 15）

なし

なし

音声出力のパンポットを設定します。マクロMWSFD_PAN_~を利用できます。

mwply：Sofdec再生ハンドル

chno：チャンネル番号（MWSFD_CH_L / MWSFD_CH_R）

なし

パンポット設定値

現在、設定されている音声出力のパンポット設定値を取得します。

mwply：Sofdec再生ハンドル

なし

オーディオストリーム数

Sofdecファイル内のオーディオストリーム数を取得します。

Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

mwply：Sofdec再生ハンドル

ch：チャネル番号（初期値：0）

なし

なし

Sofdecファイルに複数音声チャネルが含まれる場合、再生するチャネルを設定します。

チャネル番号はSofdecマルチプレクサで指定した番号から選択してください。

mwply：Sofdec再生ハンドル

なし

0〜31 : 再生中のオーディオストリームチャネル番号

-1 : オーディオ再生無しの場合、または再生開始前でチャネル番号が不明。

再生中のオーディオストリームチャネル番号を取得します。

なし

なし

AHX再生用作業領域サイズ

AHX再生用作業領域サイズを取得します。

mwPlyAttachAhx関数に引数で渡す作業領域サイズ決定に利用します。

mwply：Sofdec再生ハンドル

wkptr：作業領域へのポインタ

wksize：作業領域のサイズ

ch: AHXオーディオのチャネル番号

なし

なし

AHX再生機能をSofdec再生ハンドルに追加します。

マルチプレクス時に指定したAHXデータのチャネル番号をこの関数で指定します。

引数で指定する作業領域のサイズはmwPlyGetAhxWorkSize関数で取得してください。

mwply：Sofdec再生ハンドル

なし

なし

AHX再生機能をSofdec再生ハンドルから分離します。

本関数実行後は、mwPlyAttachAhx関数で引数指定した作業領域を解放することができます。

mwply：Sofdec再生ハンドル

ch：AHXオーディオのチャネル番号

なし

なし

Sofdec再生ハンドルにAHXがマルチプレクスされているオーディオチャネル番号を指定します。

mwPlyAttachAhx関数(AHX再生機能追加)の第４引数と同じパラメータです。再生開始の前に実行してください。

mwply：Sofdec再生ハンドル

bufptr：ユーザバッファのポインタ

bufsize：ユーザバッファのサイズ[Byte単位]

sbtprm：字幕パラメータ

1：現在時刻に一致する字幕データを取得した

1以外の値：字幕データは取得しなかった

ユーザバッファにムービの再生時刻に同期した字幕データをコピーして、関連情報を取得します。

データの表示持続時間中は何度本関数を呼び出しても同じ内容のデータを取得します。

合成モードをMWSFD_COMPO_AUTOにして利用してください。

mwply：Sofdec再生ハンドル

chno：字幕データのチャネル番号(0〜7)

なし

なし

字幕データのチャネル番号を設定します。

一つのムービに入れることのできる字幕は最大８種類です。字幕データごとにチャネル番号を割り当てます。

mwply：Sofdec再生ハンドル

なし

再生中のSofdecファイルに含まれる字幕チャネル数

再生中のSofdecファイルに含まれる字幕チャネル数を取得します。

Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

mwply：Sofdec再生ハンドル

scount：字幕データ取得時間のシフト量

なし

なし

字幕データに定義されている表示時間を指定カウントだけずらします。

mwply：Sofdec再生ハンドル

pitch：出力バッファ幅[Byte単位]

height：出力バッファ高さ[Line単位]

なし

なし

出力バッファのサイズを指定します。

MWSFD_DFL_OUTBUFSIZE(デフォルト値=0)の場合は変換時の入力動画サイズと同サイズで変換処理されます。

mwply：Sofdec再生ハンドル

pitch：出力バッファ幅[Byte単位]（未設定時はMWSFD_DFL_OUTBUFSIZE）

height：出力バッファ高さ[Line単位] （未設定時はMWSFD_DFL_OUTBUFSIZE）

なし

出力バッファのサイズを取得します。

mwply：Sofdec再生ハンドル

mode：合成モード MWSFD_ COMPO_~

なし

なし

Sofdec再生ハンドルに合成モードを設定します。

mwply：Sofdec再生ハンドル

なし

合成モードMWSFD_ COMPO_~

Sofdec再生ハンドルに設定されている合成モードを取得します。

mwply：Sofdec再生ハンドル

in_th：透過度変化の開始しきい値(0〜255)

out_th：透過度変化の終了しきい値(0〜255)

key：透過キー（MWSFD_LUMIKEY_BLACK, MWSFD_LUMIKEY_WHITE）

なし

なし

ルミナンスキー合成のパラメータを設定します。

mwply：Sofdec再生ハンドル

in_th：透過度変化の開始しきい値(0〜255)

out_th：透過度変化の終了しきい値(0〜255)

key：透過キー

なし

ルミナンスキー合成のパラメータを取得します。

mwply：Sofdec再生ハンドル

zero：透明部分のアルファ値(0〜255)

half：半透明部分のアルファ値(0〜255)

full：不透明部分のアルファ値(0〜255)

なし

なし

３値アルファ合成のパラメータを設定します。

３値アルファ合成用ムービは透明／半透明／不透明という区別に基づいてエンコードされていますので、値を大きく変更するとノイズが目立つ場合があります。主に半透明部分のアルファ値の調整に本関数を使用してください。

mwply：Sofdec再生ハンドル

zero：透明部分のアルファ値(0〜255)

half：半透明部分のアルファ値(0〜255)

full：不透明部分のアルファ値(0〜255)

なし

３値アルファ合成に使用する透明／半透明／不透明のアルファ値を取得します。

mwply：Sofdec再生ハンドル

frm：デコード結果フレーム情報

zout：出力先バッファポインタ

なし

デコード結果フレームから16bit/pixelのバッファにZ情報を変換します。

mwply：Sofdec再生ハンドル

frm：デコード結果フレーム情報

zout：出力先バッファポインタ

なし

デコード結果フレームから32bit/pixelのバッファにZ情報を変換します。

mwply：Sofdec再生ハンドル

znear：奥行きのnear値

zfar：奥行きのfar値

なし

なし

Z値変換に使用するＺクリップの値を設定します。

mwply：Sofdec再生ハンドル

znear：奥行きのnear値

zfar：奥行きのfar値

なし

Z値変換に使用するＺクリップの値を取得します。

mwply ：Sofdec再生ハンドル

func ：Ｚ変換テーブル作成コールバック関数

なし

なし

通常は使う必要のない関数です。

Ｚ変換テーブルの作成をライブラリ内ではなく、登録したコールバック関数で処理するようにできます。

mwply：Sofdec再生ハンドル

なし

合成モード（MWSFD_COMPO_~）

Sofdecファイルに埋め込まれた合成モード情報を取得します。

取得できる合成モードは以下の３種類です。

- MWSFD_COMPO_OPAQ : 不透明

- MWSFD_COMPO_ALPHFULL : フルアルファ合成

- MWSFD_COMPO_ALPH3 : ３値アルファ合成

Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

buf：解析するデータのアドレス

bsize：解析するデータのサイズ

hdrinf：ファイル情報構造体

なし

Sofdecファイルの内容を解析します。

Sofdecファイルの先頭20kbyteをメモリに読み込んで、引数で指定してください。

mwply：Sofdec再生ハンドル

なし

ビデオの総フレーム数

ビデオストリームの総フレーム数を取得します。

(a) Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

(b) Sofdecファイルでないと総フレーム数を取得できません。

for (;;) {
    MwsfdFrmObj frm;
    /* Main Loop */
    ADXM_ExecMain();
    if (mwPlyGetStat(mwply) == MWSFD_STAT_PLAYING) {
        numfrm = mwPlyGetTotalFrmNum(mwply);
    }
    mwPlyGetCurFrm(mwply, &frm);
    if (frm.bufadr != NULL) {
        /* Conversion of frame */
        /* Transfer texture to VRAM */
        UsrLoadMvFrmFx(mwply, &frm);
        mwPlyRelCurFrm(mwply);
    }
    UsrDrawMv();
}

mwply：Sofdec再生ハンドル

hdrinf：ファイル情報構造体

なし

現在再生中のムービファイルについて、情報を取得します。

mwPlyGetHdrInf関数の、リアルタイム版という位置づけになります。

(a) Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

(b) ムービ情報を取得できるのは SFD ファイルのみです。SFVファイルからは取得できません。

mallocfn：メモリ割当関数

freefn：メモリ解放関数

obj：メモリ割当／メモリ解放関数の引数に渡すオブジェクト

なし

なし

登録したメモリ割当／メモリ解放関数を使用して、Sofdec再生ハンドルの作業領域を確保することができます。メモリ割当は作業領域一括ではなく、複数回に分けて行います。
ハンドル生成時に確保したメモリは、ハンドル破棄時に解放します。
登録したメモリ割当／メモリ解放関数を使用する場合は、ハンドル生成時の生成パラメータで、作業領域アドレスをNULLにしてください。

登録したメモリ割当／メモリ解放関数は、ハンドル生成／消去の関数内でのみ使用します。
再生中や各種設定関数からメモリ割当／メモリ解放関数が呼び出されることはありません。

mwply：Sofdec再生ハンドル

speed：再生速度（1000で等速）

なし

なし

ムービの再生速度を設定します。
早回し（再生速度を上げる）がどこまで可能かは、デコード負荷やデータの読み込みレートに依存します。
そのため設定した速度よりも再生がゆっくりになることがあります。

オーディオ付きムービには再生速度設定ができない機種があります。

mwply：Sofdec再生ハンドル

mode：同期モード MWSFD_SYNCMODE_~

なし

なし

ムービ再生の同期モードを切り替えます。

本関数は再生開始前に呼び出した場合のみ有効です。

デフォルト値は入力ファイルの種別により次のように決まります。

ただし音付きSofdecファイルであっても、Sofdec再生ハンドルの生成時にファイルタイプで MWSFD_FTYPE_VONLYSFD を指定した場合はVsync同期になります。

mwply：Sofdec再生ハンドル

なし

MWSFD_SYNCMODE_AUDIO：オーディオ同期

MWSFD_SYNCMODE_VSYNC：Vsync同期

MWSFD_SYNCMODE_NONE：無同期

MWSFD_SYNCMODE_EXTCLOCK：外部クロック同期

ムービ再生のビデオ同期モードを取得します。

chno ：チャネル番号

なし

なし

Sofdecライブラリが指定するタイマチャネル番号を設定します。

タイマを使用しない設定にするには−1を指定します。

なし

なし

タイマチャネル番号

−１の場合はタイマ不使用。

Sofdecライブラリの使用するタイマのチャネル番号を取得します。

mwply：Sofdec再生ハンドル

bufptr：ユーザデータ格納用のバッファポインタ

bufsize：ユーザデータ格納用のバッファサイズ

size1pic：１ピクチャの最大ユーザデータサイズ

なし

なし

各フレームのユーザデータを取得するための設定関数です。

本関数でユーザデータ格納用バッファを設定すると、mwPlyGetCurFrm関数で取得するMwsfdFrmObj構造体のメンバusrdatptr, usrdatsizeにユーザデータのポインタとサイズが入るようになります。

もしユーザデータサイズがsize1picを越える場合は、size1picを越える部分は参照できません。

SofdecCRAFT は各フレームにユーザデータを埋め込む機能は未実装です。

mwply：Sofdec再生ハンドル

mode：同期モード MwsfdFrmSync

なし

なし

フレーム取得同期モードを切り替えます。mwPlyGetCurFrm関数の動作に影響します。

デフォルト値は同期無しモードです。

mwply：Sofdec再生ハンドル

なし

MWSFD_FRMSYNC_TIME：時刻同期。表示フレームの自動スキップあり。

MWSFD_FRMSYNC_NONE：同期無し。表示フレームの自動スキップ無し。

フレーム取得同期モードを取得します。

mwply ：Sofdec再生ハンドル

extclock_fn ：外部クロック関数

extclock_max ：クロック値の最大値。(8ビットの場合0x000000FF, 32ビットの場合0xFFFFFFFF)

extclock_usrobj ：ユーザオブジェクト(外部クロック関数の第1引数としてユーザに渡す)

なし

なし

ムービ再生の時刻管理を外部クロックを用いるようにするコールバック関数を登録します。

外部クロック関数には以下の要求条件があります。

- 常に同じペースで単調増加する値を返すこと。

- クロック値のオーバフローが発生する周期は時刻更新を行う周期より十分に大きいこと。（時刻更新周期は通常はVsync周期です。）

登録した外部クロック関数は次のタイミングで呼び出されます。

- ADXスレッド使用あり＋Sofdec時刻自動更新ONなら、Vsyncスレッドから。

- ADXスレッド使用なし＋Sofdec時刻自動更新ONなら、ADXM_ExecMain関数から。

- Sofdec時刻自動更新OFFなら、mwPlyUpdateTime関数から。

Sofdecライブラリは前回クロック値との差分が負値となることでオーバフロー発生を検出します。

オーバフロー検出時は、クロック値差分に clock_max + 1 を加算してオーバフローを補償します。

mwply ：Sofdec再生ハンドル

sw ：切り替えスイッチ（ON：時刻を自動更新する、OFF：時刻を自動更新しない）

なし

なし

Sofdecの時刻更新処理を自動で行うかどうかを設定します。

デフォルト値は「自動更新する」です。

設定を変更する場合は、再生開始前に呼び出してください。

「自動更新しない」に設定した場合は、アプリケーションでmwPlyUpdateTime関数を呼び出して明示的に時刻更新を行います。

本関数は、ADXのVsyncスレッドが正しくVsync周期で動作できないような環境で使用します。

Sofdecの時刻更新を自動で行う場合、時刻更新のタイミングは以下のように決まります。

- ADXスレッドを使用する場合は、Vsyncスレッド内。

- ADXスレッドを使用しない場合は、ADXM_ExecMain関数。

ADXスレッドを使用するには、ADX/Sofdecの初期化前に ADXM_SetupThrd関数またはADXM_SetupFramework関数を呼び出してください。

mwply：Sofdec再生ハンドル。NULL指定の場合は全ハンドル指定となる。

なし

なし

Sofdec時刻の更新処理を行います。

mwPlySetUpdateTimeAuto関数で「自動更新しない」設定にした場合に、毎メインループに１度呼び出してください。

呼び出し位置はなるべくいつもVsync区間の同じタイミング（Vsync待ち直後など）にしてください。

アプリケーションが処理落ちした場合でも複数回呼び出す必要はありません。

Sofdec時刻の自動更新がONの場合は、本関数を呼び出しても時刻更新は行いません。

なし

なし

バージョン番号文字列のポインタ

Sofdecライブラリバージョン番号の文字列へのポインタを取得します。

mwply：Sofdec再生ハンドル

sec：再生時間上限（秒単位）

なし

なし

ムービの再生時間上限を設定します。

再生時間が上限に達するとムービ再生中であっても再生を終了し、停止状態になります。

再生時間上限は以下の情報に依存して決まります。

　- Vsync周波数（Sofdecライブラリ初期化時のパラメータ）

　- オーディオ再生の有無

　- ムービのフレームレート

これらによって決まる再生時間上限よりも大きな値を設定することはできません。

一般的なVsync周波数における再生時間上限は次のようになります。

■音再生なし＋フレームレートが29.97fps

　59.94Hz：99時間31分11秒

　50.00Hz：119時間18分15秒

　60.00Hz：99時間25分12秒

■音再生あり

　59.94Hz：9時間57分06秒

　50.00Hz：11時間55分48秒

　60.00Hz：9時間56分30秒

音無しの場合は音あり再生と比べて再生時間上限は約10倍になります。

ただしムービのフレームレートが23.976の場合のみ4倍になります。

再生時間上限はハンドル状態がPLAYINGになった後に、mwPlyGetLimitTime関数を使うことで取得することができます。

mwply：Sofdec再生ハンドル

なし

再生時間上限（秒単位）

ムービの再生時間上限を取得します。

ハンドル状態がPLAYINGになった後に呼び出してください。

再生時間上限についてはmwPlySetLimitTime関数の説明を参照してください。

mwply：Sofdec再生ハンドル

plyinf：再生情報構造体

なし

再生時の統計情報を一括で取得します。

以下の情報は個々に別関数で取得可能です。

(a) コマ落ち ：mwPlyGetNumDropFrm

(b) デコードスキップ ：mwPlyGetNumSkipDec

(c) 表示スキップ ：mwPlyGetNumSkipDisp

(d) エンプティBスキップ ：mwPlyGetNumSkipEmptyB

各関数の返す情報の違いを以下に示します。

mwply：Sofdec再生ハンドル

なし

デコードした全ピクチャ数

再生開始後のデコードした全ピクチャ数を取得します。

mwply：Sofdec再生ハンドル

なし

デコード済み保持フレーム数を返します。

アプリケーションが最終フレームの取得および解放を行ったあとは-1を返します。

デコード済み保持フレーム数とは、MWSFDライブラリが内部で保持しているフレーム数のことです。ハンドル生成時のフレームプール数が上限になります。

mwply：Sofdec再生ハンドル

なし

コマ落ちしたフレーム数。エンプティBピクチャのスキップは含まない。

デコードスキップしたフレーム数を取得します。

エンプティBピクチャのスキップが有効な場合でも、取得できるスキップ数にはエンプティBピクチャのスキップは含みません。

mwply：Sofdec再生ハンドル

なし

デコードできなかったフレーム数

デコード処理中にコマ落ちしたフレーム数を取得します。

表示時刻までにデコードできないフレームがあった場合に、このカウントが増加します。

mwply：Sofdec再生ハンドル

なし

表示落ちしたフレーム数

表示処理中にコマ落ちしたフレーム数を取得します。

表示時刻までにフレームの取得が行われなかった場合に、このカウントが増加します。

mwply：Sofdec再生ハンドル

なし

スキップしたエンプティBピクチャの枚数

デコード処理中にスキップしたエンプティBピクチャの枚数を返します。

エンプティBピクチャのデコードを行う場合はこの値はカウントされません。

mwply ：Sofdec再生ハンドル

flowinf ：流量情報

なし

システムストリームのデータ流量を取得します。

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：スキップする、OFF：スキップしない）

なし

なし

Bピクチャのデコードを省略するか否かの設定を切り替えます。

デフォルト値はスキップ無しです。

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：スキップする、OFF：しない）

なし

なし

エンプティBピクチャのデコードを省略するか否かの設定を切り替えます。

デフォルト値はスキップ無しです。

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：スキップする、OFF：しない）

なし

なし

Pピクチャのデコードを省略するか否かの設定を切り替えます。

デフォルト値はスキップ無しです。

mwply：Sofdec再生ハンドル

なし

ADXTハンドル

Sofdec再生ハンドル内のADXTハンドルを取得します。

mwply：Sofdec再生ハンドル

なし

SJハンドル

デコーダへの入力SJハンドルを取得します。

mwply：Sofdec再生ハンドル

なし

ビデオデコーダハンドル

Sofdec再生ハンドル内のビデオデコーダハンドルを取得します。

mwply：Sofdec再生ハンドル

なし

取得可能フレーム数

新しく取得可能なフレーム数を取得します。取得済みのフレームは数に含みません。

この関数が0を返す時は、新しいフレームを取得することはできません。

なし

なし

なし

アイドルスレッドへ切り替え、次のVsync割り込みまでメインスレッドをスリープします。

MWSFD Ver.3.30以降では、ADXM_WaitVsync関数と同じ機能になりました。

アプリケーションのVsync待ち関数の代わりに、ADXM_WaitVsync関数を呼び出すようにしてください。

なし

なし

TRUE：サーバ区切り状態にある場合。

FALSE：サーバ区切り状態にない場合。

サーバ関数の区切り状態を問い合わせます。

サーバ区切り状態にある場合は再生停止やハンドル消去の処理時間が短くなります。サーバ区切り状態にない場合は同様の処理に不定の時間がかかります。

bufptr：デコード結果バッファアドレス

width：横ピクセル数

height：縦ピクセル数

YCbCrプレーン情報

なし

デコード結果バッファアドレスからY, Cb, Cr各成分のポインタと幅を求めます。

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：デコードする、OFF：デコードしない）

なし

なし

オーディオストリームのデコードON/OFFを設定します。

本関数は再生開始前に呼び出した場合のみ有効です。

(a) デコードスイッチをOFFにすると、オーディオチャネルのデコードが行われなくなるため、AV同期はVsyncによって行われます。

(b) 音声出力を抑制する（ミュートする）時は、出力ボリュームの設定により行ってください。

mwply：Sofdec再生ハンドル

なし

ビデオチャネル数

Sofdecファイル内のビデオチャネル数を取得します。

Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

mwply：Sofdec再生ハンドル

ch：ビデオチャネル番号（0〜15, 0:初期値）

なし

なし

複数ビデオストリームを含むSofdecファイルで、再生するビデオストリームを設定します。

mwply：Sofdec再生ハンドル

なし

0〜15 : 再生中のビデオストリームチャネル番号

-1 : ビデオ再生無しの場合、または再生開始前でチャネル番号が不明。

再生中のビデオストリームチャネル番号を取得します。

Sofdec再生ハンドルの状態がMWSFD_STAT_PLAYING（再生中）になった後に使用してください。

mwply：Sofdec再生ハンドル

sw：切り替えスイッチ（ON：デコードする、OFF：デコードしない）

なし

なし

ビデオストリームのデコードON/OFFを設定します。

mwply：Sofdec再生ハンドル

なし

なし

ハンドル毎のVsync処理を実行します。

mwply：Sofdec再生ハンドル

なし

TRUE：サーバの作業が残っている。

FALSE：サーバの作業は残っていない。

ハンドル毎のサーバ処理を実行します。通常アプリケーションは呼び出してはいけません。

なし

なし

TRUE：サーバの作業が残っている。

FALSE：サーバの作業は残っていない。

ADXのスレッド機能を使わない場合に呼び出す時刻更新サーバ関数です。

通常アプリケーションは呼び出してはいけません。

なし

なし

TRUE：サーバの作業が残っている。

FALSE：サーバの作業は残っていない。

ADXのスレッド機能を使わない場合に呼び出すデコードサーバ関数です。

通常アプリケーションは呼び出してはいけません。