Para guardar y cargar las canciones,
Pymprovisator utiliza un formato
propio, muy parecido al de los archivos .ini de Windows. Una
canción comienza con un encabezado [SONG] y
varias líneas describiendo los distintos elementos de la canción:
[SONG]
# Este es un ejemplo de canción
id = ThisIsATestSong
tempo = 153
n_choruses = 10
title = This is a test song
key = C
n_bars = 12
active_instruments = piano bass drums
style = basic
chords = 4c7 4f7 8c7 8f7 8c7 4g7 4f7 4c7 4g7
En el ejemplo anterior se muestran todos los elementos que
componen una canción. Por convenio, las canciones para
Pymprovisator se guardan con la
extensión .ymp, pero puede utilizarse otra si
se desea. Veamos cada uno de los elementos de una canción:
id Este elemento es un texto, sin
espacios y sin signos de puntuación que identifica la
canción, se utiliza principalmente al generar los archivos
MIDI.
tempo Indica el tempo o velocidad
de la canción. Debe ser un valor numérico entero (sin
decimales) y razonable (no ponga 0 ni valores negativos).
n_choruses Indica el número de
coros o veces que se reproducirá la secuencia de
acordes. Debe ser un valor numérico entero mayor que 0.
title Título de la canción.
key Tonalidad de la canción. Los
valores permitidos son: C, C#, Db, D, D#, Eb, E, F, F#, Gb,
G, G#, Ab, A, A#, Bb, B, Cm, C#m, Dbm, Dm, D#m, Ebm, Em, Fm,
F#m, Gbm, Gm, G#m, Abm, Am, A#m, Bbm y Bm
n_bars Número de compases que
dura la canción. Valor numérico entero mayor que 0.
active_instruments Indica los
instrumentos que se utilizarán para generar la canción (al
menos uno de éstos: "piano", "bass" ó "drums" (tal cual
están escritos, pero sin comillas).
style Estilo para la canción. Los
siguientes estilos están definidos: swing, even_eights,
jazz_waltz, waltz, five_swing, five, latin, bossa, samba,
ballad, modern, funk, rock y basic. No vamos a describir
cada uno de ellos: ¡sus nombres deberían ser lo
suficientemente descriptivos!.
Todos los estilos se miden en compás 4/4, excepto
waltz y jazz_waltz, en 3/4 y five y five_swing, que se miden
en 5/4.
chords Secuencia de acordes que
componen la canción, separados por espacios. Los acordes se
escriben con la notación estándar del jazz, y cada uno de
ellos va precedido del número de partes de compás que
dura. Si sólo dura una parte, debe ponerse un 1
también.
Es muy importante que la sequencia de acordes sea
coherente con el número de compases. Así, en el ejemplo
anterior, tenemos 12 compases, en estilo 'basic', que es
4/4, luego nuestra secuencia de acordes debe comprender 48
partes (12x4). Comprobación: 4 + 4 + 8 + 8 + 8 + 4 + 4 + 4 +
4 = 48 partes. ¡Está bien!.
No es necesario poner los parámetros en este orden, pero sí que deben
figurar todos. Puede poner comentarios en su canción,
marcándolos con un símbolo # al principio de la línea, como en
el ejemplo anterior
(# Este es un ejemplo de canción).