load_song()

load_song(<nombre de archivo>, <repetición>)

Retorna:

Identificador de la canción cargada, o -1 si se produce un error.

Descripción:

Carga una canción de un archivo MOD, S3M o XM, para su posterior reproducción.

La función requiere el nombre del archivo que contiene el módulo musical, y si este debe reproducirse una sóla vez (indicando 0 en <repetición>) o indefinidamente (indicando 1).

Estos módulos musicales se pueden componer con múltiples programas shareware o de libre uso. En DIV Games Studio se pueden reproducir, tanto en el entorno como en los programas creados, pero no se pueden crear nuevos módulos.

PROGRAM ejemplo_load_song;

GLOBAL
    id_canción;

BEGIN

    load_song("help\help.xm",1); // Carga un módulo XM, con repetición

    song(id_canción);
    write(0,0,0,0,"Pulse ESC para terminar");
    REPEAT
        FRAME;
    UNTIL (key(_ESC));
    unload_song(id_canción);
END

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

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.

El volumen de reproducción puede controlarse mediante la función set_volume() y los datos contenidos en la estructura setup.

Nota: Con esta versión de DIV Games Studio se incluyen varios archivos con módulos musicales de libre utilización, en el directorio MOD.

Nota: Para reproducir canciones contenidas en una pista de CD-Audio se deben utilzar las funciones play_cd() y stop_cd().