get_song_pos()

get_song_pos()

Retorna:

La posición actual del módulo musical que se esté reproduciendo.

Descripción:

Devuelve la posición actual de reproducción del módulo musical, esta posición puede fijarse con la función set_song_pos().

Esta <posición del módulo> es un número entre 0 y el número máximo de pattern (patrones) del módulo. Este valor varia para cada módulo, y se define en los programas utilizados para componerlos. Los módulos suelen tener un número muy variable de patrones, aunque la media puede situarse entre 30 y 40.

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, por lo que se podría definir cada patrón como una pequeña sección del módulo musical.

PROGRAM ejemplo_get_song_pos;

GLOBAL
    id_canción;
    posición_módulo;

BEGIN
    load_song("help\help.xm",1);
    song(id_canción);
    write(0,0,0,0,"Posición del módulo:");
    write_int(0,0,10,0,OFFSET posición_módulo);
    LOOP

        posición_módulo=get_song_pos(); // Obtiene la posición

        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 posición actual del módulo en pantalla, obtenida mediante la función get_song_pos().

Nota: Se puede obtener el número de línea que se está reproduciendo, dentro del patrón, con la función get_song_line().