2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 1997--2009 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 "engraver.hh"
23 #include "international.hh"
25 #include "paper-column.hh"
26 #include "score-engraver.hh"
28 #include "stream-event.hh"
32 Engraver::get_daddy_engraver () const
34 return dynamic_cast<Engraver_group *> (get_daddy_translator ());
38 Engraver::announce_grob (Grob_info inf)
40 get_daddy_engraver ()->announce_grob (inf);
44 Engraver::announce_end_grob (Grob_info inf)
46 get_daddy_engraver ()->announce_grob (inf);
50 CAUSE is the object (typically a Stream_event object) that
51 was the reason for making E.
54 Engraver::announce_grob (Grob *e, SCM cause)
56 /* TODO: Remove Music code when it's no longer needed */
57 if (Music *m = unsmob_music (cause))
59 cause = m->to_event ()->unprotect ();
61 if (unsmob_stream_event (cause) || unsmob_grob (cause))
62 e->set_property ("cause", cause);
64 Grob_info i (this, e);
66 Engraver_group *g = get_daddy_engraver ();
73 CAUSE is the object (typically a Music object) that
74 was the reason for making E.
77 Engraver::announce_end_grob (Grob *e, SCM cause)
79 /* TODO: Remove Music code when it's no longer needed */
80 if (Music *m = unsmob_music (cause))
82 cause = m->to_event ()->unprotect ();
84 if (e->get_property ("cause") == SCM_EOL
85 && (unsmob_stream_event (cause) || unsmob_grob (cause)))
86 e->set_property ("cause", cause);
88 Grob_info i (this, e);
91 Engraver_group *g = get_daddy_engraver ();
102 static SCM creation_callback = SCM_EOL;
103 LY_DEFINE (ly_set_grob_creation_callback, "ly:set-grob-creation-callback",
105 "Specify a procedure that will be called every time a new grob"
106 " is created. The callback will receive as arguments the grob"
107 " that was created, the name of the C++ source file that caused"
108 " the grob to be created, and the corresponding line number in"
109 " the C++ source file.")
111 LY_ASSERT_TYPE (ly_is_procedure, cb, 1);
113 creation_callback = cb;
115 return SCM_UNSPECIFIED;
120 Engraver::internal_make_grob (SCM symbol,
122 char const * /* name */,
133 SCM props = updated_grob_properties (context (), symbol);
137 SCM handle = scm_sloppy_assq (ly_symbol2scm ("meta"), props);
138 SCM klass = scm_cdr (scm_sloppy_assq (ly_symbol2scm ("class"), scm_cdr (handle)));
140 if (klass == ly_symbol2scm ("Item"))
141 grob = new Item (props);
142 else if (klass == ly_symbol2scm ("Spanner"))
143 grob = new Spanner (props);
144 else if (klass == ly_symbol2scm ("Paper_column"))
145 grob = new Paper_column (props);
148 announce_grob (grob, cause);
151 if (ly_is_procedure (creation_callback))
152 scm_apply_0 (creation_callback,
153 scm_list_n (grob->self_scm (), scm_from_locale_string (file),
154 scm_from_int (line), scm_from_locale_string (fun), SCM_UNDEFINED));
161 Engraver::internal_make_item (SCM x, SCM cause,
163 char const *file, int line, char const *fun)
165 Item *it = dynamic_cast<Item *> (internal_make_grob (x, cause, name, file, line, fun));
171 Engraver::internal_make_column (SCM x, char const *name,
172 char const *file, int line, char const *fun)
174 return dynamic_cast<Paper_column *> (internal_make_grob (x, SCM_EOL, name, file, line, fun));
178 Engraver::internal_make_spanner (SCM x, SCM cause, char const *name, char const *file, int line, char const *fun)
180 Spanner *sp = dynamic_cast<Spanner *> (internal_make_grob (x, cause, name, file, line, fun));
185 #include "translator.icc"
187 ADD_TRANSLATOR (Engraver,
189 "Base class for engravers. Does nothing, so it is not used.",