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"
12 #include "translator-group.hh"
13 #include "context-def.hh"
14 #include "dispatcher.hh"
15 #include "global-context.hh"
17 #include "translator.icc"
18 #include "ly-smobs.icc"
20 Translator::~Translator ()
27 must_be_last_ = false;
34 Translator::process_music ()
39 Translator::process_acknowledged ()
43 Translator::Translator ()
48 Translator::Translator (Translator const &src)
51 must_be_last_ = src.must_be_last_;
55 Translator::try_music (Music *)
61 Translator::now_mom () const
63 return daddy_context_->now_mom ();
67 Translator::get_output_def () const
69 return daddy_context_->get_output_def ();
73 Translator::get_daddy_translator () const
75 return daddy_context_->implementation ();
79 Translator::protect_event (SCM ev)
81 get_daddy_translator ()->protect_event (ev);
85 Translator::internal_get_property (SCM sym) const
87 return daddy_context_->internal_get_property (sym);
91 Translator::stop_translation_timestep ()
96 this function has 2 properties
98 - It is called before try_music ()
100 - It is called before any user information enters the translators.
101 (i.e. any \property or event is not processed yet.)
104 Translator::start_translation_timestep ()
109 Translator::initialize ()
114 Translator::finalize ()
119 Translator::connect_to_context (Context *c)
121 for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
122 c->events_below ()->add_listener (r->get_listener_ (this), r->event_class_);
126 Translator::disconnect_from_context (Context *c)
128 for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
129 c->events_below ()->remove_listener (r->get_listener_ (this), r->event_class_);
133 Internally called once, statically, for each translator
134 listener. Connects the name of an event class with a procedure that
135 fetches the corresponding listener.
137 The method should only be called from the macro
138 IMPLEMENT_TRANSLATOR_LISTENER.
141 Translator::add_translator_listener (translator_listener_record **listener_list,
142 translator_listener_record *r,
143 Listener (*get_listener) (void *),
144 const char *ev_class)
146 /* ev_class is the C++ identifier name. Convert to scm symbol */
147 string name = string (ev_class);
148 name = replace_all (name, '_', '-');
149 name = name + "-event";
150 /* It's OK to use scm_gc_protect_object for protection, because r is
151 statically allocated. */
152 r->event_class_ = scm_gc_protect_object (scm_str2symbol (name.c_str ()));
153 r->get_listener_ = get_listener;
154 r->next_ = *listener_list;
162 Translator::mark_smob (SCM sm)
164 Translator *me = (Translator *) SCM_CELL_WORD_1 (sm);
170 Translator::get_global_context () const
172 return daddy_context_->get_global_context ();
176 Translator::get_score_context () const
178 return daddy_context_->get_score_context ();
181 IMPLEMENT_SMOBS (Translator);
182 IMPLEMENT_DEFAULT_EQUAL_P (Translator);
183 IMPLEMENT_TYPE_P (Translator, "ly:translator?");
186 Translator::must_be_last () const
188 return must_be_last_;
192 Translator::derived_mark () const
197 Translator::print_smob (SCM s, SCM port, scm_print_state *)
199 Translator *me = (Translator *) SCM_CELL_WORD_1 (s);
200 scm_puts ("#<Translator ", port);
201 scm_puts (me->class_name (), port);
202 scm_puts (" >", port);
207 add_acknowledger (Engraver_void_function_engraver_grob_info ptr,
208 char const *func_name,
209 vector<Acknowledge_information> *ack_array)
211 Acknowledge_information inf;
214 string interface_name (func_name);
216 interface_name = replace_all (interface_name, '_', '-');
217 interface_name += "-interface";
219 inf.symbol_ = scm_gc_protect_object (ly_symbol2scm (interface_name.c_str ()));
220 ack_array->push_back (inf);
223 Engraver_void_function_engraver_grob_info
224 generic_get_acknowledger (SCM sym, vector<Acknowledge_information> const *ack_array)
226 for (vsize i = 0; i < ack_array->size (); i++)
228 if (ack_array->at (i).symbol_ == sym)
229 return ack_array->at (i).function_;
234 ADD_TRANSLATOR (Translator,
235 "Base class. Unused",