stop_song()

stop_song()

Descripción:

Detiene la reproducción del módulo musical (MOD, S3M o XM) que este sonando.

Esta función no requiere ningún parámetro, ya que únicamente puede reproducirse ún módulo musical a la vez.

No es imprescindible detener la reproducción de un módulo musical antes de descargarlo de memoria (operación realizada con la función unload_song()), esta acción se realiza de forma automática.

PROGRAM ejemplo_stop_song;

GLOBAL
    id_canción;

BEGIN
    load_song("help\help.xm",1);
    song(id_canción);
    write(0,0,0,0,"Pulse SPACE para detener la canción ...");
    LOOP
        IF (key(_space))

            stop_song(); // Detiene el módulo

        END
        FRAME;
    END
    unload_song(id_canción);
END

Este ejemplo carga el módulo contenido en el archivo help.xm con la función load_song(). La reproducción del archivo se inicia con una llamada a la función song().

El programa entra entonces en un bucle en el que continuará la reproducción de dicho módulo, hasta que una pulsación de la tecla barra espaciadora provoque una llamada a stop_song() y se detenga el módulo.

Para descargar una canción de memoria se debe utilizar la función unload_song(), si bien todos los programas creados en DIV Games Studio liberarán toda la memoria ocupada de forma automática al finalizar.

Nota: Para detener una canción de CD-Audio se utiliza la función stop_cd(), y hacerlo con un efecto de sonido, la función stop_sound().

Nota: Se puede averiguar si un módulo está reproduciéndose llamando a la función is_playing_song().