]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/engraver.cc
Release: bump Welcome versions.
[lilypond.git] / lily / engraver.cc
index 5f83295e18e8135c77b7bb95540b6b080ff70e3f..59c91306ef39496f5f729273686c0d58def2ab68 100644 (file)
 /*
-  engraver.cc -- implement Engraver
+  This file is part of LilyPond, the GNU music typesetter.
 
-  Sourcefile of GNU LilyPond music type setter
+  Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 1997--2004 Han-Wen Nienhuys <hanwen@cs.uu.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.hh"
 #include "engraver.hh"
-#include "engraver-group-engraver.hh"
-#include "grob.hh"
+
+#include "context.hh"
+#include "grob-properties.hh"
+#include "international.hh"
+#include "music.hh"
+#include "paper-column.hh"
 #include "score-engraver.hh"
-#include "warn.hh"
 #include "spanner.hh"
-#include "item.hh"
-#include "context.hh"
-#include "score-context.hh"
+#include "stream-event.hh"
+#include "warn.hh"
 
-Engraver_group_engraver*
+Engraver_group *
 Engraver::get_daddy_engraver () const
 {
-  return dynamic_cast<Engraver_group_engraver*> (get_daddy_translator ());
+  return dynamic_cast<Engraver_group *> (get_daddy_translator ());
 }
 
 void
-Engraver::announce_grob (Grob_info inf)
+Engraver::announce_grob (Grob_info inf, Context *reroute_context)
 {
-  get_daddy_engraver ()->announce_grob (inf);
+  get_daddy_engraver ()->announce_grob (inf, START, reroute_context);
 }
 
+void
+Engraver::announce_end_grob (Grob_info inf, Context *reroute_context)
+{
+  get_daddy_engraver ()->announce_grob (inf, STOP, reroute_context);
+}
+
+Grob_info
+Engraver::make_grob_info (Grob *e, SCM cause)
+{
+  /* TODO: Remove Music code when it's no longer needed */
+  if (Music *m = unsmob<Music> (cause))
+    {
+      cause = m->to_event ()->unprotect ();
+    }
+  if (scm_is_null (e->get_property ("cause"))
+      && (unsmob<Stream_event> (cause) || unsmob<Grob> (cause)))
+    e->set_property ("cause", cause);
+
+  return Grob_info (this, e);
+}
 
 /*
-  CAUSE is the object (typically a Music object)  that
+  CAUSE is the object (typically a Stream_event object)  that
   was the reason for making E.
- */
+*/
 void
-Engraver::announce_grob (Grobe, SCM cause)
+Engraver::announce_grob (Grob *e, SCM cause)
 {
-  if (unsmob_music (cause) || unsmob_grob (cause))
-    e->set_property ("cause", cause);
-
-  Grob_info i;
-  i.grob_ = e;
-  if (!i.origin_trans_)
-    i.origin_trans_ = this;
+  announce_grob (make_grob_info (e, cause));
+}
 
-  Engraver * g = get_daddy_engraver ();
-  if (g)
-    g->announce_grob (i);
+/*
+  CAUSE is the object (typically a grob or stream-event object) that
+  was the reason for ending E.  */
+void
+Engraver::announce_end_grob (Grob *e, SCM cause)
+{
+  announce_end_grob (make_grob_info (e, cause));
 }
 
+Engraver::Engraver (Context *c)
+  : Translator (c)
+{
+}
 
+#ifdef DEBUG
+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.")
+{
+  LY_ASSERT_TYPE (ly_is_procedure, cb, 1);
 
+  creation_callback = cb;
 
-Engraver::Engraver ()
-{
+  return SCM_UNSPECIFIED;
 }
+#endif
+
+Grob *
+Engraver::internal_make_grob (SCM symbol,
+                              SCM cause,
+                              char const *file,
+                              int line,
+                              char const *fun)
+{
+#ifndef DEBUG
+  (void)file;
+  (void)line;
+  (void)fun;
+#endif
+
+  SCM props = Grob_property_info (context (), symbol).updated ();
+
+  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 (scm_is_eq (klass, ly_symbol2scm ("Item")))
+    grob = new Item (props);
+  else if (scm_is_eq (klass, ly_symbol2scm ("Spanner")))
+    grob = new Spanner (props);
+  else if (scm_is_eq (klass, ly_symbol2scm ("Paper_column")))
+    grob = new Paper_column (props);
 
-Score_engraver* 
-Engraver::get_score_engraver () const
+  assert (grob);
+  announce_grob (grob, cause);
+
+#ifdef DEBUG
+  if (ly_is_procedure (creation_callback))
+    scm_call_4 (creation_callback,
+                grob->self_scm (), scm_from_utf8_string (file),
+                scm_from_int (line), scm_from_ascii_string (fun));
+#endif
+
+  return grob;
+}
+
+Item *
+Engraver::internal_make_item (SCM x, SCM cause,
+                              char const *file, int line, char const *fun)
 {
-  return dynamic_cast<Score_engraver*> (get_score_context ()->implementation ());
+  Item *it = dynamic_cast<Item *> (internal_make_grob (x, cause, file, line, fun));
+  assert (it);
+  return it;
 }
 
+Paper_column *
+Engraver::internal_make_column (SCM x, char const *file, int line, char const *fun)
+{
+  return dynamic_cast<Paper_column *> (internal_make_grob (x, SCM_EOL, file, line, fun));
+}
 
-ENTER_DESCRIPTION (Engraver,
-                  "", "",
-                 "",
-                 "", "", "");
+Spanner *
+Engraver::internal_make_spanner (SCM x, SCM cause,
+                                 char const *file, int line, char const *fun)
+{
+  Spanner *sp = dynamic_cast<Spanner *> (internal_make_grob (x, cause, file, line, fun));
+  assert (sp);
+  return sp;
+}
 
+bool
+ly_is_grob_cause (SCM obj)
+{
+  return unsmob<Grob> (obj) || unsmob<Stream_event> (obj) || scm_is_null (obj);
+}