目次 - SDL_mixer 3.0 - MIX_LoadRawAudio_IO

MIX_LoadRawAudio_IO

SDL_IOStreamから生PCMデータを読み込む

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

MIX_Audio * MIX_LoadRawAudio_IO(MIX_Mixer *mixer, SDL_IOStream *io, const SDL_AudioSpec *spec, bool closeio);

引数

MIX_Mixer *mixerオーディオデータを使用するミキサー. NULLも可
SDL_IOStream *ioデータの読込元のSDL_IOStream
const SDL_AudioSpec *specオーディオデータの形式
boolcloseio真のとき戻る前にSDL_IOStreamを自動的に閉じる. 偽のとき開いたままにする

戻り値

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

詳細

これは生PCMのストリーミングの別の選択肢である: SDL_AudioStreamSDL_IOStreamと同様にトラックに結びつけることができ, ミックスのとき必要に応じてこれらのデータ源から読み込まれる. この関数は複数回再生する目的で静的なオーディオデータを読み込む場合に便利である.

この関数は生データを全て読み込み, RAMにコピーして保持する.

MIX_Audioオブジェクトは複数のミキサーで共有できる. mixer引数はこのオーディオを最も使うミキサーを示唆するもので, 最適化が適用される場合があるが, 必須ではなくミキサーとしてNULLを指定することもできる.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_LoadAudio