2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 1997--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
6 LilyPond is free software: you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
11 LilyPond is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
20 #include "bar-line.hh"
23 #include "engraver.hh"
26 #include "protected-scm.hh"
27 #include "staff-symbol-referencer.hh"
28 #include "stream-event.hh"
30 #include "translator.icc"
32 class Key_engraver : public Engraver
34 void create_key (bool);
35 void read_event (Stream_event const *r);
37 Stream_event *key_event_;
41 TRANSLATOR_DECLARATIONS (Key_engraver);
44 virtual void initialize ();
45 virtual void finalize ();
46 void stop_translation_timestep ();
47 void process_music ();
49 DECLARE_TRANSLATOR_LISTENER (key_change);
50 DECLARE_ACKNOWLEDGER (clef);
51 DECLARE_ACKNOWLEDGER (bar_line);
55 Key_engraver::finalize ()
59 Key_engraver::Key_engraver ()
67 Key_engraver::create_key (bool is_default)
71 item_ = make_item ("KeySignature",
72 key_event_ ? key_event_->self_scm () : SCM_EOL);
74 /* Use middleCClefPosition rather than middleCPosition, because cue
75 * notes with a different clef will modify middleCPosition. The
76 * Key signature, however, should still be printed at the original
78 item_->set_property ("c0-position",
79 get_property ("middleCClefPosition"));
81 SCM last = get_property ("lastKeySignature");
82 SCM key = get_property ("keySignature");
84 if ((to_boolean (get_property ("printKeyCancellation"))
86 && !scm_is_eq (last, key))
88 SCM restore = SCM_EOL;
90 for (SCM s = last; scm_is_pair (s); s = scm_cdr (s))
92 SCM new_alter_pair = scm_assoc (scm_caar (s), key);
93 Rational old_alter = robust_scm2rational (scm_cdar (s), 0);
94 if (new_alter_pair == SCM_BOOL_F
95 || ((ly_scm2rational (scm_cdr (new_alter_pair)) - old_alter) * old_alter
98 *tail = scm_cons (scm_car (s), *tail);
99 tail = SCM_CDRLOC (*tail);
103 if (scm_is_pair (restore))
105 cancellation_ = make_item ("KeyCancellation",
107 ? key_event_->self_scm () : SCM_EOL);
109 cancellation_->set_property ("alteration-alist", scm_reverse (restore));
110 cancellation_->set_property ("c0-position",
111 get_property ("middleCPosition"));
115 item_->set_property ("alteration-alist", scm_reverse (key));
120 SCM visibility = get_property ("explicitKeySignatureVisibility");
121 item_->set_property ("break-visibility", visibility);
125 IMPLEMENT_TRANSLATOR_LISTENER (Key_engraver, key_change);
127 Key_engraver::listen_key_change (Stream_event *ev)
129 /* do this only once, just to be on the safe side. */
130 if (ASSIGN_EVENT_ONCE (key_event_, ev))
131 read_event (key_event_);
135 Key_engraver::acknowledge_clef (Grob_info /* info */)
137 SCM c = get_property ("createKeyOnClefChange");
143 Key_engraver::acknowledge_bar_line (Grob_info /* info */)
145 if (scm_is_pair (get_property ("keySignature")))
150 Key_engraver::process_music ()
153 || get_property ("lastKeySignature") != get_property ("keySignature"))
158 Key_engraver::stop_translation_timestep ()
161 context ()->set_property ("lastKeySignature", get_property ("keySignature"));
167 Key_engraver::read_event (Stream_event const *r)
169 SCM p = r->get_property ("pitch-alist");
170 if (!scm_is_pair (p))
175 SCM alist = scm_list_copy (p);
176 SCM order = get_property ("keyAlterationOrder");
178 scm_is_pair (s) && scm_is_pair (alist); s = scm_cdr (s))
180 SCM head = scm_member (scm_car (s), alist);
182 if (scm_is_pair (head))
184 accs = scm_cons (scm_car (head), accs);
185 alist = scm_delete_x (scm_car (head), alist);
189 if (scm_is_pair (alist))
192 for (SCM s = alist; scm_is_pair (s); s = scm_cdr (s))
193 if (ly_scm2rational (scm_cdar (s)))
196 accs = scm_cons (scm_car (s), accs);
200 r->origin ()->warning ("Incomplete keyAlterationOrder for key signature");
203 context ()->set_property ("keySignature", scm_reverse (accs));
204 context ()->set_property ("tonic",
205 r->get_property ("tonic"));
209 Key_engraver::initialize ()
211 context ()->set_property ("keySignature", SCM_EOL);
212 context ()->set_property ("lastKeySignature", SCM_EOL);
215 context ()->set_property ("tonic", p.smobbed_copy ());
218 ADD_ACKNOWLEDGER (Key_engraver, clef);
219 ADD_ACKNOWLEDGER (Key_engraver, bar_line);
221 ADD_TRANSLATOR (Key_engraver,
223 "Engrave a key signature.",
230 "createKeyOnClefChange "
231 "explicitKeySignatureVisibility "
233 "keyAlterationOrder "
236 "printKeyCancellation "
237 "middleCClefPosition ",