Función Mix_FadeOutGroup

Sintaxis

int Mix_FadeOutGroup(int tag, int ms);

Descripción

Detiene la reproducción de un grupo de canales por una etiqueta arbitraria, después de atenuarlos durante un tiempo especificado.

Parámetros

tag

Un valor arbitrario, asignado a los canales, para buscar.

ms

Número de milisegundos a desvanecer antes de detener el grupo.

Valor de retorno

Devuelve el número de canales que se programaron para el desvanecimiento..

Observaciones

Esto comenzará a desvanecer un grupo de canales con una etiqueta específica desde sus volúmenes actuales hasta el silencio en ms milisegundos. Pasado ese tiempo, esos canales se detendrán.

Una etiqueta es un número arbitrario que puede ser asignado a varios canales del mezclador, para formar grupos de canales.

La etiqueta por defecto para un canal es -1.

Cualquier canal detenido tendrá cualquier efecto actualmente registrado desregistrado, y llamará a cualquier retrollamada especificada por Mix_ChannelFinished() una vez que ocurra la detención.

Un canal desvanecido cambiará su volumen progresivamente, como si Mix_Volume() hubiera sido invocado sobre él (lo que significa que probablemente no se debería invocar Mix_Volume() sobre un canal desvanecido).

Hay que tener en cuenta que esta función no se bloquea durante el número de milisegundos solicitados; simplemente programa el desvanecimiento del grupo y anota el tiempo para que el mezclador lo gestione más tarde, y devuelve inmediatamente.