table of contents
- experimental 3~git20240319~12fb85e+ds-1
Mix_FadeInChannel(3) | SDL_mixer3 FUNCTIONS | Mix_FadeInChannel(3) |
NAME¶
Mix_FadeInChannel - Play an audio chunk on a specific channel, fading in the audio.
SYNOPSIS¶
#include "SDL3_mixer/SDL_mixer.h"
int Mix_FadeInChannel(int channel, Mix_Chunk *chunk, int loops, int ms);
DESCRIPTION¶
This will start the new sound playing, much like
Mix_PlayChannel () will, but will start the sound playing at silence and fade in to its normal volume over the specified number of milliseconds.
If the specified channel is -1, play on the first free channel (and return -1 without playing anything new if no free channel was available).
If a specific channel was requested, and there is a chunk already playing there, that chunk will be halted and the new chunk will take its place.
If loops is greater than zero, loop the sound that many times. If loops is -1, loop "infinitely" (~65000 times).
A fading channel will change it's volume progressively, as if
Mix_Volume () was called on it (which is to say: you probably shouldn't call Mix_Volume () on a fading channel).
Note that before SDL_mixer 3.0.0, this function was a macro that called
Mix_FadeInChannelTimed () with a fourth parameter
("ticks") of -1. This function still does the same thing, but
promotes it to a proper API function. Older binaries linked against a newer
SDL_mixer will still call Mix_FadeInChannelTimed
directly, as they are using the macro, which was available since the dawn of
time.
FUNCTION PARAMETERS¶
RETURN VALUE¶
Returns which channel was used to play the sound, or -1 if sound could not be played.
AVAILABILITY¶
This function is available since SDL_mixer 3.0.0
SDL_mixer 3.0.0 | SDL_mixer |