bool MIX_TagTrack(MIX_Track *track, const char *tag);
| MIX_Track * | track | タグを追加するトラック |
| const char * | tag | 追加するタグ |
タグにはUTF-8でコード化したあらゆる有効なC文字列を設定できる. これは様々な目的でトラックをグループ化する場合に有用である. 例えばゲーム中で使用する全てのトラックに"game"をマークすると, ユーザが設定メニューを開いたとき, アプリケーションは即座にゲームプレーに関係する全てのトラックを一時停止させるがBGMと効果音は継続するようなことができる.
トラックにはマシンのメモリが許す限りいくつでもタグをつけることができる.
同じタグを1つのトラックに複数回追加しようとしても問題ない. 余分な追加は成功を戻すが何も変わらない.
タグは後でMIX_UntagTrack()で取り除くことができる.
この関数はどのスレッドからも安全に呼べる.