]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/key-engraver.cc
Release: bump VERSION_DEVEL.
[lilypond.git] / lily / key-engraver.cc
index 17ffce32374982aa04897e62d2bd7e786f145c93..a61d7701d768dbb4c28246ac72743c3d7265303a 100644 (file)
 /*
-  key-engraver.cc -- implement Key_engraver
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c)  1997--2001 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.
 
-#include "key-item.hh"
-#include "command-request.hh"
-#include "musical-request.hh"
-#include "item.hh"
-#include "bar.hh"
-#include "timing-translator.hh"
-#include "staff-symbol-referencer.hh"
-#include "translator-group.hh"
+  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 "clef.hh"
+#include "context.hh"
 #include "engraver.hh"
+#include "international.hh"
+#include "item.hh"
 #include "pitch.hh"
 #include "protected-scm.hh"
-#include "clef.hh"
+#include "staff-symbol-referencer.hh"
+#include "stream-event.hh"
+
+#include "translator.icc"
 
-/**
-  Make the key signature.
- */
 class Key_engraver : public Engraver
 {
   void create_key (bool);
-  void read_req (Key_change_req const * r);
+  void read_event (Stream_event const *r);
 
+  Stream_event *key_event_;
+  Item *item_;
+  Item *cancellation_;
 public:
-  TRANSLATOR_DECLARATIONS(Key_engraver);
+  TRANSLATOR_DECLARATIONS (Key_engraver);
 
-  Key_change_req * keyreq_l_;
-  Item * item_p_;
-  Protected_scm old_accs_;     // ugh. -> property
-    
 protected:
   virtual void initialize ();
   virtual void finalize ();
-  virtual bool try_music (Music *req_l);
-  virtual void stop_translation_timestep ();
-  virtual void start_translation_timestep ();
-  virtual void create_grobs ();
-  virtual void acknowledge_grob (Grob_info);
-};
+  void stop_translation_timestep ();
+  void process_music ();
 
+  void listen_key_change (Stream_event *);
+  void acknowledge_clef (Grob_info);
+  void acknowledge_bar_line (Grob_info);
+};
 
 void
 Key_engraver::finalize ()
 {
-  old_accs_ = SCM_EOL;         // unprotect can not  be called from dtor.
 }
 
-Key_engraver::Key_engraver ()
+Key_engraver::Key_engraver (Context *c)
+  : Engraver (c)
 {
-  keyreq_l_ = 0;
-  item_p_ = 0;
+  key_event_ = 0;
+  item_ = 0;
+  cancellation_ = 0;
 }
 
 void
