]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/paper-column-engraver.cc
Doc-fr: NR-1.5.2 merging rests
[lilypond.git] / lily / paper-column-engraver.cc
index 13cc58fedd3045ad1a79d6cdfd7184963fbc7b10..6dd29300130878be798fc0bfb9670035874d02a7 100644 (file)
@@ -1,43 +1,79 @@
 /*
-  paper-column-engraver.cc -- implement Paper_column_engraver
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 2005--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 2005--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 "paper-column-engraver.hh"
-#include "system.hh"
-#include "item.hh"
-#include "paper-column.hh"
-#include "staff-spacing.hh"
+#include "international.hh"
+#include "accidental-placement.hh"
+#include "accidental-interface.hh"
+#include "arpeggio.hh"
+#include "axis-group-interface.hh"
+#include "context.hh"
 #include "note-spacing.hh"
+#include "paper-column.hh"
 #include "pointer-group-interface.hh"
-#include "context.hh"
-#include "axis-group-interface.hh"
+#include "separation-item.hh"
+#include "staff-spacing.hh"
+#include "system.hh"
 #include "warn.hh"
 
 #include "translator.icc"
 
-Paper_column_engraver::Paper_column_engraver ()
+Paper_column_engraver::Paper_column_engraver (Context *c)
+  : Engraver (c)
 {
+  last_moment_.main_part_ = Rational (-1, 1);
   command_column_ = 0;
   musical_column_ = 0;
   breaks_ = 0;
-  break_event_ = 0;
   system_ = 0;
   first_ = true;
+  made_columns_ = false;
 }
 
 void
 Paper_column_engraver::finalize ()
 {
-  if ((breaks_ % 8))
-    progress_indication ("[" + to_string (breaks_) + "]");
+  if (! (breaks_ % 8))
+    progress_indication ("[" + ::to_string (breaks_) + "]");
+
+  if (!made_columns_)
+    {
+      make_columns ();
+      SCM m = now_mom ().smobbed_copy ();
+      command_column_->set_property ("when", m);
+      musical_column_->set_property ("when", m);
+    }
 
   if (command_column_)
     {
-      command_column_->set_property ("breakable", SCM_BOOL_T);
+      // At the end of the score, allow page breaks and turns by default, but...
+      command_column_->set_property ("page-break-permission", ly_symbol2scm ("allow"));
+      command_column_->set_property ("page-turn-permission", ly_symbol2scm ("allow"));
+
+      // ...allow the user to override them.
+      handle_manual_breaks (true);
+
+      // On the other hand, line breaks are always allowed at the end of a score,
+      // even if they try to stop us.
+      if (!scm_is_symbol (command_column_->get_property ("line-break-permission")))
+        command_column_->set_property ("line-break-permission", ly_symbol2scm ("allow"));
+
       system_->set_bound (RIGHT, command_column_);
     }
 }
@@ -50,10 +86,11 @@ Paper_column_engraver::make_columns ()
   */
   Paper_column *p1 = make_paper_column ("NonMusicalPaperColumn");
   Paper_column *p2 = make_paper_column ("PaperColumn");
-
-  SCM m = now_mom ().smobbed_copy ();
-  p1->set_property ("when", m);
-  p2->set_property ("when", m);
+  /*
+     The columns are timestamped with now_mom () in
+     stop_translation_timestep. Cannot happen now, because the
+     first column is sometimes created before now_mom is initialised.
+  */
 
   set_columns (p1, p2);
 }
@@ -61,11 +98,11 @@ Paper_column_engraver::make_columns ()
 void
 Paper_column_engraver::initialize ()
 {
-  system_ = dynamic_cast<System *> (unsmob_grob (get_property ("rootSystem")));
+  system_ = unsmob<System> (get_property ("rootSystem"));
   make_columns ();
 
   system_->set_bound (LEFT, command_column_);
-  command_column_->set_property ("breakable", SCM_BOOL_T);
+  command_column_->set_property ("line-break-permission", ly_symbol2scm ("allow"));
 }
 
 void
@@ -78,20 +115,21 @@ void
 Paper_column_engraver::acknowledge_staff_spacing (Grob_info gi)
 {
   Pointer_group_interface::add_grob (command_column_,
-                                    ly_symbol2scm ("spacing-wishes"),
-                                    gi.grob ());
+                                     ly_symbol2scm ("spacing-wishes"),
+                                     gi.grob ());
 }
