2 global-context-scheme.cc -- implement Global_context bindings
4 source file of the GNU LilyPond music typesetter
6 (c) 2005--2007 Han-Wen Nienhuys <hanwen@xs4all.nl>
8 #include "cpu-timer.hh"
9 #include "global-context.hh"
10 #include "international.hh"
12 #include "music-iterator.hh"
13 #include "music-output.hh"
15 #include "object-key.hh"
16 #include "output-def.hh"
17 #include "translator-group.hh"
20 LY_DEFINE (ly_format_output, "ly:format-output",
21 1, 0, 0, (SCM context),
22 "Given a Global context in its final state, "
23 "process it and return the @code{Music_output} object in its final state.")
25 Global_context *g = dynamic_cast<Global_context *> (unsmob_context (context));
26 SCM_ASSERT_TYPE (g, context, SCM_ARG1, __FUNCTION__, "Global context");
28 SCM output = g->get_output ();
29 progress_indication ("\n");
31 if (Music_output *od = unsmob_music_output (output))
37 LY_DEFINE (ly_make_global_translator, "ly:make-global-translator",
38 1, 0, 0, (SCM global),
39 "Create a translator group and connect it to the global context\n"
40 "@var{global}. The translator group is returned.")
42 Global_context *g = dynamic_cast<Global_context *> (unsmob_context (global));
43 SCM_ASSERT_TYPE (g, global, SCM_ARG1, __FUNCTION__, "Global context");
45 Translator_group *tg = new Translator_group ();
46 tg->connect_to_context (g);
47 g->implementation_ = tg;
49 return tg->unprotect ();
52 LY_DEFINE (ly_make_global_context, "ly:make-global-context",
53 1, 0, 0, (SCM output_def),
54 "Set up a global interpretation context, using the output\n"
55 "block @var{output_def}.\n"
56 "The context is returned.\n"
59 Output_def *odef = unsmob_output_def (output_def);
61 SCM_ASSERT_TYPE (odef, output_def, SCM_ARG1, __FUNCTION__,
64 Global_context *glob = new Global_context (odef);
68 programming_error ("no toplevel translator");
72 return glob->unprotect ();
75 LY_DEFINE (ly_interpret_music_expression, "ly:interpret-music-expression",
76 2, 0, 0, (SCM mus, SCM ctx),
77 "Interpret the music expression @var{mus} in the\n"
78 "global context @var{ctx}. The context is returned in its\n"
81 Music *music = unsmob_music (mus);
82 Global_context *g = dynamic_cast<Global_context *> (unsmob_context (ctx));
83 SCM_ASSERT_TYPE (music, mus, SCM_ARG1, __FUNCTION__, "Music");
84 SCM_ASSERT_TYPE (g, ctx, SCM_ARG2, __FUNCTION__, "Global context");
87 || !music->get_length ().to_bool ())
89 warning (_ ("no music found in score"));
95 message (_ ("Interpreting music... "));
97 SCM protected_iter = Music_iterator::get_static_get_iterator (music);
98 Music_iterator *iter = unsmob_iterator (protected_iter);
100 iter->init_context (music, g);
101 iter->construct_children ();
105 warning (_ ("no music found in score"));
106 /* todo: should throw exception. */
110 g->run_iterator_on_me (iter);
113 scm_remember_upto_here_1 (protected_iter);
115 send_stream_event (g, "Finish", 0, 0);
117 if (be_verbose_global)
118 message (_f ("elapsed time: %.2f seconds", timer.read ()));
123 LY_DEFINE (ly_run_translator, "ly:run-translator",
124 2, 1, 0, (SCM mus, SCM output_def),
125 "Process @var{mus} according to @var{output_def}. \n"
126 "An interpretation context is set up,\n"
127 "and @var{mus} is interpreted with it. \n"
128 "The context is returned in its final state.\n"
130 "Optionally, this routine takes an Object-key to\n"
131 "to uniquely identify the Score block containing it.\n")
133 SCM glob = ly_make_global_context (output_def);
134 ly_make_global_translator (glob);
135 ly_interpret_music_expression (mus, glob);