-Key_engraver::create_key (bool def)
+Key_engraver::create_key (bool is_default)
 {
-  if (!item_p_) 
+  if (!item_)
     {
-      item_p_ = new Item (get_property ("KeySignature"));
-
-      item_p_->set_grob_property ("c0-position", gh_int2scm (0));
-
-      // todo: put this in basic props.
-      item_p_->set_grob_property ("old-accidentals", old_accs_);
-      item_p_->set_grob_property ("new-accidentals", get_property ("keySignature"));
-
-      Staff_symbol_referencer::set_interface (item_p_);
-      Key_item::set_interface (item_p_);
-
-      
-      announce_grob (item_p_,keyreq_l_);
+      item_ = make_item ("KeySignature",
+                         key_event_ ? key_event_->self_scm () : SCM_EOL);
+
+      /* Use middleCClefPosition rather than middleCPosition, because cue
+       * notes with a different clef will modify middleCPosition. The
+       * Key signature, however, should still be printed at the original
+       * position. */
+      item_->set_property ("c0-position",
+                           get_property ("middleCClefPosition"));
+
+      SCM last = get_property ("lastKeyAlterations");
+      SCM key = get_property ("keyAlterations");
+
+      if ((to_boolean (get_property ("printKeyCancellation"))
+           || scm_is_null (key))
+          && !scm_is_eq (last, key))
+        {
+          SCM restore = SCM_EOL;
+          for (SCM s = last; scm_is_pair (s); s = scm_cdr (s))
+            {
+              SCM new_alter_pair = scm_assoc (scm_caar (s), key);
+              Rational old_alter = robust_scm2rational (scm_cdar (s), 0);
+              if (scm_is_false (new_alter_pair)
+                  || ((ly_scm2rational (scm_cdr (new_alter_pair)) - old_alter) * old_alter
+                      < Rational (0)))
+                {
+                  restore = scm_cons (scm_car (s), restore);
+                }
+            }
+
+          if (scm_is_pair (restore))
+            {
+              cancellation_ = make_item ("KeyCancellation",
+                                         key_event_
+                                         ? key_event_->self_scm () : SCM_EOL);
+
+              cancellation_->set_property ("alteration-alist", restore);
+              cancellation_->set_property ("c0-position",
+                                           get_property ("middleCClefPosition"));
+            }
+        }
+
+      item_->set_property ("alteration-alist", scm_reverse (key));
     }
 
-
-  if (!def)
+  if (!is_default)
     {
-      SCM vis = get_property ("explicitKeySignatureVisibility"); 
-      if (gh_procedure_p (vis))
-       item_p_->set_grob_property ("visibility-lambda",vis);
+      SCM visibility = get_property ("explicitKeySignatureVisibility");
+      item_->set_property ("break-visibility", visibility);
+      item_->set_property ("non-default", SCM_BOOL_T);
     }
-}      
-
+}
 
-bool
-Key_engraver::try_music (Music * req_l)
+void
+Key_engraver::listen_key_change (Stream_event *ev)
 {
-  if (Key_change_req *kc = dynamic_cast <Key_change_req *> (req_l))
-    {
-      if (keyreq_l_ && !keyreq_l_->equal_b (kc))
-       {
-         kc->origin ()->warning (_ ("Conflicting key signatures found."));
-         keyreq_l_->origin ()->warning (_ ("This was the other key definition."));       
-         return false;
-       }
-      keyreq_l_ = kc;
-      read_req (keyreq_l_);
-
-      return true;
-    }   
-  return  false;
+  /* do this only once, just to be on the safe side.  */
+  if (ASSIGN_EVENT_ONCE (key_event_, ev))
+    read_event (key_event_);
 }
 
 void
-Key_engraver::acknowledge_grob (Grob_info info)
+Key_engraver::acknowledge_clef (Grob_info /* info */)
 {
-  if (Clef::has_interface (info.grob_l_))
-    {
-      SCM c =  get_property ("createKeyOnClefChange");
-      if (to_boolean (c))
-       {
-         create_key (false);
-       }
-    }
-  else if (Bar::has_interface (info.grob_l_)
-          && gh_pair_p (get_property ("keySignature")))
-    {
-      create_key (true);
-    }
+  SCM c = get_property ("createKeyOnClefChange");
+  if (to_boolean (c))
+    create_key (false);
+}
 
+void
+Key_engraver::acknowledge_bar_line (Grob_info /* info */)
+{
+  create_key (true);
 }
 
 void
-Key_engraver::create_grobs ()
+Key_engraver::process_music ()
 {
-  if (keyreq_l_ || old_accs_ != get_property ("keySignature"))
-    {
-      create_key (false);
-    }
+  if (key_event_
+      || !scm_is_eq (get_property ("lastKeyAlterations"),
+                     get_property ("keyAlterations")))
+    create_key (false);
 }
 
 void
 Key_engraver::stop_translation_timestep ()
