get_song_line()

get_song_line()

Retorna:

El número de línea del módulo musical.

Descripción:

Con esta función se puede obtener el número de línea del módulo musical que se está reproduciendo (dentro de la posición, o patrón actual).

Esta posición actual, o patrón (pattern), puede obtenerse con la función get_song_pos().

Dentro de cada patrón los módulos tienen un determinado número de líneas (normalmente 64), en las cuales aparecen las notas musicales. Los módulos suelen tener un número muy variable de patrones, aunque la media puede situarse entre 30 y 40.

PROGRAM ejemplo_get_song_line;

GLOBAL
    id_canción;
    línea_módulo;

BEGIN
    load_song("help\help.xm",1);
    song(id_canción);
    write(0,0,0,0,"Línea del módulo:");
    write_int(0,0,10,0,OFFSET línea_módulo);
    LOOP

        línea_módulo=get_song_line(); // Obtiene el número de línea

        FRAME;
    END
END

Este programa carga el módulo contenido en el archivo help.xm y entonces inicia su reproducción con la función song().

A partir de este momento se mostrará la línea actual del módulo en pantalla, obtenida mediante la función get_song_line().

Nota: No se puede fijar la línea del módulo musical, aunque si se puede fijar la posición a partir de la que debe reproducirse con la función set_song_pos() (siempre se comenzará en la línea 0 del patrón).