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

この再生状態は、ADXCS_GetStat関数により取得することができます。

ADXCSハンドルのフェード状態を表します。

このフェード状態は、ADXCS_GetFadeStat関数により取得することができます。

ADXCSハンドルのサウンドの種類を表します。

ハンドル作成時に何も指定しないと、サウンドの種類はADXCS_SND_TYPE_NONEになります。

コールバック関数の種類を表します。

ADXCS_SetCbFunc関数で登録したコールバック関数が呼ばれるときに、引数として渡されます。

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

このハンドルは、ADXCS_Create関数により生成されます。

ADXCSハンドルの生成に必要な情報を設定する構造体です。

使用するときは、初めに0で初期化してから必要なメンバに値を設定してください。

構造体のメンバは以下の通りです。

（１）max_stm、max_ch、max_sfreq、play_methodは、ADXのワーク領域サイズ計算マクロに渡す値と同じ意味です。

（２）max_aix_trackは、AIXのワーク領域サイズ計算マクロに渡す値と同じ意味です。

なし

なし

なし

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

再初期化する場合は、初期化前にADXCS_Finish関数を呼び出してください。

なし

なし

なし

ADXCSライブラリの終了処理を行います。

cprm ：ハンドル生成パラメータ構造体へのポインタ

work ：ワーク領域へのポインタ

work_size ：ワーク領域サイズ（単位：バイト）

なし

ADXCSハンドル（ハンドル生成に失敗したときはNULLを返す）

指定されたパラメータに応じたADXCSハンドルを生成します。ワーク領域サイズはADXCS_CalcWorkCprm関数で計算してください。

また、ハンドル生成パラメータ構造体は、初めに0で初期化してから必要なメンバに値を設定してください。

/* ハンドル生成パラメータ構造体の設定 */
memset(&cprm, 0, sizeof(cprm));
cprm.max_stm     = 1;                   /* 最大同時再生ストリーム数：1 */
cprm.max_nch     = 2;                   /* ステレオ                    */
cprm.max_sfreq   = 48000;               /* 48kHz                       */
cprm.play_method = ADXT_PLY_STM;        /* 再生方式：ストリーム再生    */
work_size = ADXCS_CalcWorkCprm(&cprm);  /* ワーク領域サイズを計算      */
work = (Sint8 *)malloc(work_size);      /* ワーク領域を確保            */
/* ADXCSハンドルの生成 */
adxcs = ADXCS_Create(&cprm, work, work_size);

adxcs ：ADXCSハンドル

なし

なし

ADXCS_Create関数で生成したADXCSハンドルを消去します。

cprm ：ハンドル生成パラメータ構造体へのポインタ

なし

ワーク領域サイズ（単位：バイト）

ハンドル生成パラメータ構造体から、ADXCSが必要とするワーク領域サイズを計算します。

この関数で計算したワーク領域サイズを、ADXCS_Create関数に指定します。

/* ハンドル生成パラメータ構造体の設定 */
memset(&cprm, 0, sizeof(cprm));
cprm.max_stm     = 1;                   /* 最大同時再生ストリーム数：1 */
cprm.max_nch     = 2;                   /* ステレオ                    */
cprm.max_sfreq   = 48000;               /* 48kHz                       */
cprm.play_method = ADXT_PLY_STM;        /* 再生方式：ストリーム再生    */
work_size = ADXCS_CalcWorkCprm(&cprm);  /* ワーク領域サイズを計算      */
work = (Sint8 *)malloc(work_size);      /* ワーク領域を確保            */
/* ADXCSハンドルの生成 */
adxcs = ADXCS_Create(&cprm, work, work_size);

adxcs ：ADXCSハンドル

なし

なし

ADXCSハンドルにAHX再生機能を組み込みます。この関数を実行すると、指定したADXCSハンドルでAHX音声データを再生できるようになります。

ハンドル生成時に、ハンドル生成パラメータ構造体のuse_ahxメンバをTRUEに設定しておく必要があります。

/* ハンドル生成パラメータ構造体の設定 */
memset(&cprm, 0, sizeof(cprm));
cprm.max_stm     = 1;                    /*    最大同時再生ストリーム数：1 */
cprm.max_nch     = 1;                    /*    モノラル                    */
cprm.max_sfreq   = 24000;                /*    24kHz                       */
cprm.play_method = ADXT_PLY_STM;         /*    再生方式：ストリーム再生    */
cprm.use_ahx     = TRUE;                 /*    AHXを使用する               */
work_size = ADXCS_CalcWorkCprm(&cprm);   /*    ワーク領域サイズを計算      */
work = (Sint8 *)malloc(work_size);       /*    ワーク領域を確保            */
/* ADXCSハンドルの生成 */
adxcs = ADXCS_Create(&cprm, work, work_size);
/* AHX再生機能の組み込み */
ADXCS_AttachAhx(adxcs);