+
 void
 Paper_column_engraver::acknowledge_note_spacing (Grob_info gi)
 {
   Pointer_group_interface::add_grob (musical_column_,
-                                    ly_symbol2scm ("spacing-wishes"),
-                                    gi.grob ());
+                                     ly_symbol2scm ("spacing-wishes"),
+                                     gi.grob ());
 }
 
 void
 Paper_column_engraver::set_columns (Paper_column *new_command,
-                                   Paper_column *new_musical)
+                                    Paper_column *new_musical)
 {
   command_column_ = new_command;
   musical_column_ = new_musical;
@@ -106,121 +144,195 @@ Paper_column_engraver::set_columns (Paper_column *new_command,
 }
 
 void
-Paper_column_engraver::forbid_breaks ()
+Paper_column_engraver::listen_break (Stream_event *ev)
 {
-  if (command_column_ && !first_)
-    command_column_->set_property ("breakable", SCM_EOL);
+  break_events_.push_back (ev);
 }
 
-bool
-Paper_column_engraver::try_music (Music *m)
+void
+Paper_column_engraver::listen_label (Stream_event *ev)
 {
-  break_event_ = m;
-
-  return true;
+  label_events_.push_back (ev);
 }
 
 void
-Paper_column_engraver::process_music ()
+Paper_column_engraver::handle_manual_breaks (bool only_do_permissions)
 {
-  if (break_event_)
+  for (vsize i = 0; i < break_events_.size (); i++)
     {
-      SCM pen = command_column_->get_property ("penalty");
-      Real total_penalty = scm_is_number (pen) ? scm_to_double (pen) : 0.0;
-
-      SCM mpen = break_event_->get_property ("penalty");
-      if (scm_is_number (mpen))
-       total_penalty += scm_to_double (mpen);
-
-      command_column_->set_property ("penalty", scm_from_double (total_penalty));
-
-      /* ugh.  arbitrary, hardcoded */
-      if (total_penalty > 10000.0)
-       forbid_breaks ();
+      string prefix;
+      SCM name_sym = scm_car (break_events_[i]->get_property ("class"));
+      string name = ly_symbol2string (name_sym);
+      size_t end = name.rfind ("-event");
+      if (end)
+        prefix = name.substr (0, end);
+      else
+        {
+          programming_error ("Paper_column_engraver doesn't know about this break-event");
+          return;
+        }
+
+      string perm_str = prefix + "-permission";
+      string pen_str = prefix + "-penalty";
+
+      SCM cur_pen = command_column_->get_property (pen_str.c_str ());
+      SCM pen = break_events_[i]->get_property ("break-penalty");
+      SCM perm = break_events_[i]->get_property ("break-permission");
+
+      if (!only_do_permissions && scm_is_number (pen))
+        {
+          Real new_pen = robust_scm2double (cur_pen, 0.0) + scm_to_double (pen);
+          command_column_->set_property (pen_str.c_str (), scm_from_double (new_pen));
+          command_column_->set_property (perm_str.c_str (), ly_symbol2scm ("allow"));
+        }
+      else
+        command_column_->set_property (perm_str.c_str (), perm);
+    }
+}
 
-      SCM page_pen = command_column_->get_property ("page-penalty");
-      Real total_pp = scm_is_number (page_pen) ? scm_to_double (page_pen) : 0.0;
-      SCM mpage_pen = break_event_->get_property ("page-penalty");
-      if (scm_is_number (mpage_pen))
-       total_pp += scm_to_double (mpage_pen);
+void
+Paper_column_engraver::process_music ()
+{
+  handle_manual_breaks (false);
 
-      command_column_->set_property ("page-penalty", scm_from_double (total_pp));
+  for (vsize i = 0; i < label_events_.size (); i++)
+    {
+      SCM label = label_events_[i]->get_property ("page-label");
+      SCM labels = command_column_->get_property ("labels");
+      command_column_->set_property ("labels", scm_cons (label, labels));
     }
 
   bool start_of_measure = (last_moment_.main_part_ != now_mom ().main_part_
-                          && !measure_position (context ()).main_part_);
+                           && !measure_position (context ()).main_part_);
 
   /*
-    We can't do this in start_translation_timestep(), since time sig
+    We can't do this in start_translation_timestep (), since time sig
     changes won't have happened by then.
   */
   if (start_of_measure)
     {
       Moment mlen = Moment (measure_length (context ()));
-      Grob *column = unsmob_grob (get_property ("currentCommandColumn"));
+      Grob *column = unsmob<Grob> (get_property ("currentCommandColumn"));
       if (column)
-       column->set_property ("measure-length", mlen.smobbed_copy ());
+        column->set_property ("measure-length", mlen.smobbed_copy ());
       else
-       programming_error ("No command column?");
+        programming_error ("No command column?");
     }
 }
 
 void
 Paper_column_engraver::stop_translation_timestep ()
 {
+  if (to_boolean (get_property ("skipTypesetting")))
+    return;
+
+  SCM m = now_mom ().smobbed_copy ();
+  command_column_->set_property ("when", m);
+  musical_column_->set_property ("when", m);
+
+  SCM mpos = get_property ("measurePosition");
+  SCM barnum = get_property ("internalBarNumber");
+  if (unsmob<Moment> (mpos)
+      && scm_is_integer (barnum))
+    {
+      SCM where = scm_cons (barnum,
+                            mpos);
+
+      command_column_->set_property ("rhythmic-location", where);
+      musical_column_->set_property ("rhythmic-location", where);
+    }
+
   for (vsize i = 0; i < items_.size (); i++)
     {
       Item *elem = items_[i];
-      if (!elem->get_parent (X_AXIS)
-         || !unsmob_grob (elem->get_object ("axis-group-parent-X")))
-       {
-         bool br = to_boolean (elem->get_property ("breakable"));
-         Axis_group_interface::add_element (br ? command_column_ : musical_column_, elem);
-       }
+      Grob *col = Item::is_non_musical (elem) ? command_column_ : musical_column_;
+
+      if (!elem->get_parent (X_AXIS))
+        elem->set_parent (col, X_AXIS);
+      if (!unsmob<Grob> (elem->get_object ("axis-group-parent-X")))
+        elem->set_object ("axis-group-parent-X", col->self_scm ());
+
+      if (has_interface<Accidental_placement> (elem)
+          || has_interface<Arpeggio> (elem))
+        Separation_item::add_conditional_item (col, elem);
+      else if (!has_interface<Accidental_interface> (elem))
+        Separation_item::add_item (col, elem);
     }
   items_.clear ();
 
-  if (to_boolean (command_column_->get_property ("breakable")))
+  if (to_boolean (get_property ("forbidBreak"))
+      && breaks_) /* don't honour forbidBreak if it occurs on the first moment of a score */
+    {
+      command_column_->set_property ("page-turn-permission", SCM_EOL);
+      command_column_->set_property ("page-break-permission", SCM_EOL);
+      command_column_->set_property ("line-break-permission", SCM_EOL);
+      for (vsize i = 0; i < break_events_.size (); i++)
+        {
+          SCM perm = break_events_[i]->get_property ("break-permission");
+          if (scm_is_eq (perm, ly_symbol2scm ("force"))
+              || scm_is_eq (perm, ly_symbol2scm ("allow")))
+            warning (_ ("forced break was overridden by some other event, "
+                        "should you be using bar checks?"));
+        }
+    }
+  else if (Paper_column::is_breakable (command_column_))
     {
       breaks_++;
-      if (! (breaks_%8))
-       progress_indication ("[" + to_string (breaks_) + "]");
+
+      if (! (breaks_ % 8))
+        progress_indication ("[" + ::to_string (breaks_) + "]");
     }
 
+  context ()->get_score_context ()->unset_property (ly_symbol2scm ("forbidBreak"));
+
   first_ = false;
-  break_event_ = 0;
+  label_events_.clear ();
 }
 
 void
 Paper_column_engraver::start_translation_timestep ()
 {
-  /*
-    TODO: don't make columns when skipTypesetting is true.
-  */
-  if (!first_)
-    make_columns ();
+  break_events_.clear ();
+  if (!first_ && !to_boolean (get_property ("skipTypesetting")))
+    {
+      make_columns ();
+      made_columns_ = true;
+    }
 }
 
