目次 - 4.関数 - 4.1一般 - Mix_GetSoundFonts

Mix_GetSoundFonts

MIDIバックエンドで使用されるサウンドフォントのパスを得る

構文

const char *Mix_GetSoundFonts(void)

セミコロンで区切られたサウンドフォントパスの一覧

この関数が何を戻すかは複数の要素で決まる:

ブール値のSDLヒント"SDL_FORCE_SOUNDFONTS"が設定されていて, かつ環境変数"SDL_SOUNDFONTS"も設定されている場合, この関数はMix_SetSoundFounts()が呼ばれたかに関わらず環境変数の値を戻す.
そうではない場合, もしMix_SetSoundFonts()がNULLではないパスで正常に呼ばれたならば, この関数は渡された文字列を戻す.
そうではない場合, もし環境変数"SDL_SOUNDFONTS"が設定されていれば, この関数は環境変数の値を戻す.
そうではない場合, この関数はファイルシステムのいくつかの一般的な場所を検索し, サウンドフォントを見つけたならばそれを戻す.
全て一致しない場合, この関数はNULLを戻す.

この戻り値は内部(恐らく読込専用)メモリへのポインタで, 編集や呼び出し側からの解放を行ってはならない.

SDL 2.0.0以降