source file of the GNU LilyPond music typesetter
- (c) 1997--2001 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+ (c) 1997--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
*/
-
#include "translator.hh"
-#include "debug.hh"
+
+#include "context-def.hh"
+#include "dispatcher.hh"
+#include "global-context.hh"
+#include "international.hh"
#include "translator-group.hh"
-#include "translator-def.hh"
+#include "warn.hh"
-#include "moment.hh"
+#include "translator.icc"
#include "ly-smobs.icc"
-
Translator::~Translator ()
{
}
void
Translator::init ()
{
- simple_trans_list_ = SCM_EOL;
- trans_group_list_ = SCM_EOL;
- properties_scm_ = SCM_EOL;
- definition_ = SCM_EOL;
- daddy_trans_l_ =0;
+ must_be_last_ = false;
+ self_scm_ = SCM_EOL;
+ daddy_context_ = 0;
+ smobify_self ();
}
-Translator::Translator ()
+void
+Translator::process_music ()
{
- init ();
- output_def_l_ = 0;
- smobify_self ();
+}
+void
+Translator::process_acknowledged ()
+{
}
-Translator::Translator (Translator const &s)
- : Input (s)
+Translator::Translator ()
{
init ();
- output_def_l_ = s.output_def_l_;
- type_str_ = s.type_str_;
-
- smobify_self ();
}
-bool
-Translator::is_alias_b (String s) const
+Translator::Translator (Translator const &src)
{
- bool b = s == type_str_;
-
- for (SCM a = unsmob_translator_def (definition_)->type_aliases_;
- !b && gh_pair_p (a); a = ly_cdr (a))
- b = b || s == ly_scm2string (ly_car (a));
-
- return b;
+ init ();
+ must_be_last_ = src.must_be_last_;
}
bool
{
return false;
}
-
Moment
Translator::now_mom () const
{
- return daddy_trans_l_->now_mom ();
+ return daddy_context_->now_mom ();
}
-
-
-
-
-
-void
-Translator::removal_processing ()
+Output_def *
+Translator::get_output_def () const
{
- finalize ();
+ return daddy_context_->get_output_def ();
}
-
-void
-Translator::announces ()
+Translator_group *
+Translator::get_daddy_translator () const
{
- do_announces ();
+ return daddy_context_->implementation ();
}
-
-Music_output_def *
-Translator::output_def_l () const
+void
+Translator::protect_event (SCM ev)
{
- return output_def_l_;
+ get_daddy_translator ()->protect_event (ev);
}
SCM
-Translator::get_property (char const * id) const
+Translator::internal_get_property (SCM sym) const
{
- return daddy_trans_l_->get_property (ly_symbol2scm (id));
+ return daddy_context_->internal_get_property (sym);
}
-SCM
-Translator::get_property (SCM sym) const
+void
+Translator::stop_translation_timestep ()
{
- return daddy_trans_l_->get_property (sym);
}
+/*
+ this function has 2 properties
+
+ - It is called before try_music ()
+
+ - It is called before any user information enters the translators.
+ (i.e. any \property or event is not processed yet.)
+*/
void
-Translator:: stop_translation_timestep ()
+Translator::start_translation_timestep ()
{
}
void
-Translator::start_translation_timestep ()
+Translator::initialize ()
{
}
void
-Translator::do_announces ()
+Translator::finalize ()
{
}
void
-Translator::initialize ()
+Translator::connect_to_context (Context *c)
{
+ for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
+ c->events_below ()->add_listener (r->get_listener_ (this), r->event_class_);
}
void
-Translator::finalize ()
+Translator::disconnect_from_context (Context *c)
{
+ for (translator_listener_record *r = get_listener_list (); r; r=r->next_)
+ c->events_below ()->remove_listener (r->get_listener_ (this), r->event_class_);
}
+static SCM listened_event_classes = SCM_EOL;
+
+LY_DEFINE (ly_get_listened_event_classes, "ly:get-listened-event-classes",
+ 0, 0, 0, (),
+ "Returns a list of all event classes that some translator listens to.")
+{
+ return listened_event_classes;
+}
/*
+ Internally called once, statically, for each translator
+ listener. Connects the name of an event class with a procedure that
+ fetches the corresponding listener.
- SMOBS
+ The method should only be called from the macro
+ IMPLEMENT_TRANSLATOR_LISTENER.
+ */
+void
+Translator::add_translator_listener (translator_listener_record **listener_list,
+ translator_listener_record *r,
+ Listener (*get_listener) (void *),
+ const char *ev_class)
+{
+ /* ev_class is the C++ identifier name. Convert to scm symbol */
+ string name = string (ev_class);
+ name = replace_all (name, '_', '-');
+ name = name + "-event";
+ /* It's OK to use scm_gc_protect_object for protection, because r is
+ statically allocated. */
+ SCM class_sym = scm_gc_protect_object (scm_str2symbol (name.c_str ()));
+ listened_event_classes = scm_gc_protect_object (scm_cons (class_sym, listened_event_classes));
+ r->event_class_ = class_sym;
+ r->get_listener_ = get_listener;
+ r->next_ = *listener_list;
+ *listener_list = r;
+}
+/*
+ SMOBS
*/
SCM
Translator::mark_smob (SCM sm)
{
- Translator * me = (Translator*) SCM_CELL_WORD_1 (sm);
- scm_gc_mark (me->simple_trans_list_);
- scm_gc_mark (me->trans_group_list_);
- scm_gc_mark (me->definition_);
- scm_gc_mark (me->properties_scm_);
+ Translator *me = (Translator *) SCM_CELL_WORD_1 (sm);
+ me->derived_mark ();
+ return SCM_EOL;
+}
- return me->properties_scm_;
+Global_context *
+Translator::get_global_context () const
+{
+ return daddy_context_->get_global_context ();
}
-MAKE_SCHEME_CALLBACK(Translator,name,1);
-SCM
-Translator::name (SCM trans)
+Context *
+Translator::get_score_context () const
{
- if (unsmob_translator (trans))
- {
- char const* nm = classname (unsmob_translator (trans));
- return ly_str02scm (nm);
- }
- return
- SCM_EOL;
+ return daddy_context_->get_score_context ();
}
-MAKE_SCHEME_CALLBACK(Translator,description,1)
-SCM
-Translator::description (SCM me)
+IMPLEMENT_SMOBS (Translator);
+IMPLEMENT_DEFAULT_EQUAL_P (Translator);
+IMPLEMENT_TYPE_P (Translator, "ly:translator?");
+
+bool
+Translator::must_be_last () const
{
- if (unsmob_translator (me))
- return unsmob_translator(me)->translator_description ();
- else
- {
- programming_error ("Translator::description ()");
- return SCM_EOL;
- }
+ return must_be_last_;
}
-SCM
-Translator::translator_description () const
+void
+Translator::derived_mark () const
{
- return SCM_EOL;
}
int
Translator::print_smob (SCM s, SCM port, scm_print_state *)
{
- Translator *sc = (Translator *) ly_cdr (s);
-
+ Translator *me = (Translator *) SCM_CELL_WORD_1 (s);
scm_puts ("#<Translator ", port);
- scm_display (name (s), port);
- scm_display (sc->simple_trans_list_, port);
- /*
- don't try to print properties, that is too much hassle.
- */
+ scm_puts (me->class_name (), port);
scm_puts (" >", port);
-
return 1;
}
-SCM
-Translator::static_translator_description ()const
+void
+add_acknowledger (Engraver_void_function_engraver_grob_info ptr,
+ char const *func_name,
+ vector<Acknowledge_information> *ack_array)
{
- return SCM_EOL;
+ Acknowledge_information inf;
+ inf.function_ = ptr;
+
+ string interface_name (func_name);
+
+ interface_name = replace_all (interface_name, '_', '-');
+ interface_name += "-interface";
+
+ inf.symbol_ = scm_gc_protect_object (ly_symbol2scm (interface_name.c_str ()));
+ ack_array->push_back (inf);
}
+Engraver_void_function_engraver_grob_info
+generic_get_acknowledger (SCM sym, vector<Acknowledge_information> const *ack_array)
+{
+ for (vsize i = 0; i < ack_array->size (); i++)
+ {
+ if (ack_array->at (i).symbol_ == sym)
+ return ack_array->at (i).function_;
+ }
+ return 0;
+}
-IMPLEMENT_SMOBS (Translator);
-IMPLEMENT_DEFAULT_EQUAL_P (Translator);
+Moment
+get_event_length (Stream_event *e)
+{
+ Moment *m = unsmob_moment (e->get_property ("length"));
+ if (m)
+ return *m;
+ else
+ return Moment (0);
+}
+
+/*
+ Helper, used through ASSIGN_EVENT_ONCE to throw warnings for
+ simultaneous events. The helper is only useful in listen_* methods
+ of translators.
+*/
+bool
+internal_event_assignment (Stream_event **old_ev, Stream_event *new_ev, const char *function)
+{
+ if (*old_ev)
+ {
+ /* extract event class from function name */
+ const char *prefix = "listen_";
+ assert (!strncmp (function, "listen_", strlen (prefix)));
+ function += strlen (prefix);
+ char ev_class[strlen (function) + 1];
+ strcpy (ev_class, function);
+ for (char *c = ev_class; *c; c++)
+ if (*c == '_')
+ *c = '-';
+
+ new_ev->origin ()->warning (_f ("Two simultaneous %s events, junking this one", ev_class));
+ (*old_ev)->origin ()->warning (_f ("Previous %s event here", ev_class));
+ return false;
+ }
+ else
+ {
+ *old_ev = new_ev;
+ return true;
+ }
+}
+
+ADD_TRANSLATOR (Translator,
+ "Base class. Unused",
+ "",
+ "",
+ "",
+ "");