Función Mix_FadeInChannelTimed
Sintaxis
int Mix_FadeInChannelTimed(int channel, Mix_Chunk *chunk, int loops, int ms, int ticks);
Descripción
Reproduce un fragmento de audio en un canal específico, incrementando el volumen del audio, durante un tiempo máximo.
Parámetros
- channel
- El canal en el que reproducir el nuevo chunk, o -1 si no hay ninguno disponible.
- chunk
- El nuevo chunk a reproducir.
- loops
- El número de veces que el chunk debe reproducirse en bucle, -1 para reproducirlo (no realmente) infinitamente.
- ms
- El número de milisegundos a gastar en el fundido de entrada.
- ticks
- El número máximo de milisegundos de este chunk a mezclar para la reproducción.
Valor de retorno
Devuelve qué canal se utilizó para reproducir el sonido, o -1 si no se pudo reproducir el sonido.
Observaciones
Esto iniciará la reproducción del nuevo sonido, de forma muy similar a como lo haría Mix_PlayChannel(), pero iniciará la reproducción del sonido en silencio y se incrementará a su volumen normal durante el número de milisegundos especificado.
Si el canal especificado es -1, reproduce en el primer canal libre (y devuelve -1 sin reproducir nada nuevo si no hay ningún canal libre disponible).
Si se solicitó un canal específico, y ya hay un trozo reproduciéndose allí, ese trozo se detendrá y el nuevo trozo ocupará su lugar.
Si loops es mayor que cero, repite el sonido tantas veces como sea necesario. Si loops es -1, se repite "infinitamente" (~65000 veces).
ticks especifica el número máximo de milisegundos a reproducir antes de detener la reproducción. Si se quiere que el chunk se reproduzca hasta que todos los datos se hayan mezclado, especificar -1.
Nótese que esta función no bloquea por el número de ticks solicitados; solo programa la reproducción del chunk y anota el máximo para que el mezclador lo maneje después, y retorna inmediatamente.
Un canal con desvanecimiento cambiará su volumen progresivamente, como si Mix_Volume() fuera llamada sobre él (lo que quiere decir que probablemente no se debería llamar a Mix_Volume() sobre un canal con desvanecimiento).