目次 - SDL_mixer 3.0 - MIX_GetMixerFormat

MIX_GetMixerFormat

ミキサーが生成するオーディオの形式を得る

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_GetMixerFormat(MIX_Mixer *mixer, SDL_AudioSpec *spec);

引数

MIX_Mixer *mixer問い合わせるミキサー
SDL_AudioSpec *specミキサーのオーディオ形式の代入先へのポインタ

戻り値

(bool) 成功のとき真, エラーのとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

詳細

一般的には, SDL_mixerは必要に応じてアプリケーションが提供した入力から出力の形式にデータを変換するため, この情報は必要がない. しかし, これは入力の形式を一致させて変換と再サンプリングのコストを軽減させる場合に有用である.

MIX_CreateMixerDevice()で生成したミキサーの場合, これはオーディオデバイスの形式である. (そして, 後でデバイスが変わると変化する場合があるが, SDL_mixerはこの変化を内部で途切れることなく処理する.)

MIX_CreateMixer()で生成したミキサーの場合, これはMIX_Generate()が生成する形式で, 要求した形式と同じであり変化しない.

SDL_mixerは指定した形式で出力する前にSDL_AUDIO_F32形式で処理を行うため, 入力形式を最終的な出力形式ではなくこの形式に合わせるとより効率的になることに注意すること.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

SDL Wikiへのリンク

SDL3_mixer/MIX_GetMixerFormat