]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/grace-engraver.cc
Web-ja: update introduction
[lilypond.git] / lily / grace-engraver.cc
index ee9eaf9bf4532b57f8d5f4c12e7cb184c800a656..59550ba8326c17c9c2bd5bb74360020ccd40573f 100644 (file)
 /*
-  grace-engraver.cc -- implement Grace_engraver
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 2004--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 2004--2006 Han-Wen Nienhuys <hanwen@xs4all.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 "engraver.hh"
 #include "context.hh"
+#include "dispatcher.hh"
+#include "listener.hh"
 #include "warn.hh"
+#include "grob-properties.hh"
+#include "stream-event.hh"
+#include "translator.icc"
 
 class Grace_engraver : public Engraver
 {
+  Moment last_moment_;
+  SCM grace_settings_;
   void consider_change_grace_settings ();
 protected:
-  void start_translation_timestep ();
   virtual void derived_mark () const;
-  virtual void initialize ();
+  virtual void process_music ();
+  virtual void start_translation_timestep ();
+  virtual void finalize ();
 
   TRANSLATOR_DECLARATIONS (Grace_engraver);
-  Moment last_moment_;
-  SCM grace_settings_;
-public:
+  void grace_change (SCM);
 };
 
-Grace_engraver::Grace_engraver ()
+Grace_engraver::Grace_engraver (Context *c)
+  : Engraver (c)
 {
   grace_settings_ = SCM_EOL;
   last_moment_ = Moment (Rational (-1, 1));
 }
 
+// The iterator should usually come before process_music
 void
-Grace_engraver::initialize ()
+Grace_engraver::grace_change (SCM)
 {
   consider_change_grace_settings ();
 }
 
+// if we are in grace time already on initialization, it is unlikely
+// that we'll receive a GraceChange event from the grace iterator yet,
+// so we want to start into grace mode anyway.  The downside is that
+// this will get us confused when given something like
+//
+// \new Voice { \oneVoice \grace { c''8 8 } g'1 }
+//
+// where \grace executes its actions already before \oneVoice, causing
+// different stem directions.
+
+void
+Grace_engraver::start_translation_timestep ()
+{
+  // Only on startup
+  if (last_moment_ == Rational (-1))
+    consider_change_grace_settings ();
+}
+
+// If the grace iterator has moved off to some other context, we might
+// not get to see the ChangeContext event.  In that case, we still
+// want to change into or out of grace mode settings as appropriate
+
+void
+Grace_engraver::process_music ()
+{
+  // We may have lost connection to the iterator in which case we
+  // still need to call consider_change_grace_settings in particular
+  // in order to get out of grace mode again
+  if (last_moment_ != now_mom ())
+    consider_change_grace_settings ();
+}
+
 void
 Grace_engraver::consider_change_grace_settings ()
 {
   Moment now = now_mom ();
-  if (last_moment_.grace_part_ && !now.grace_part_)
+
+  if (!now.grace_part_)
     {
       for (SCM s = grace_settings_; scm_is_pair (s); s = scm_cdr (s))
-       {
-         SCM context = scm_caar (s);
-         SCM entry = scm_cdar (s);
-         SCM grob = scm_cadr (entry);
-         SCM sym = scm_caddr (entry);
-
-         execute_pushpop_property (unsmob_context (context),
-                                   grob, sym, SCM_UNDEFINED);
-       }
-
+        {
+          SCM elt = scm_car (s);
+          SCM context = scm_car (elt);
+          SCM grob = scm_cadr (elt);
+          SCM cell = scm_cddr (elt);
+
+          Grob_property_info (unsmob<Context> (context), grob).matched_pop (cell);
+        }
       grace_settings_ = SCM_EOL;
     }
-  else if (!last_moment_.grace_part_ && now.grace_part_)
+  else if (!last_moment_.grace_part_)
     {
       SCM settings = get_property ("graceSettings");
 
       grace_settings_ = SCM_EOL;
       for (SCM s = settings; scm_is_pair (s); s = scm_cdr (s))
-       {
-         SCM entry = scm_car (s);
-         SCM context_name = scm_car (entry);
-         SCM grob = scm_cadr (entry);
-         SCM sym = scm_caddr (entry);
-         SCM val = scm_cadr (scm_cddr (entry));
-
-         Context *c = context ();
-         while (c && !c->is_alias (context_name))
-           c = c->get_parent_context ();
-
-         if (c)
-           {
-             execute_pushpop_property (c,
-                                       grob, sym, val);
-             grace_settings_
-               = scm_cons (scm_cons (c->self_scm (), entry), grace_settings_);
-           }
-         else
-           {
-             programming_error ("can't find context");
-             scm_display (context_name, scm_current_error_port ());
-           }
-       }
+        {
+          SCM entry = scm_car (s);
+          SCM context_name = scm_car (entry);
+          SCM grob = scm_cadr (entry);
+          SCM sym = scm_caddr (entry);
+          SCM val = scm_cadr (scm_cddr (entry));
+
+          if (!scm_is_pair (sym))
+            sym = scm_list_1 (sym);
+
+          Context *c = find_context_above (context (), context_name);
+          if (c)
+            {
+              SCM cell = Grob_property_info (c, grob).push (sym, val);
+              grace_settings_
+                = scm_cons (scm_cons2 (c->self_scm (), grob, cell), grace_settings_);
+            }
+          else
+            programming_error ("cannot find context from graceSettings: "
+                               + ly_symbol2string (context_name));
+        }
+    }
+  if (last_moment_ == Rational (-1))
+    {
+      Dispatcher *d = context ()->event_source ();
+      d->add_listener (GET_LISTENER (Grace_engraver, grace_change), ly_symbol2scm ("GraceChange"));
     }
+  last_moment_ = now;
+}
 
-  last_moment_ = now_mom ();
+void
+Grace_engraver::finalize ()
+{
+  if (last_moment_ != Rational (-1))
+    {
+      Dispatcher *d = context ()->event_source ();
+      d->remove_listener (GET_LISTENER (Grace_engraver, grace_change), ly_symbol2scm ("GraceChange"));
+    }
 }
 
 void
@@ -98,16 +159,21 @@ Grace_engraver::derived_mark () const
 }
 
 void
-Grace_engraver::start_translation_timestep ()
+Grace_engraver::boot ()
 {
-  consider_change_grace_settings ();
-}
 
-#include "translator.icc"
+}
 
 ADD_TRANSLATOR (Grace_engraver,
-               /* doc */ "Set font size and other properties for grace notes.",
-               /* create */ "",
-               /* accept */ "",
-               /* read */ "graceSettings",
-               /* write */ "");
+                /* doc */
+                "Set font size and other properties for grace notes.",
+
+                /* create */
+                "",
+
+                /* read */
+                "graceSettings ",
+
+                /* write */
+                ""
+               );