MIX_Audio * MIX_LoadAudioWithProperties(SDL_PropertiesID props);
| SDL_PropertiesID | props | オーディオ読み込みの方法のプロパティグループ |
様々なLoadAudio関数の機能の説明はMIX_LoadAudio_IO()を参照すること. この関数はプロパティで動作を指示することができ, 他の関数には提供されていない機能が使用できる.
SDL_PropertiesIDについてはSDLのドキュメントに記述がある. これらのプロパティに対応している:
MIX_PROP_AUDIO_LOAD_IOSTREAM_POINTER: オーディオデータの読み込みで使用するSDL_IOStreamへのポインタ. このストリームはシーク可能の必要がある
MIX_PROP_AUDIO_LOAD_CLOSEIO_BOOLEAN: 真のときSDL_mixerは戻る前に(成功でも失敗でも)SDL_IOStreamを閉じる
MIX_PROP_AUDIO_LOAD_PREDECODE_BOOLEAN: 真のとき, この関数から戻る前に圧縮されたデータを全て展開する. 偽のとき元のまま保存し必要なとき展開する
MIX_PROP_AUDIO_LOAD_PREFERRED_MIXER_POINTER: MIX_Mixerへのポインタ. 必要なときこの形式に合うように展開する. 任意
MIX_PROP_AUDIO_LOAD_SKIP_METADATA_TAGS_BOOLEAN: 真のときID3やAPEタグのようなメタデータの解析を省略する. これはデータのタグを使用しないとき読み込みの速度を向上させるために使用できる. 一部のデコーダはこのプロパティが真のときタグが存在するとき失敗する
MIX_PROP_AUDIO_LOAD_IGNORE_LOOPS_BOOLEAN: 真のときループポイントを表すメタデータを無視する. これはファイルがループするように指示していてもファイルを最初から最後までループせずにデコードする. オーディオはこの設定とは無関係にMIX_Trackループ設定をしてループさせることもできる. デフォルトは偽
MIX_PROP_AUDIO_DECODER_STRING: このデータが使用するデコーダの名前. 任意. 指定しない場合, SDL_mixerはデータをチェックし最適なデコーダを選択する. これらの名前はMIX_GetAudioDecoder()が戻すものと同じである
特定のデコーダは, 例えばMIDI再生のサウンドフォントの場所のような追加のカスタムプロパティを受け付ける.
この関数はどのスレッドからも安全に呼べる.