2 This file is part of LilyPond, the GNU music typesetter.
4 Copyright (C) 2005--2015 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 #ifndef TRANSLATOR_ICC
21 #define TRANSLATOR_ICC
23 #include "listener.hh"
24 #include "std-vector.hh"
25 #include "translator.hh"
28 TODO: derive "foo-bar-interface" from Foo_bar classname.
32 A macro to automate administration of translators.
34 #define ADD_THIS_TRANSLATOR(T) \
35 SCM T::static_description_ = SCM_EOL; \
36 static void _ ## T ## _adder () \
39 T::static_description_ = \
40 scm_permanent_object (t->static_translator_description ()); \
43 SCM T::translator_description () const \
45 return static_description_; \
47 ADD_GLOBAL_CTOR (_ ## T ## _adder); \
50 #define DEFINE_TRANSLATOR_LISTENER_LIST(T) \
51 Protected_scm T::listener_list_ (SCM_EOL); \
54 #define DEFINE_ACKNOWLEDGERS(classname) \
55 Drul_array< vector<Acknowledge_information> > classname::acknowledge_static_array_drul_; \
56 Translator::Grob_info_callback \
57 classname::static_get_acknowledger (SCM sym) \
59 return generic_get_acknowledger (sym, &acknowledge_static_array_drul_[START]); \
61 Translator::Grob_info_callback \
62 classname::static_get_end_acknowledger (SCM sym) \
64 return generic_get_acknowledger (sym, &acknowledge_static_array_drul_[STOP]); \
68 #define DEFINE_TRANSLATOR_DOC(classname, desc, grobs, read, write) \
70 classname::static_translator_description () const \
72 return Translator::static_translator_description (grobs, desc, listener_list_, read, write); \
75 #define ADD_TRANSLATOR_FAMILY(classname) \
76 IMPLEMENT_FETCH_PRECOMPUTABLE_METHODS (classname); \
77 DEFINE_ACKNOWLEDGERS(classname) \
79 #define ADD_TRANSLATOR(classname, desc, grobs, read, write) \
80 ADD_TRANSLATOR_FAMILY (classname) \
81 ADD_THIS_TRANSLATOR (classname); \
82 DEFINE_TRANSLATOR_DOC(classname, desc, grobs, read, write) \
83 DEFINE_TRANSLATOR_LISTENER_LIST(classname) \
85 #define IMPLEMENT_FETCH_PRECOMPUTABLE_METHODS(T) \
87 T::fetch_precomputable_methods (Translator::Callback ptrs[]) \
89 ptrs[START_TRANSLATION_TIMESTEP] = \
90 (&T::start_translation_timestep \
91 == &Translator::start_translation_timestep) \
93 : static_cast<Callback> (&T::start_translation_timestep); \
95 ptrs[STOP_TRANSLATION_TIMESTEP] = \
96 (& T::stop_translation_timestep == & Translator::stop_translation_timestep) \
98 : static_cast<Callback> (&T::stop_translation_timestep); \
100 ptrs[PROCESS_MUSIC] = \
101 (&T::process_music == &Translator::process_music) \
103 : static_cast<Callback> (&T::process_music); \
105 ptrs[PROCESS_ACKNOWLEDGED] = \
106 (&T::process_acknowledged == &Translator::process_acknowledged) \
108 : static_cast<Callback> (&T::process_acknowledged); \
111 void add_acknowledger (Translator::Grob_info_callback ptr,
112 char const *func_name,
113 vector<Acknowledge_information> *ack_array);
115 Translator::Grob_info_callback
116 generic_get_acknowledger (SCM sym,
117 vector<Acknowledge_information> const *ack_array);
119 #define ADD_ACKNOWLEDGER(CLASS, NAME) \
120 void CLASS ## NAME ## _ack_adder () \
122 add_acknowledger (static_cast<Translator::Grob_info_callback> (&CLASS::acknowledge_ ## NAME), #NAME, &CLASS::acknowledge_static_array_drul_[START]); \
124 ADD_SCM_INIT_FUNC (CLASS ## NAME ## _ack_adder_initclass, CLASS ## NAME ## _ack_adder);
126 #define ADD_END_ACKNOWLEDGER(CLASS, NAME) \
127 void CLASS ## NAME ## _end_ack_adder () \
129 add_acknowledger (static_cast<Translator::Grob_info_callback> (&CLASS::acknowledge_end_ ## NAME), #NAME, &CLASS::acknowledge_static_array_drul_[STOP]); \
131 ADD_SCM_INIT_FUNC (CLASS ## NAME ## _end_ack_adder_initclass, CLASS ## NAME ## _end_ack_adder);
134 Implement the method cl::listen_##m, and make it listen to stream
137 #define IMPLEMENT_TRANSLATOR_LISTENER(cl, m) \
139 cl :: _internal_declare_ ## m () \
141 listener_list_ = scm_acons \
142 (event_class_symbol (#m), \
143 Callback_wrapper::make_smob<cl, Stream_event *, &cl::listen_ ## m> (), \
147 ADD_SCM_INIT_FUNC (cl ## _declare_event_ ## m, cl::_internal_declare_ ## m);
149 #endif /* TRANSLATOR_ICC */