bool MIX_SetTrackAudio(MIX_Track *track, MIX_Audio *audio);
| MIX_Track * | track | 新しいオーディオ入力を設定するトラック |
| MIX_Audio * | audio | 新しいオーディオ入力. NULLも可 |
MIX_AudioはRAMに格納されたオーディオデータ(圧縮されている場合もある)である. 1つのMIX_Audioを複数のトラックに割り当てることもできる.
トラックが有効なオーディオ入力を得られたら, MIX_PlayTrack()または可能ならばMIX_PlayTag()を呼んでミックスを開始できる.
この関数のオーディオ入力としてNULLを渡すことができる. この場合はトラックからオーディオ入力を取り除く. トラックが再生中の場合, ミキサーの処理が行われる次のタイミングで認識され, トラックの停止がマークされ割り付けられたMIX_TrackStoppedCallbackが呼ばれる.
トラックの再生中にオーディオ入力を変更することはできる. しかし, 一部の設定, 例えばループ位置は, 新しいオーディオでは意味をなさなくなる場合がある. このような場合は, MIX_PlayTrackを再び呼んでパラメータを修正すること.
トラックは割り付けられたMIX_Audioへの参照を保持するため, トラックが使用中でもMIX_DestroyAudio()を安全に呼べる. トラックがこの参照を失ったとき(そして恐らくこのとき資源を解放する)MIX_Audioは使用されなくなる.
この関数はどのスレッドからも安全に呼べる.