mixFadeInChannelTimed function

int mixFadeInChannelTimed(int channel, Pointer<MixChunk> chunk, int loops, int ms, int ticks,)

Play an audio chunk on a specific channel, fading in the audio, for a maximum time.

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).

ticks specifies the maximum number of milliseconds to play this chunk before halting it. If you want the chunk to play until all data has been mixed, specify -1.

Note that this function does not block for the number of ticks requested; it just schedules the chunk to play and notes the maximum for the mixer to manage later, and returns immediately.

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).

\param channel the channel on which to play the new chunk, or -1 to find any available. \param chunk the new chunk to play. \param loops the number of times the chunk should loop, -1 to loop (not actually) infinitely. \param ms the number of milliseconds to spend fading in. \param ticks the maximum number of milliseconds of this chunk to mix for playback. \returns which channel was used to play the sound, or -1 if sound could not be played.

\since This function is available since SDL_mixer 3.0.0.

extern SDL_DECLSPEC int SDLCALL Mix_FadeInChannelTimed(int channel, Mix_Chunk *chunk, int loops, int ms, int ticks)

Implementation

int mixFadeInChannelTimed(
    int channel, Pointer<MixChunk> chunk, int loops, int ms, int ticks) {
  final mixFadeInChannelTimedLookupFunction = libSdl3Mixer.lookupFunction<
      Int32 Function(Int32 channel, Pointer<MixChunk> chunk, Int32 loops,
          Int32 ms, Int32 ticks),
      int Function(int channel, Pointer<MixChunk> chunk, int loops, int ms,
          int ticks)>('Mix_FadeInChannelTimed');
  return mixFadeInChannelTimedLookupFunction(channel, chunk, loops, ms, ticks);
}