unload_song(<identificador del módulo>)
Descripción:
Descarga de memoria el módulo musical cuyo identificador se pasa como parámetro. Este <identificador del módulo> es el valor que retorna la función load_song() al cargarlo en memoria.
Tras descargarse un módulo se deben extremar las precauciones para no continuar utilizándolo en el programa, en cuyo caso el programa correría el riesgo de bloquearse.
No es necesario descargar los módulos antes de finalizar el programa, ya que el sistema lo hará de forma automática. Luego, solamente deben descargarse de memoria cuando ya no se vayan a utilizar durante un tiempo determinado y se quiera liberar el espacio ocupado en la memoria del ordenador para cargar otros recursos (otros ficheros de gráficos, sonidos, fuentes, etc.).
PROGRAM ejemplo_unload_song; GLOBAL id_canción; BEGIN load_song("help\help.xm",1); song(id_canción); write(0,0,0,0,"Pulse ESC para terminar"); REPEAT FRAME; UNTIL (key(_ESC)); unload_song(id_canción); // Libera la memoria ocupada por el módulo 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 permanecerá reproduciendo este módulo hasta que se pulse la tecla ESC, momento en el que se finalizará el bucle principal y se descargará el módulo de memoria con la función unload_song(), indicando como parámetro id_canción que es contiene el identificador del módulo devuelto al cargarlo.
Nota: Las músicas contenidas en pistas de CD-Audio, cuya reproducción se inicia con la función play_cd(), no ocupan memoria en el ordenador, por lo que no pueden descargarse con la función unload_song().