NAME¶

Mix_SetSoundFonts - Set SoundFonts paths to use by supported MIDI backends.

SYNOPSIS¶

#include "SDL3_mixer/SDL_mixer.h"

int Mix_SetSoundFonts(const char *paths);

DESCRIPTION¶

You may specify multiple paths in a single string by separating them with semicolons; they will be searched in the order listed.

This function replaces any previously-specified paths.

Passing a NULL path will remove any previously-specified paths.

Note that unlike most SDL and SDL_mixer functions, this function returns zero if there's an error, not on success. We apologize for the API design inconsistency here.

FUNCTION PARAMETERS¶

paths

Paths on the filesystem where SoundFonts are available, separated by semicolons.

RETURN VALUE¶

Returns 1 if successful, 0 on error (out of memory).

AVAILABILITY¶

This function is available since SDL_mixer 3.0.0.