###### (This function is part of SDL_mixer, a separate library from SDL.)
# Mix_FadeInChannelTimed

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

## Header File

Defined in [<SDL3_mixer/SDL_mixer.h>](https://github.com/libsdl-org/SDL_mixer/blob/main/include/SDL3_mixer/SDL_mixer.h)

## Syntax

```c
int Mix_FadeInChannelTimed(int channel, Mix_Chunk *chunk, int loops, int ms, int ticks);
```

## Function Parameters

|                          |             |                                                                                  |
| ------------------------ | ----------- | -------------------------------------------------------------------------------- |
| int                      | **channel** | the channel on which to play the new chunk, or -1 to find any available.         |
| [Mix_Chunk](Mix_Chunk) * | **chunk**   | the new chunk to play.                                                           |
| int                      | **loops**   | the number of times the chunk should loop, -1 to loop (not actually) infinitely. |
| int                      | **ms**      | the number of milliseconds to spend fading in.                                   |
| int                      | **ticks**   | the maximum number of milliseconds of this chunk to mix for playback.            |

## Return Value

(int) Returns which channel was used to play the sound, or -1 if sound
could not be played.

## Remarks

This will start the new sound playing, much like
[Mix_PlayChannel](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](Mix_Volume)() was called on it (which is to say: you probably
shouldn't call [Mix_Volume](Mix_Volume)() on a fading channel).

## Version

This function is available since SDL_mixer 3.0.0.

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategorySDLMixer](CategorySDLMixer)