is_playing_song()

is_playing_song()

Retorna:

0 - No está sonando ningún módulo.
1 - Si está sonando un módulo musical.

Descripción:

Esta función permite determinar si se está reproduciendo un módulo de música digital de un archivo MOD, S3M o XM.

Estos módulos se deben cargar con la función load_song() y su reproducción se inicia con una llamada a song().

Unicamente puede reproducirse un módulo a la vez, por lo que esta función no requiere ningún parámetro, simplemente devuelve 1 si hay algún módulo reproduciéndose.

PROGRAM ejemplo_is_playing_song;

GLOBAL
    id_canción;
    sonando;

BEGIN
    load_song("help\help.xm",1);
    song(id_canción);
    write(0,0,0,0,"ENTER iniciar el módulo / SPACE para detenerlo");
    write_int(0,0,10,0,OFFSET sonando);
    LOOP
        IF (key(_enter)) song(id_canción); END
        IF (key(_space)) stop_song(); END

        sonando = is_playing_song(); // Determina si está sonando

        FRAME;
    END
END

Este ejemplo carga el módulo musical contenido en el archivo help.xm y permite, dentro de un bucle, iniciarlo con la tecla ENTER y detenerlo con la barra espaciadora.

Dentro de este mismo bucle se utiliza la función is_playing_song() para determinar si este está sonando en cada momento.

Nota: Para finalizar la reproducción de un módulo musical se debe emplear la función stop_song().