adxcs ：ADXCSハンドル

なし

なし

ADXCSハンドルからAHX再生機能を分離します。この関数を実行すると、指定したADXCSハンドルでAHX音声データを再生できなくなります。

ハンドル生成時に、ハンドル生成パラメータ構造体のuse_ahxメンバをTRUEに設定しておく必要があります。

adxcs ：ADXCSハンドル

fname ：再生するファイル名

なし

なし

指定したファイルの再生を開始します。

（１）フェードインしながら再生が始まります。フェードインは、設定されたパラメータに従って行われます。

（２）ハンドル生成時に、ハンドル生成パラメータ構造体のuse_crossfadeメンバにTRUEを設定した場合、再生中の音声とのクロスフェードが行われます。

（３）ボイスハイライトが有効になっている場合にこの関数でセリフを再生すると、他のハンドルで再生中の音楽のボリュームが自動的に下がります。

adxcs ：ADXCSハンドル

patid ：パーティション識別子

fid ：ファイル識別子

なし

なし

パーティション識別子とファイル識別子で指定し、AFSファイル内のインサイドファイルを再生開始します。

フェードイン／クロスフェード／ボイスハイライトに関する機能はADXCS_StartFname関数と同様です。

adxcs ：ADXCSハンドル

dat ：メモリ内のデータへのポインタ

datlen ：データの長さ

なし

なし

メモリ内のデータを再生開始します。

フェードイン／クロスフェード／ボイスハイライトに関する機能はADXCS_StartFname関数と同様です。

adxcs ：ADXCSハンドル

acx ：メモリ内のACXデータへのポインタ

no ：再生する音声のインデックス番号

なし

なし

メモリ内のACXデータを再生開始します。ACXデータ中の音声データをインデックス指定します。

（１）フェードイン／クロスフェード／ボイスハイライトに関する機能はADXCS_StartFname関数と同様です。

（２）ハンドル生成パラメータ構造体のuse_aixメンバをTRUEにして生成したハンドルでは使用できません。

adxcs ：ADXCSハンドル

なし

なし

再生を停止します。

設定されたパラメータに従ってフェードアウトします。

adxcs ：ADXCSハンドル

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

なし

なし

ポーズおよびポーズ解除を行います。

ポーズ時のフェードアウトや、ポーズ解除時のフェードインは行いません。

adxcs ：ADXCSハンドル

なし

ON = ポーズ中、OFF = ポーズ中でない

ポーズ状態を取得します。

adxcs ：ADXCSハンドル

なし

ADXCSハンドルの状態（ADXCS_STAT_~）

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

ハンドルの再生状態は以下の通りです。

adxcs ：ADXCSハンドル

なし

ハンドル生成パラメータ構造体へのポインタ

指定したADXCSハンドルのハンドル生成パラメータ構造体を取得します。

adxcs ：ADXCSハンドル

flg ：ループフラグ（ON：ループする、OFF：ループしない）

なし

なし

ループフラグを設定します。

ADXT_SetLpFlg関数、AIXP_SetLpSw関数と同じ意味です。

adxcs ：ADXCSハンドル

type ：サウンドの種類（ADXCS_SND_TYPE_~）

なし

なし

サウンドの種類を設定します。

サウンドの種類は以下の通りです。

adxcs ：ADXCSハンドル

なし

サウンドの種類（ADXCS_SND_TYPE_~）

サウンドの種類を取得します。

adxcs ：ADXCSハンドル

vol ：基本出力ボリューム（0：0[dB] 〜 -960：-96.0[dB]）

なし

なし

基本出力ボリュームを設定します。基本出力ボリュームとは、フェードやボイスハイライト機能によって増減する分を含まない、基準となるボリュームです。

実際に適用される出力ボリュームは、フェード状況やボイスハイライト機能の状態によって変化します。

adxcs ：ADXCSハンドル

なし

基本出力ボリューム（0：0[dB] 〜 -960：-96.0[dB]）

基本出力ボリュームを取得します。

フェードやボイスハイライトによって増減している分は含みません。

実際に適用されている出力ボリュームを取得したいときは、ADXTハンドルを取得し、ADXT_GetOutVol関数により取得してください。

adxcs ：ADXCSハンドル

trno ：トラック番号

vol ：基本出力ボリューム（0：0[dB] 〜 -960：-96.0[dB]）

なし

なし

