int Mix_FadeInChannelTimed(int channel, Mix_Chunk *chunk, int loops, int ms, int ticks)
| channel | 新しいチャンクを再生するチャネル. -1のとき可能なチャネルを探す |
| chunk | 新しく再生するチャンク |
| loops | チャンクを再生する回数. -1のとき無限にループする |
| ms | フェードインのミリ秒単位の時間 |
| ticks | チャンクのミリ秒単位の再生時間 |
この関数はMix_PlayChannel()と同じように新しいチャンクを再生するが, 無音から通常のボリュームまで指定のミリ秒時間でフェードインしながら再生する.
channelに-1を指定すると, 空いている最初のチャネルで再生する. (そして空いているチャネルがない場合は, -1を戻し何も再生しない.)
channelに特定のチャネルを指定すると, そのチャネルが既に再生中の場合はチャンクを中断して新しいチャンクと置き換える.
loopsが0より大きい場合, その回数だけ再生する. loopsが-1の場合, 「無限」(65000回)に再生する.
ticksはチャンクの再生ミリ秒時間である. チャンクの全データ分を再生する場合は-1を指定すること.
この関数はticksで設定した時間ブロックされないので注意すること. チャンクの停止までの時間を設定して, ミキサーの後の管理のために時間を記録し, すぐに復帰する.
フェード中のチャネルは, その最中にMix_Volume()が呼ばれても, ボリュームが徐々に変化する. (言い換えると, フェード中のチャネルにはMix_Volume()を呼んでも無意味である.)