]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/stem-engraver.cc
Doc-de: update of learning
[lilypond.git] / lily / stem-engraver.cc
index 7db456006cbca4d67d63d0245afc0f16e89a8a3c..6890b5b041c410f56186d1c8733eb4613e313179 100644 (file)
@@ -1,9 +1,20 @@
 /*
-  stem-engraver.cc -- implement Stem_engraver
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 1997--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 1997--2009 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"
@@ -58,52 +69,51 @@ Stem_engraver::make_stem (Grob_info gi)
   if (tremolo_ev_)
     {
       /* Stem tremolo is never applied to a note by default,
-        is must me requested.  But there is a default for the
-        tremolo value:
+         it must be requested.  But there is a default for the
+         tremolo value:
 
-        c4:8 c c:
+         c4:8 c c:
 
-        the first and last (quarter) note bothe get one tremolo flag.  */
+         the first and last (quarter) note both get one tremolo flag.  */
       int requested_type
-       = scm_to_int (tremolo_ev_->get_property ("tremolo-type"));
+        = robust_scm2int (tremolo_ev_->get_property ("tremolo-type"), 0);
       SCM f = get_property ("tremoloFlags");
       if (!requested_type)
-       {
-         if (scm_is_number (f))
-           requested_type = scm_to_int (f);
-         else
-           requested_type = 8;
-       }
+        {
+          if (scm_is_number (f))
+            requested_type = scm_to_int (f);
+          else
+            requested_type = 8;
+        }
       else
-       context ()->set_property ("tremoloFlags", scm_from_int (requested_type));
-
+        context ()->set_property ("tremoloFlags", scm_from_int (requested_type));
 
       /*
-       we take the duration log from the Event, since the duration-log
-       for a note head is always <= 2.
+        we take the duration log from the Event, since the duration-log
+        for a note head is always <= 2.
       */
       Stream_event *ev = gi.event_cause ();
       Duration *dur = unsmob_duration (ev->get_property ("duration"));
-      
+
       int tremolo_flags = intlog2 (requested_type) - 2
-       - (dur->duration_log () > 2 ? dur->duration_log () - 2 : 0);
+                          - (dur->duration_log () > 2 ? dur->duration_log () - 2 : 0);
       if (tremolo_flags <= 0)
-       {
-         tremolo_ev_->origin ()->warning (_ ("tremolo duration is too long"));
-         tremolo_flags = 0;
-       }
+        {
+          tremolo_ev_->origin ()->warning (_ ("tremolo duration is too long"));
+          tremolo_flags = 0;
+        }
 
       if (tremolo_flags)
-       {
-         tremolo_ = make_item ("StemTremolo", tremolo_ev_->self_scm ());
-
-         /* The number of tremolo flags is the number of flags of the
-            tremolo-type minus the number of flags of the note itself.  */
-         tremolo_->set_property ("flag-count", scm_from_int (tremolo_flags));
-         tremolo_->set_parent (stem_, X_AXIS);
-         stem_->set_object ("tremolo-flag", tremolo_->self_scm ());
-         tremolo_->set_object ("stem", stem_->self_scm ());
-       }
+        {
+          tremolo_ = make_item ("StemTremolo", tremolo_ev_->self_scm ());
+
+          /* The number of tremolo flags is the number of flags of the
+             tremolo-type minus the number of flags of the note itself.  */
+          tremolo_->set_property ("flag-count", scm_from_int (tremolo_flags));
+          tremolo_->set_parent (stem_, X_AXIS);
+          stem_->set_object ("tremolo-flag", tremolo_->self_scm ());
+          tremolo_->set_object ("stem", stem_->self_scm ());
+        }
     }
 }
 
@@ -123,11 +133,27 @@ Stem_engraver::acknowledge_rhythmic_head (Grob_info gi)
   if (!stem_)
     make_stem (gi);
 
-  if (Stem::duration_log (stem_) != d->duration_log ())
+  int ds = Stem::duration_log (stem_);
+  int dc = d->duration_log ();
+
+  // half notes and quarter notes all have compatible stems.
+  // Longas are done differently (oops?), so we can't unify
+  // them with the other stemmed notes.
+  if (ds == 1)
+    ds = 2;
+  if (dc == 1)
+    dc = 2;
+  // whole notes and brevis both have no stems
+  if (ds == -1)
+    ds = 0;
+  if (dc == -1)
+    dc = 0;
+
+  if (ds != dc)
     {
-      // FIXME: 
-      gi.event_cause ()->origin ()->warning (_f ("adding note head to incompatible stem (type = %d)",
-                                                1 << Stem::duration_log (stem_)));
+      gi.event_cause ()->origin ()->warning (_f ("adding note head to incompatible stem (type = %d/%d)",
+                                                 ds < 0 ? 1 << -ds : 1,
+                                                 ds > 0 ? 1 << ds : 1));
       gi.event_cause ()->origin ()->warning (_ ("maybe input should specify polyphonic voices"));
     }
 
@@ -143,16 +169,16 @@ Stem_engraver::stop_translation_timestep ()
       /* FIXME: junk these properties.  */
       SCM prop = get_property ("stemLeftBeamCount");
       if (scm_is_number (prop))
-       {
-         Stem::set_beaming (stem_, scm_to_int (prop), LEFT);
-         context ()->unset_property (ly_symbol2scm ("stemLeftBeamCount"));
-       }
+        {
+          Stem::set_beaming (stem_, scm_to_int (prop), LEFT);
+          context ()->unset_property (ly_symbol2scm ("stemLeftBeamCount"));
+        }
       prop = get_property ("stemRightBeamCount");
       if (scm_is_number (prop))
-       {
-         Stem::set_beaming (stem_, scm_to_int (prop), RIGHT);
-         context ()->unset_property (ly_symbol2scm ("stemRightBeamCount"));
-       }
+        {
+          Stem::set_beaming (stem_, scm_to_int (prop), RIGHT);
+          context ()->unset_property (ly_symbol2scm ("stemRightBeamCount"));
+        }
       stem_ = 0;
     }
   tremolo_ev_ = 0;
@@ -168,19 +194,19 @@ Stem_engraver::listen_tremolo (Stream_event *ev)
 ADD_ACKNOWLEDGER (Stem_engraver, rhythmic_head);
 
 ADD_TRANSLATOR (Stem_engraver,
-               /* doc */
-               "Create stems and single-stem tremolos.  It also works"
-               " together with the beam engraver for overriding beaming.",
-
-               /* create */
-               "Stem "
-               "StemTremolo ",
-
-               /* read */
-               "tremoloFlags "
-               "stemLeftBeamCount "
-               "stemRightBeamCount ",
-
-               /* write */
-               ""
-               );
+                /* doc */
+                "Create stems and single-stem tremolos.  It also works"
+                " together with the beam engraver for overriding beaming.",
+
+                /* create */
+                "Stem "
+                "StemTremolo ",
+
+                /* read */
+                "tremoloFlags "
+                "stemLeftBeamCount "
+                "stemRightBeamCount ",
+
+                /* write */
+                ""
+               );