A.3.1 Presentació de les expressions musicals ¶

Si s’està escrivint una funció musical, pot ser molt instructiu examinar com s’emmagatzema internament una expressió musical. Això es pot fer amb la funció musical \displayMusic.

{
  \displayMusic { c'4\f }
}

imprimeix el següent:

(make-music
  'SequentialMusic
  'elements
  (list (make-music
          'NoteEvent
          'articulations
          (list (make-music
                  'AbsoluteDynamicEvent
                  'text
                  "f"))
          'duration
          (ly:make-duration 2 0 1/1)
          'pitch
          (ly:make-pitch 0 0 0))))

De manera predeterminada, el LilyPond imprimeix aquests missatges sobre la consola junt a la resta dels missatges. Per separar aquests missatge i desar el resultat de \display{ELQUESIGUI}, podeu especificar que s’usi un port de sortida opcional:

{
  \displayMusic #(open-output-file "display.txt") { c'4\f }
}

Això sobreescriu el fitxer de sortida anterior cada cop que es crida; si ens cal escriure més d’una expressió, hem d’usar una variable per al port i reutilitzar-la:

{
  port = #(open-output-file "display.txt")
  \displayMusic \port { c'4\f }
  \displayMusic \port { d'4 }
  #(close-output-port port)
}

El manual del Guile descriu els ports detalladament. Sols es realment necessari tancar el port si ens cal llegir el fitxer abans que acabi el LilyPond; en el primer exemple, no ens hem molestat de fer-ho.

Una mica d’ajustament del format fa que sigui més fàcil de llegir la informació anterior:

(make-music 'SequentialMusic
  'elements (list
	     (make-music 'NoteEvent
               'articulations (list
			       (make-music 'AbsoluteDynamicEvent
				 'text
				 "f"))
	       'duration (ly:make-duration 2 0 1/1)
	       'pitch    (ly:make-pitch 0 0 0))))

Una seqüència musical { … } té el nom SequentialMusic, i les seves expressions internes s’emmagatzemen com a una llista dins de la seva propietat 'elements. Una nota es representa com un objecte NoteEvent (que emmagatzema les propietats de duració i altura) amb informació adjunta (en aquest cas, un esdeveniment NoteEvent (que emmagatzema propietats de duració i altura) com informació adjunta (en aquest cas, un esdeveniment AbsoluteDynamicEvent amb una propietat "f" de text) emmagatzemada en la seva propietat articulations.

\displayMusic retorna la música que s’imprimeix a la consola, i per això s’interpretarà al mateix moment que s’imprimeix a la consola. Per evitar la interpretació, escriviu \void antes de \displayMusic.