2 translator.cc -- implement Translator
4 source file of the GNU LilyPond music typesetter
6 (c) 1997--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
9 #include "translator.hh"
11 #include "context-def.hh"
12 #include "dispatcher.hh"
13 #include "global-context.hh"
14 #include "international.hh"
15 #include "translator-group.hh"
18 #include "translator.icc"
19 #include "ly-smobs.icc"
21 Translator::~Translator ()
28 must_be_last_ = false;
35 Translator::process_music ()
40 Translator::process_acknowledged ()
44 Translator::Translator ()
49 Translator::Translator (Translator const &src)
52 must_be_last_ = src.must_be_last_;
56 Translator::try_music (Music *)
62 Translator::now_mom () const
64 return daddy_context_->now_mom ();
68 Translator::get_output_def () const
70 return daddy_context_->get_output_def ();
74 Translator::get_daddy_translator () const
76 return daddy_context_->implementation ();
80 Translator::protect_event (SCM ev)
82 get_daddy_translator ()->protect_event (ev);
86 Translator::internal_get_property (SCM sym) const
88 return daddy_context_->internal_get_property (sym);
92 Translator::stop_translation_timestep ()
97 this function has 2 properties
99 - It is called before try_music ()
101 - It is called before any user information enters the translators.
102 (i.e. any \property or event is not processed yet.)
105 Translator::start_translation_timestep ()
110 Translator::initialize ()
115 Translator::finalize ()
120 Translator::connect_to_context (Context *c)
122 for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
123 c->events_below ()->add_listener (r->get_listener_ (this), r->event_class_);
127 Translator::disconnect_from_context (Context *c)
129 for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
130 c->events_below ()->remove_listener (r->get_listener_ (this), r->event_class_);
133 static SCM listened_event_classes = SCM_EOL;
135 LY_DEFINE (ly_get_listened_event_classes, "ly:get-listened-event-classes",
137 "Returns a list of all event classes that some translator listens to.")
139 return listened_event_classes;
143 Internally called once, statically, for each translator
144 listener. Connects the name of an event class with a procedure that
145 fetches the corresponding listener.
147 The method should only be called from the macro
148 IMPLEMENT_TRANSLATOR_LISTENER.
151 Translator::add_translator_listener (translator_listener_record **listener_list,
152 translator_listener_record *r,
153 Listener (*get_listener) (void *),
154 const char *ev_class)
156 /* ev_class is the C++ identifier name. Convert to scm symbol */
157 string name = string (ev_class);
158 name = replace_all (name, '_', '-');
159 name = name + "-event";
160 /* It's OK to use scm_gc_protect_object for protection, because r is
161 statically allocated. */
162 SCM class_sym = scm_gc_protect_object (scm_str2symbol (name.c_str ()));
163 listened_event_classes = scm_gc_protect_object (scm_cons (class_sym, listened_event_classes));
164 r->event_class_ = class_sym;
165 r->get_listener_ = get_listener;
166 r->next_ = *listener_list;
174 Translator::mark_smob (SCM sm)
176 Translator *me = (Translator *) SCM_CELL_WORD_1 (sm);
182 Translator::get_global_context () const
184 return daddy_context_->get_global_context ();
188 Translator::get_score_context () const
190 return daddy_context_->get_score_context ();
193 IMPLEMENT_SMOBS (Translator);
194 IMPLEMENT_DEFAULT_EQUAL_P (Translator);
195 IMPLEMENT_TYPE_P (Translator, "ly:translator?");
198 Translator::must_be_last () const
200 return must_be_last_;
204 Translator::derived_mark () const
209 Translator::print_smob (SCM s, SCM port, scm_print_state *)
211 Translator *me = (Translator *) SCM_CELL_WORD_1 (s);
212 scm_puts ("#<Translator ", port);
213 scm_puts (me->class_name (), port);
214 scm_puts (" >", port);
219 add_acknowledger (Engraver_void_function_engraver_grob_info ptr,
220 char const *func_name,
221 vector<Acknowledge_information> *ack_array)
223 Acknowledge_information inf;
226 string interface_name (func_name);
228 interface_name = replace_all (interface_name, '_', '-');
229 interface_name += "-interface";
231 inf.symbol_ = scm_gc_protect_object (ly_symbol2scm (interface_name.c_str ()));
232 ack_array->push_back (inf);
235 Engraver_void_function_engraver_grob_info
236 generic_get_acknowledger (SCM sym, vector<Acknowledge_information> const *ack_array)
238 for (vsize i = 0; i < ack_array->size (); i++)
240 if (ack_array->at (i).symbol_ == sym)
241 return ack_array->at (i).function_;
247 get_event_length (Stream_event *e)
249 Moment *m = unsmob_moment (e->get_property ("length"));
257 Helper, used through ASSIGN_EVENT_ONCE to throw warnings for
258 simultaneous events. The helper is only useful in listen_* methods
262 internal_event_assignment (Stream_event **old_ev, Stream_event *new_ev, const char *function)
266 /* extract event class from function name */
267 const char *prefix = "listen_";
268 assert (!strncmp (function, "listen_", strlen (prefix)));
269 function += strlen (prefix);
270 char ev_class[strlen (function) + 1];
271 strcpy (ev_class, function);
272 for (char *c = ev_class; *c; c++)
276 new_ev->origin ()->warning (_f ("Two simultaneous %s events, junking this one", ev_class));
277 (*old_ev)->origin ()->warning (_f ("Previous %s event here", ev_class));
287 ADD_TRANSLATOR (Translator,
288 "Base class. Unused",