AIXのトラックごとの基本出力ボリュームを設定します。

ここで設定されるのは基本出力ボリュームです。実際に適用される出力ボリュームは、フェード状況やボイスハイライトの状態によって変化します。

adxcs ：ADXCSハンドル

trno ：トラック番号

なし

トラックごとの基本出力ボリューム（0：0[dB] 〜 -960：-96.0[dB]）

トラックごとの基本出力ボリュームを取得します。

フェードやボイスハイライトによって増減している分は含みません。

実際に適用されている出力ボリュームを取得したいときは、内部のAIXPハンドルを取得して、そこから取得してください。

adxcs ：ADXCSハンドル

time ：フェードアウト時間（単位：Vsync）

なし

なし

フェードアウト時間を設定します。

引数timeに60を指定すると、フェードアウト時間は約１秒になります。

デフォルト値は30です。

adxcs ：ADXCSハンドル

なし

フェードアウト時間（単位：Vsync）

フェードアウト時間を取得します。

adxcs ：ADXCSハンドル

time ：フェードイン時間（単位：Vsync）

なし

なし

フェードイン時間を設定します。

引数timeに60を指定すると、フェードイン時間は約１秒になります。

デフォルト値は0です。（フェードインせずに再生開始）

adxcs ：ADXCSハンドル

なし

フェードイン時間（単位：Vsync）

フェードイン時間を取得します。

adxcs ：ADXCSハンドル

time ：ボリューム変更時間（単位：Vsync）

なし

なし

ボリューム変更時間を設定します。

引数timeに60を指定すると、ボリューム変更時間は約１秒になります。

デフォルト値は0です。（瞬時にボリューム変更）

adxcs ：ADXCSハンドル

なし

ボリューム変更時間（単位：Vsync）

ボリューム変更時間を取得します。

adxcs ：ADXCSハンドル

offset ：フェードアウトからの相対フェードイン開始時刻オフセット（単位：Vsync）

なし

なし

クロスフェード時の、フェードアウト開始からフェードイン開始までの時刻オフセットを設定します。負の値を設定すると、フェードアウトより先にフェードインが開始します。

デフォルト値は0です。（同時に開始）

adxcs ：ADXCSハンドル

なし

フェードアウトからの相対フェードイン開始時刻オフセット（単位：Vsync）

クロスフェード時の、フェードアウト開始からフェードイン開始までの時刻オフセットを取得します。

adxcs ：ADXCSハンドル

delay ：フェード後のディレイ時間（単位：Vsync）

なし

なし

フェード後のディレイ時間を設定します。

（１）デフォルト値は60です。

（２）再生停止処理、フェード状態の更新、およびコールバックの呼び出しは、ディレイ時間経過後に行われます。

（３）サウンドドライバ、またはハードウェアの仕様上、ボリュームを設定してから実際に反映されるまでに遅延がある場合に設定します。

adxcs ：ADXCSハンドル

なし

フェード後のディレイ時間の取得（単位：Vsync）

フェード後のディレイ時間を取得します。

adxcs ：ADXCSハンドル

なし

アクティブなADXTハンドル

アクティブなADXTハンドルを取得します。

（１）ハンドル生成パラメータ構造体のuse_aixメンバがTRUEの場合、AIXPハンドルで再生しているため、常にNULLが返ります。AIXPハンドルが必要な時は、ADXCS_GetActiveAixp関数を使用してください。

（２）ハンドル生成パラメータ構造体のuse_crossfadeメンバがFALSEの場合、常に同じハンドルが取得されます。

adxcs ：ADXCSハンドル

なし

次のADXTハンドル

次のADXTハンドルを取得します。

（１）ハンドル生成パラメータ構造体のuse_aixメンバがTRUEの場合、AIXPハンドルで再生しているため、常にNULLが返ります。AIXPハンドルが必要な時は、ADXCS_GetNextAixp関数を使用してください。

（２）ハンドル生成パラメータ構造体のuse_crossfadeメンバがFALSEの場合、常に同じハンドルが取得されます。

adxcs ：ADXCSハンドル

index ：ADXTハンドルのインデックス番号（0 or 1）

なし

指定したインデックス番号のADXTハンドル

インデックス番号を指定してADXTハンドルを取得します。

（１）ハンドル生成パラメータ構造体のuse_aixメンバがTRUEの場合、AIXPハンドルで再生しているため、常にNULLが返ります。AIXPハンドルが必要な時は、ADXCS_GetAixp関数を使用してください。

（２）ハンドル生成パラメータ構造体のuse_crossfadeメンバがTRUEの場合、ADXCSハンドルは内部にADXTハンドルを2つ保持しています。引数のインデックス番号は、その2つのADXTハンドルのいずれかを判別するためのものです。