-{ 
-  if (item_p_) 
-    {
-      typeset_grob (item_p_);
-      item_p_ = 0;
-    }
+{
+  item_ = 0;
+  context ()->set_property ("lastKeyAlterations", get_property ("keyAlterations"));
+  cancellation_ = 0;
+  key_event_ = 0;
 }
 
 void
-Key_engraver::read_req (Key_change_req const * r)
+Key_engraver::read_event (Stream_event const *r)
 {
-  SCM p = r->get_mus_property ("pitch-alist");
-  if (!gh_pair_p (p))
+  SCM p = r->get_property ("pitch-alist");
+  if (!scm_is_pair (p))
     return;
 
-  SCM n = scm_list_copy (p);
   SCM accs = SCM_EOL;
-  for (SCM s = get_property ("keyAccidentalOrder");
-       gh_pair_p (s); s = ly_cdr (s))
+
+  SCM alist = scm_list_copy (p);
+  SCM order = get_property ("keyAlterationOrder");
+  for (SCM s = order;
+       scm_is_pair (s) && scm_is_pair (alist); s = scm_cdr (s))
     {
-      if (gh_pair_p (scm_member (ly_car (s), n)))
-       {
-         accs = gh_cons (ly_car (s), accs);
-         n = scm_delete_x (ly_car (s), n);
-       }
+      SCM head = scm_member (scm_car (s), alist);
+
+      if (scm_is_pair (head))
+        {
+          accs = scm_cons (scm_car (head), accs);
+          alist = scm_delete_x (scm_car (head), alist);
+        }
     }
-  for (SCM s = n ; gh_pair_p (s); s = ly_cdr (s))
-    if (gh_scm2int (ly_cdar (s)))
-      accs = gh_cons (ly_car (s), accs);
 
-  old_accs_ = get_property ("keySignature");
-  daddy_trans_l_->set_property ("keySignature", accs);
-}
+  if (scm_is_pair (alist))
+    {
+      bool warn = false;
+      for (SCM s = alist; scm_is_pair (s); s = scm_cdr (s))
+        if (ly_scm2rational (scm_cdar (s)))
+          {
+            warn = true;
+            accs = scm_cons (scm_car (s), accs);
+          }
+
+      if (warn)
+        r->origin ()->warning (_ ("Incomplete keyAlterationOrder for key signature"));
+    }
 
-void
-Key_engraver::start_translation_timestep ()
-{
-  keyreq_l_ = 0;
-  old_accs_ = get_property ("keySignature");
+  context ()->set_property ("keyAlterations", scm_reverse_x (accs, SCM_EOL));
+  context ()->set_property ("tonic",
+                            r->get_property ("tonic"));
 }
 
 void
 Key_engraver::initialize ()
 {
-  daddy_trans_l_->set_property ("keySignature", SCM_EOL);
-  old_accs_ = SCM_EOL;
-}
+  context ()->set_property ("keyAlterations", SCM_EOL);
+  context ()->set_property ("lastKeyAlterations", SCM_EOL);
 
+  Pitch p;
+  context ()->set_property ("tonic", p.smobbed_copy ());
+}
 
 
+void
+Key_engraver::boot ()
+{
+  ADD_LISTENER (Key_engraver, key_change);
+  ADD_ACKNOWLEDGER (Key_engraver, clef);
+  ADD_ACKNOWLEDGER (Key_engraver, bar_line);
+}
 
-ENTER_DESCRIPTION(Key_engraver,
-/* descr */       "",
-/* creats*/       "KeySignature",
-/* acks  */       "bar-line-interface clef-interface",
-/* reads */       "keySignature explicitKeySignatureVisibility createKeyOnClefChange keyAccidentalOrder keySignature",
-/* write */       "");
+ADD_TRANSLATOR (Key_engraver,
+                /* doc */
+                "Engrave a key signature.",
+
+                /* create */
+                "KeyCancellation "
+                "KeySignature ",
+
+                /* read */
+                "createKeyOnClefChange "
+                "explicitKeySignatureVisibility "
+                "extraNatural "
+                "keyAlterationOrder "
+                "keyAlterations "
+                "lastKeyAlterations "
+                "printKeyCancellation "
+                "middleCClefPosition ",
+
+                /* write */
+                "keyAlterations "
+                "lastKeyAlterations "
+                "tonic "
+               );