目次 - 4.関数 - 4.4グループ - Mix_FadeOutGroup

Mix_FadeOutGroup

int Mix_FadeOutGroup(int tag, int ms)

tag
フェードアウトするグループ. メモ: -1を指定しても全チャネルをフェードアウトしない. 代わりにMix_FadeOutChannel(-1)を使うこと
ms
現在のボリュームから無音までのフェードアウト時間(ミリ秒)

グループ番号tagのチャネルを現在のボリュームからmsミリ秒で徐々にフェードアウトさせる. フェードアウトが完了すると, そのチャネルは停止する. 一時停止を含む再生中のチャネルのみフェードアウトを設定できる. フェードアウトが完了すると, それぞれのチャネルに対してMix_ChannelFinishedで設定したコールバック関数が呼ばれる.

戻り値: フェードアウトを設定したチャネルの数

サンプルコード

// 3秒間でグループ1のチャネルをフェードアウトさせる
printf("%dつのチャネルでフェードアウトを開始した¥n", Mix_FadeOutGroup(1, 3000));

参照

Mix_HaltGroup, Mix_FadeOutChannel, Mix_FadingChannel, Mix_ChannelFinished

原文へのリンク

4.4.8 Mix_FadeOutGroup