/*
- engraver.cc -- implement Engraver
+ This file is part of LilyPond, the GNU music typesetter.
- Sourcefile of GNU LilyPond musictypesetter
+ Copyright (C) 1997--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
- (c) 1997 Han-Wen Nienhuys <hanwen@stack.nl>
+ LilyPond is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ LilyPond is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
*/
-#include "music-list.hh"
-#include "musical-request.hh"
#include "engraver.hh"
-#include "engraver-group.hh"
-#include "debug.hh"
-void
-Engraver::post_move_processing()
+#include "context.hh"
+#include "international.hh"
+#include "music.hh"
+#include "paper-column.hh"
+#include "score-engraver.hh"
+#include "spanner.hh"
+#include "stream-event.hh"
+#include "warn.hh"
+
+Engraver_group *
+Engraver::get_daddy_engraver () const
{
- if (status < CREATION_INITED) {
- do_creation_processing();
- status = CREATION_INITED;
- }
- if (status >= MOVE_INITED)
- return;
+ return dynamic_cast<Engraver_group *> (get_daddy_translator ());
+}
- do_post_move_processing();
- status = MOVE_INITED;
+void
+Engraver::announce_grob (Grob_info inf)
+{
+ get_daddy_engraver ()->announce_grob (inf);
}
void
-Engraver::removal_processing()
+Engraver::announce_end_grob (Grob_info inf)
{
- if ( status < CREATION_INITED )
- do_creation_processing();
-
- do_removal_processing();
+ inf.start_end_ = STOP;
+ get_daddy_engraver ()->announce_grob (inf);
}
-bool
-Engraver::try_request(Request * r)
+Grob_info
+Engraver::make_grob_info (Grob *e, SCM cause)
{
- if (status < MOVE_INITED)
- post_move_processing();
+ /* TODO: Remove Music code when it's no longer needed */
+ if (Music *m = unsmob_music (cause))
+ {
+ cause = m->to_event ()->unprotect ();
+ }
+ if (e->get_property ("cause") == SCM_EOL
+ && (unsmob_stream_event (cause) || unsmob_grob (cause)))
+ e->set_property ("cause", cause);
- return do_try_request(r);
+ return Grob_info (this, e);
}
+/*
+ CAUSE is the object (typically a Stream_event object) that
+ was the reason for making E.
+*/
void
-Engraver::process_requests()
+Engraver::announce_grob (Grob *e, SCM cause)
{
- if (status < PROCESSED_REQS)
- post_move_processing();
- else if (status >= PROCESSED_REQS)
- return;
-
- status = PROCESSED_REQS;
- do_process_requests();
+ announce_grob (make_grob_info (e, cause));
}
+/*
+ CAUSE is the object (typically a grob or stream-event object) that
+ was the reason for ending E. */
void
-Engraver::pre_move_processing()
+Engraver::announce_end_grob (Grob *e, SCM cause)
{
- do_pre_move_processing();
- status = CREATION_INITED;
+ announce_end_grob (make_grob_info (e, cause));
}
-void
-Engraver::fill_staff_info(Staff_info&)
+Engraver::Engraver ()
{
-
}
-Scalar
-Engraver::get_feature(String t)
+#ifndef NDEBUG
+static SCM creation_callback = SCM_EOL;
+LY_DEFINE (ly_set_grob_creation_callback, "ly:set-grob-creation-callback",
+ 1, 0, 0, (SCM cb),
+ "Specify a procedure that will be called every time a new grob"
+ " is created. The callback will receive as arguments the grob"
+ " that was created, the name of the C++ source file that caused"
+ " the grob to be created, and the corresponding line number in"
+ " the C++ source file.")
{
- return daddy_grav_l_->get_feature(t);
+ LY_ASSERT_TYPE (ly_is_procedure, cb, 1);
+
+ creation_callback = cb;
+
+ return SCM_UNSPECIFIED;
}
+#endif
-bool
-Engraver::do_try_request(Request*)
-{
- return false;
+Grob *
+Engraver::internal_make_grob (SCM symbol,
+ SCM cause,
+ char const * /* name */,
+ char const *file,
+ int line,
+ char const *fun)
+{
+#ifdef NDEBUG
+ (void)file;
+ (void)line;
+ (void)fun;
+#endif
+
+ SCM props = updated_grob_properties (context (), symbol);
+
+ Grob *grob = 0;
+
+ SCM handle = scm_sloppy_assq (ly_symbol2scm ("meta"), props);
+ SCM klass = scm_cdr (scm_sloppy_assq (ly_symbol2scm ("class"), scm_cdr (handle)));
+
+ if (klass == ly_symbol2scm ("Item"))
+ grob = new Item (props);
+ else if (klass == ly_symbol2scm ("Spanner"))
+ grob = new Spanner (props);
+ else if (klass == ly_symbol2scm ("Paper_column"))
+ grob = new Paper_column (props);
+
+ assert (grob);
+ announce_grob (grob, cause);
+
+#ifndef NDEBUG
+ if (ly_is_procedure (creation_callback))
+ scm_apply_0 (creation_callback,
+ scm_list_n (grob->self_scm (), scm_from_locale_string (file),
+ scm_from_int (line), scm_from_locale_string (fun), SCM_UNDEFINED));
+#endif
+
+ return grob;
}
-Engraver::Engraver()
+Item *
+Engraver::internal_make_item (SCM x, SCM cause,
+ char const *name,
+ char const *file, int line, char const *fun)
{
- status = VIRGIN;
- daddy_grav_l_ = 0;
+ Item *it = dynamic_cast<Item *> (internal_make_grob (x, cause, name, file, line, fun));
+ assert (it);
+ return it;
}
-void
-Engraver::announce_element(Score_elem_info i)
+Paper_column *
+Engraver::internal_make_column (SCM x, char const *name,
+ char const *file, int line, char const *fun)
{
- i.origin_grav_l_arr_.push(this);
- daddy_grav_l_->announce_element(i);
+ return dynamic_cast<Paper_column *> (internal_make_grob (x, SCM_EOL, name, file, line, fun));
}
-void
-Engraver::typeset_element(Score_elem*p)
+Spanner *
+Engraver::internal_make_spanner (SCM x, SCM cause, char const *name,
+ char const *file, int line, char const *fun)
{
- daddy_grav_l_->typeset_element(p);
+ Spanner *sp = dynamic_cast<Spanner *> (internal_make_grob (x, cause, name, file, line, fun));
+ assert (sp);
+ return sp;
}
-Paper_def*
-Engraver::paper()const
+Engraver *
+unsmob_engraver (SCM eng)
{
- return daddy_grav_l_->paper();
+ return dynamic_cast<Engraver *> (unsmob_translator (eng));
}
bool
-Engraver::contains_b(Engraver *grav_l)const
+ly_is_grob_cause (SCM obj)
{
- return this == grav_l;
+ return unsmob_grob (obj) || unsmob_stream_event (obj) || (obj == SCM_EOL);
}
-Staff_info
-Engraver::get_staff_info() const
-{
- return daddy_grav_l_->get_staff_info();
-}
+#include "translator.icc"
-void
-Engraver::print() const
-{
-#ifndef NPRINT
- mtor << "\n" << name() << " {";
- do_print();
- mtor << "}";
-#endif
-}
+ADD_TRANSLATOR (Engraver,
+ /* doc */
+ "Base class for engravers. Does nothing, so it is not used.",
+ /* create */
+ "",
-IMPLEMENT_IS_TYPE_B(Engraver);
+ /* read */
+ "",
-void
-Engraver::do_print() const
-{
-}
+ /* write */
+ ""
+ );