-ADD_ACKNOWLEDGER (Paper_column_engraver, item);
-ADD_ACKNOWLEDGER (Paper_column_engraver, note_spacing);
-ADD_ACKNOWLEDGER (Paper_column_engraver, staff_spacing);
+
+void
+Paper_column_engraver::boot ()
+{
+  ADD_LISTENER (Paper_column_engraver, break);
+  ADD_LISTENER (Paper_column_engraver, label);
+  ADD_ACKNOWLEDGER (Paper_column_engraver, item);
+  ADD_ACKNOWLEDGER (Paper_column_engraver, note_spacing);
+  ADD_ACKNOWLEDGER (Paper_column_engraver, staff_spacing);
+}
 
 ADD_TRANSLATOR (Paper_column_engraver,
-               /* doc */ "Takes care of generating columns."
-               "\n\n "
-               "This engraver decides whether a column is breakable. The default is "
-               "that a column is always breakable. However, when every Bar_engraver "
-               "that does not have a barline at a certain point will call "
-               "Score_engraver::forbid_breaks to stop linebreaks.  In practice, this "
-               "means that you can make a breakpoint by creating a barline (assuming "
-               "that there are no beams or notes that prevent a breakpoint.) ",
-               
-               /* create */
-               "PaperColumn "
-               "NonMusicalPaperColumn",
-               
-               /* accept */ "break-event",
-               /* read */ "",
-               /* write */
-               "currentCommandColumn "
-               "currentMusicalColumn");
+                /* doc */
+                "Take care of generating columns.\n"
+                "\n"
+                "This engraver decides whether a column is breakable.  The"
+                " default is that a column is always breakable.  However,"
+                " every @code{Bar_engraver} that does not have a barline at a"
+                " certain point will set @code{forbidBreaks} in the score"
+                " context to stop line breaks.  In practice, this means that"
+                " you can make a break point by creating a bar line (assuming"
+                " that there are no beams or notes that prevent a break"
+                " point).",
+
+                /* create */
+                "PaperColumn "
+                "NonMusicalPaperColumn ",
+
+                /* read */
+                "forbidBreak ",
+
+                /* write */
+                "forbidBreak "
+                "currentCommandColumn "
+                "currentMusicalColumn "
+               );