bool MIX_SetTrackRawIOStream(MIX_Track *track, SDL_IOStream *io, const SDL_AudioSpec *spec, bool closeio);
| MIX_Track * | track | 新しいオーディオ入力を設定するトラック |
| SDL_IOStream * | io | トラックの入力として使用するI/Oストリーム |
| const SDL_AudioSpec * | spec | SDL_IOStreamが提供するPCMデータの形式 |
| bool | closeio | 真のとき使用し終えたときSDL_IOStreamを閉じる |
これはトラックへの入力としては推奨しないが, 極めて限定的な状況では有用な手段になりうる: 一度だけ再生する大きなファイルをディスクから必要の応じて小さなチャンクで読み込む場合である. しかしほとんどの場合は先にMIX_Audioを生成してMIX_SetTrackAudio()を使用する方がよい.
MIX_SetTrackAudioStream()もトラックにSDL_AudioStreamで無圧縮PCMデータを提供できる. データを既に直接SDL_IOStreamから得ているのでなければ, こちらの方が望ましいかもしれない.
ここではストリームは無圧縮PCM形式のオーディオデータの必要がある.
与えられたI/Oストリームは一度に1つのトラックしか割り当てられない. 複数を割り当ててもエラーは戻さないが, 1つのストリームを複数のトラックに割り当てるとそれぞれのトラックがストリームから不規則に読み取り, 混乱や誤ったミキシング, デコードの失敗が発生する.
トラックが有効なオーディオ入力を得られたら, MIX_PlayTrack()または可能ならばMIX_PlayTag()を呼んでミキシングを開始できる.
この関数のI/OストリームにNULLを渡すことができる. この場合はトラックから入力を取り除く. トラックが再生中の場合, ミキサーの処理が行われる次のタイミングで認識され, トラックの停止がマークされ割り付けられたMIX_TrackStoppedCallbackが呼ばれる.
トラックの再生中にオーディオ入力を変更することはできる. しかし, 一部の設定, 例えばループ位置は, 新しいオーディオでは意味をなさなくなる場合がある. このような場合は, MIX_PlayTrackを再び呼んでパラメータを修正すること.
渡されたI/Oストリームはトラックが必要がなくなるまで有効を保つ必要がある(トラックの入力を変えた, またはトラックを破棄した場合でも).
この関数はどのスレッドからも安全に呼べる.