（３）ハンドル生成パラメータ構造体のuse_crossfadeメンバがFALSEの場合、0番のみ指定できます。

adxcs ：ADXCSハンドル

なし

ADXTハンドルの数

ADXCSハンドル内のADXTハンドルの数を取得します。

ハンドル生成パラメータ構造体のuse_aixメンバがTRUEの場合、AIXPハンドルで再生しているため、常に0が返ります。

adxcs ：ADXCSハンドル

なし

アクティブなAIXPハンドル

アクティブなAXIPハンドルを取得します。

ハンドル生成パラメータ構造体のuse_aixメンバがFALSEの場合、ADXTハンドルで再生しているため、常にNULLが返ります。ADXTハンドルが必要な時は、ADXCS_GetActiveAdxt関数を使用してください。

adxcs ：ADXCSハンドル

なし

次のAIXPハンドル

次のAIXPハンドルを取得します。

ハンドル生成パラメータ構造体のuse_aixメンバがFALSEの場合、ADXTハンドルで再生しているため、常にNULLが返ります。ADXTハンドルが必要な時は、ADXCS_GetNextAdxt関数を使用してください。

adxcs ：ADXCSハンドル

index ：AIXPハンドルのインデックス番号（0 or 1）

なし

指定したインデックスのAIXPハンドル

インデックス指定でAIXPハンドルを取得します。

（１）ハンドル生成パラメータ構造体のuse_aixメンバがFALSEの場合、ADXTハンドルで再生しているため、常にNULLが返ります。ADXTハンドルが必要な時は、ADXCS_GetAdxt関数を使用してください。

（２）ハンドル生成パラメータ構造体のuse_crossfadeメンバがTRUEの場合、ADXCSハンドルは内部にAIXPハンドルを2つ保持しています。引数のインデックス番号は、その2つのAIXPハンドルのいずれかを判別するためのものです。

（３）ハンドル生成パラメータ構造体のuse_crossfadeメンバがFALSEの場合、0番のみ指定できます。

adxcs ：ADXCSハンドル

なし

AIXPハンドルの数

ADXCSハンドル内のAIXPハンドルの数を取得します。

ハンドル生成パラメータ構造体のuse_aixメンバがFALSEの場合、ADXTハンドルで再生しているため、常に0が返ります。

adxcs ：ADXCSハンドル

なし

なし

フェード処理をキャンセルし、フェードしながら元の音量に戻します。

クロスフェード時に、先にフェードアウトが終わって停止してしまった場合、キャンセルしても再生は再開されません。

adxcs ：ADXCSハンドル

なし

フェード状態（ADXCS_FADE_STAT_~）

フェード状態を取得します。

フェード状態は以下の通りです。

adxcs ：ADXCSハンドル

fn ：フェードコールバック関数へのポインタ

なし

なし

フェードコールバック関数を登録します。

フェードコールバック関数の引数cb_typeにはコールバック関数の種類が入ります。コールバック関数の種類は以下の通りです。

なし

なし

なし

ボイスハイライト機能を有効にします。

なし

なし

なし

ボイスハイライト機能を無効にします。

dec_time ：ボリューム減少に要する時間（単位：Vsync）

なし

なし

ボイスハイライトで音楽のボリュームを下げる時の、ボリューム減少に要する時間を設定します。

引数dec_timeに60を指定すると、ボリューム減少に要する時間は約１秒になります。

デフォルト値は30です。

なし

なし

ボリューム減少に要する時間（単位：Vsync）

ボイスハイライトで音楽のボリュームを下げる時の、ボリューム減少に要する時間を取得します。

inc_time ：ボリューム増加に要する時間（単位：Vsync）

なし

なし

ボイスハイライトで音楽のボリュームを元に戻すとき時の、ボリューム増加に要する時間を設定します。

引数inc_timeに60を指定すると、ボリューム増加に要する時間は約１秒になります。

デフォルト値は60です。

なし

なし

ボリューム増加に要する時間（単位：Vsync）

ボイスハイライトで音楽のボリュームを元に戻すとき時の、ボリューム増加に要する時間を取得します。

dec_vol ：ボリューム減少量（0：0[dB] 〜 960：96.0[dB]）

なし

なし

ボイスハイライトで音楽のボリュームを下げる時の減少量を設定します。

デフォルト値は120です。（12[dB]）

なし

なし

ボリューム減少量（0：0[dB] 〜 960：96.0[dB]）

ボイスハイライトで音楽のボリュームを下げる時の減少量を取得します。