目次 - SDL_mixer 3.0 - MIX_SetTrackStereo

MIX_SetTrackStereo

トラックを強制的に任意の左右パン設定でステレオ化する

ヘッダ

SDL3_mixer/SDL_mixer.h

構文

bool MIX_SetTrackStereo(MIX_Track *track, const MIX_StereoGains *gains);

引数

MIX_Track *track設定するトラック
const MIX_StereoGains *gainsチャネルごとのゲイン. NULLのとき空間化を無効にする

戻り値

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

詳細

この関数はトラックをステレオに変換して出力し,スピーカーの設定とは無関係に前面右と前面左のスピーカーのみとミックスする. 左右のチャネルはgainsに従って調整される. これはパンニング効果を生成するために使用できる. この関数はゲインを変更するためにいつでも呼べる.

gainsがNULLでない場合, トラックは強制ステレオモードに切り替わる. gainsがNULLの場合, 空間化(ステレオモードとMIX_SetTrack3DPosition()による完全3D空間化の両方)が無効になる.

負のゲインは0に制限される. 最大値の制限はなく, 1.0fより大きな値を設定してチャネルの音声を大きくできる.

MIX_GetTrack3DPosition()で報告されるトラックの3D位置は(0, 0, 0)にリセットされる.

スレッドセーフ

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

バージョン

SDL_image 3.0.0以降

関連項目

SDL Wikiへのリンク

SDL3_mixer/MIX_SetTrackStereo