lilyinput               package:tuneR               R Documentation

_P_r_o_v_i_d_i_n_g _L_i_l_y_P_o_n_d _c_o_m_p_a_t_i_b_l_e _i_n_p_u_t

_D_e_s_c_r_i_p_t_i_o_n:

     A function _(in development!)_ that writes a file to be processed
     by _LilyPond_ by extracting the relevant information (e.g. pitch,
     length, ...) from columns of a data frame. The music notation
     software _LilyPond_ can "transcribe" such an input file into sheet
     music.

_U_s_a_g_e:

     lilyinput(X, file = "Rsong.ly", Dur = TRUE, grundton = "c", 
         schlusselart = 1, takt = "4/4", endbar = TRUE, midi = TRUE, 
         tempo = "2 = 60", textheight = 220, linewidth = 150, indent = 0)

_A_r_g_u_m_e_n_t_s:

       X: A data frame containing 4 named components (columns):

             *  'noten': Integer - the notes' pitch in halftones from
                diapason (a), i.e. 0 for diapason a, 3 for c', ...

             *  'laenge': Integer - denominator of lengths of the
                notes, e.g. 8 for a quaver.

             *  'punkt': Logical - whether to punctate a note.

             *  'bindung': Logical - 'TRUE' indicates to start a slur,
                or to end it. That means that the first, third, ...
                occurences of 'TRUE' start slurps, while the second,
                fourth, ... occurences end slurps. Note that it is only
                possible to draw one slur at a time.

    file: The file to be written for _LilyPond_'s input.

     Dur: Logical indicating major key (if 'TRUE') or minor key.

grundton: Keynote, necessary to set sharps/flats.

schlusselart: Integer indicating the kind of clef. The following four
          kinds are supported: 1 for g-/treble-clef, 2 for
          f-/bass-clef, 3 for c-/alto-clef, and 4 for c-/tenor-clef.

    takt: Character indicating which meter to use, examples are:
          '"3/4"', '"4/4"'.

  endbar: Logical indicating whether to set an ending bar at the end of
          the sheet music.

    midi: Logical indicating whether Midi output (by _LilyPond_) is
          desirable.

   tempo: Character specifying the tempo to be used for the Midi file
          if 'midi = TRUE'. The default, '"2 = 60"' indicates: 60 half
          notes per minute, whereas '"4 = 90"' indicates 90 quarters
          per minute.

textheight: Textheight of the sheet music te be written by _LilyPond_.

linewidth: Linewidth of the sheet music te be written by _LilyPond_.

  indent: Indentation of the sheet music te be written by _LilyPond_.

_D_e_t_a_i_l_s:

     Details will be given when development has reached a stable stage
     ...

_V_a_l_u_e:

     Nothing is returned, but a 'file' is written.

_N_o_t_e:

     This function is in development!  Everything, in particular its
     user interface (and german names of arguments) is subject to
     change!

_A_u_t_h_o_r(_s):

     Andrea Preusser and Uwe Ligges, ligges@statistik.uni-dortmund.de

_R_e_f_e_r_e_n_c_e_s:

     Nienhuys, H.-W., Nieuwenhuizen, J. et al. (2004): _GNU LilyPond -
     The Music Typesetter_. Free Software Foundation, <URL:
     http://www.lilypond.org/>, Version 2.0.3.

     Preusser, A., Ligges, U. und Weihs, C. (2002):  _Ein R
     Exportfilter fr das Notations- und Midi-Programm LilyPond_.   
     Arbeitsbericht 35. Fachbereich Statistik, Universitt Dortmund.
     (german)

_S_e_e _A_l_s_o:

     Functions to be referenced are not yet documented ...

_E_x_a_m_p_l_e_s:

     # Not yet available ...

