目次 - SDL_mixer - API(機能別) - 音楽 - Mix_LoadMUS

Mix_LoadMUS

音楽ファイルを音楽オブジェクトに読み込む

構文

Mix_Music *Mix_LoadMUS(const char *file)

引数

file読み込む音楽ファイルのパス

戻り値

新しい音楽オブジェクトを戻す. エラーのときNULLを戻す.

詳細

SDL_mixerには2つのオーディオデータ構造がある. 1つは「チャンク」で, これは事前にファイルを完全にメモリにデコードする. もう1つは「音楽」で, ファイルを必要に応じてデコードする. 当初はWAVの様な無圧縮の単純な形式をチャンク, MP3等を音楽として, 1つの音楽をBGMとしてストリーム再生し, チャンクを効果音として繰り返し再生することを意図していた.

現在では形式による違いはなく, ほぼ相互に交換可能で, 事前にデコードした方がアプリケーションにとってよいかの問題となっている. チャンクはより多くのメモリを使用するが, 一度読み込めば再度デコードすることはない. 一方, 音楽は再生のたびに常にデコードする必要がある. さらに決定的なのは, アプリケーションには多くのチャンクのチャネルを確保できるが, 「音楽」チャネルは1つしか提供されていない.

音楽を使用し終えたならば, アプリケーションはMix_FreeMusic()を呼んで解放する必要がある.

バージョン

SDL_mixer 2.0.0以降

関連項目(関数)

Mix_FreeMusic

SDL Wikiへのリンク

SDL2_mixer/Mix_LoadMUS