-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
156 lines (84 loc) · 4.39 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
;; =============================================================================
;; OMLILY
;; =============================================================================
;;
;;
;; author : Karim Haddad
;;
;;
;;
;;
;This program is free software; you can redistribute it and/or
;modify it under the terms of the GNU General Public License
;as published by the Free Software Foundation; either version 2
;of the License, or (at your option) any later version.
;
;See file LICENSE for further informations on licensing terms.
;
;This program is distributed in the hope that it will be useful,
;but WITHOUT ANY WARRANTY; without even the implied warranty of
;MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;GNU General Public License for more details.
;
;You should have received a copy of the GNU General Public License
;along with this program; if not, write to the Free Software
;Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
;
COMPATIBILITY
* This Library is compatible with OpenMusic 6.x
* Runs on Linux, MacOsX and Windows plateforms
INSTALLATION
Install the folder 'omlily 3.x' in your OpenMusic desired path.
LINUX
Once loaded, the library will automatically query the Lilypond binary in your path.
It will also query for xpdf reader. You can change these options in OpenMusic preferences in the External tab.
MACOSX
In order to have the library automatically compile your *.ly file, you will need, beside the standard installation of Lilypond.app, to configure the command-line link to the application as described here in the "Running on the command-line":
http://www.lilypond.org/website/macos-x.html
WINDOWS
In order to have the library automatically compile your *.ly file, you will need, beside the standard installation of Lilypond.exe, to configure the command-line link to the application as described here in the "Running on the command-line":
http://lilypond.org/website/windows.html
USAGE
OM->LILY
om->lily will export and compile VOICE, POLY, CHORD-SEQ and MULTI-SEQ objects into lilypond *.ly files.
It has two modes for generating the score according to the nature of the polyphony:
-Generic: for most of the music that is set without polymetrics and polytempi.
-Polymetric : for special cases where music is polymetric and polytempic music
LILY->OM
In order to import *.ly files into OpenMusic objects (POLY), you will have to :
1) Uncomment the following 3 lines found in your *.ly generated file :
\score {
{
...
% #(with-output-to-file "temp.lisp" --> uncomment
% (lambda () #{ \displayMusic { --> uncomment
...
% } #})) --> uncomment
}
2) After removing '%' you should recompile your file with lilypond. This will produce a "temp.lisp" file
3) Connect lily->om to the first input of a POLY object (<self>) or CRTL+SHIFT+CLICK the output of lily->om in order to create a POLY instance.
Important:
The Lilypond/Openmusic communication will work ONLY with om->lily generated files.
- "barchecks" are mandatory. If they are absent this will output erronous rhtyhms.
If not, please be really carefull when :
1) In case of a single voice, or a single PianoStaff to group them between << and >> in the Score section
2) For general cases of music, put bar checks after each measures.
3) In case of PianoStaff cross-staff notation, this will not render as a cross-staff in OM. Hence all notes will stay on the same staff.
PianoStaff is not yet integrated nor the CHORD-SEQ export.
PREFERENCES
The preference panel under the Lilypond tab :
-Title : sets the title of the score.
-Composer : sets the composer's name of the score.
-Options:
-Clefs : sets the clefs.
-Clef Change : sets the switching of clefs (from G to F) in midicents.
-Compilation mode : sets the compilation mode generic/polymetric according to
the given music.
-Export Dynamics : if checked, all dynamics will be exported without repetition.
-Export Midi : if checked, will compile also a midi file.
-Export Channels
-Paper Size : sets the paper size a4/a3.
-Staff Size : sets the global staff size.
-Orientation : sets portait/landscape.
-Paper : Choose a template for more specific paper preferences (margins, page numbering, ...)
-Layout : Choose a template for most Lilypond specific preferences and contexts.