目次 - SDL_mixer 3.0 - MIX_LoadAudio

MIX_LoadAudio

ファイルから再生するオーディオデータを読み込む

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

MIX_Audio * MIX_LoadAudio(MIX_Mixer *mixer, const char *path, bool predecode);

引数

MIX_Mixer *mixerオーディオデータを使用するミキサー. NULLも可
const char *pathデータを読み込むファイルのパス
boolpredecode真のとき, この関数から戻る前に圧縮されたデータを全て展開する

戻り値

(MIX_Audio *) ミキサーで音声を発生させるために使用できるオーディオオブジェクトを戻す. 失敗のときNULLを戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

これは次の呼び出しと同じである:

MIX_LoadAudio_IO(mixer, SDL_IOFromFile(path, "rb"), predecode, true);

この関数はファイルシステムのパスからデータを読み込む. SDL_IOStreamから読み込むもの(MIX_LoadAudio_IO())や, プロパティで全てを制御できるもの(MIX_LoadAudioWithProperties())もある.

スレッドセーフ

この関数はどのスレッドからも安全に呼べる.

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_LoadAudio