Tween

AtomExプレーヤーのパラメーター（ボリュームやピッチ等）を一定時間かけて変更する手段として、AtomライブラリにはTweenという機能が存在します。

Tweenについて

Tweenは「特定のパラメーター」を「指定した時間」で「目的の値に変化させる」ためのモジュールです。
Tweenを使うことで「ボリュームを0.5秒後に0に落とす」といった操作が簡単に実装可能です。

Tweenは AtomEx プレーヤーにアタッチして使います。
具体的な操作手順は以下のとおりです。

操作したいパラメーターに対応したTweenハンドルを criAtomExTween_Create 関数で作成する。
作成したTweenハンドルを criAtomExPlayer_AttachTween 関数でAtomExプレーヤーにアタッチする。
（必要に応じて criAtomExPlayer_Start 関数等で再生を行う。）
criAtomExTween_MoveTo 関数を実行し、パラメーターを変化させる。

例えば、以下のコードでボリュームを0.5秒かけて落とすことが可能です。

        ：
    /* ボリュームをフェードするTweenの作成 */
    CriAtomExTweenConfig config;
    criAtomExTween_SetDefaultConfig(&config);
    config.parameter_type = CRIATOMEX_PARAMETER_TYPE_BASIC;
    config.id.parameter_id = CRIATOMEX_PARAMETER_ID_VOLUME;
    CriAtomExTweenHn tween = criAtomExTween_Create(&config, NULL, 0);

    /* Tweenをプレーヤーにアタッチ */
    criAtomExPlayer_AttachTween(player, tween);

    /* 再生を開始 */
    criAtomExPlayer_Start(player);
        ：
    /* 0.5秒（＝500ミリ秒）かけてボリュームを落とすよう指示 */
    criAtomExTween_MoveTo(tween, 500, 0.0f);
        ：

備考:

Tweenはランタイム向けの機能です。
ツール上でTweenに関する設定を行うことはできません。

操作可能なパラメーターについて

Tweenで操作するパラメーターは、Tweenハンドル作成時に指定します。
パラメーターの指定は、大きく分けて以下の2パターンがあります。

CRIATOMEX_PARAMETER_TYPE_BASIC
CRIATOMEX_PARAMETER_TYPE_AISAC

ボリュームやパン、ピッチといった一般的なパラメーターを制御する場合、 CriAtomExTweenConfig 構造体の parameter_type に CRIATOMEX_PARAMETER_TYPE_BASIC を設定し、 id.parameter_id に制御したいパラメーターのIDを指定します。
Tweenを使用してAISACコントロール値を制御したい場合、 CriAtomExTweenConfig 構造体の parameter_type に CRIATOMEX_PARAMETER_TYPE_AISAC を設定し、 id.aisac_control_id に制御したいAISACコントロールIDを指定します。

備考:

CRIATOMEX_PARAMETER_TYPE_BASIC 指定時に操作可能なパラメーターの一覧については、リファレンスの CriAtomExParameterId を参照してください。