lily/paper-column-engraver.cc

   1 /*
   2   paper-column-engraver.cc -- implement Paper_column_engraver
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 2005--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
   7 */
   8
   9 #include "paper-column-engraver.hh"
  10 #include "axis-group-interface.hh"
  11 #include "context.hh"
  12 #include "item.hh"
  13 #include "note-spacing.hh"
  14 #include "paper-column.hh"
  15 #include "pointer-group-interface.hh"
  16 #include "staff-spacing.hh"
  17 #include "system.hh"
  18 #include "warn.hh"
  19
  20 #include "translator.icc"
  21
  22 Paper_column_engraver::Paper_column_engraver ()
  23 {
  24   last_moment_.main_part_ = Rational (-1,1);
  25   command_column_ = 0;
  26   musical_column_ = 0;
  27   breaks_ = 0;
  28   system_ = 0;
  29   first_ = true;
  30   last_breakable_column_ = 0;
  31   last_breakable_moment_ = Moment (-1);
  32 }
  33
  34 void
  35 Paper_column_engraver::finalize ()
  36 {
  37   if ((breaks_ % 8))
  38     progress_indication ("[" + to_string (breaks_) + "]");
  39
  40   if (command_column_)
  41     {
  42       command_column_->set_property ("line-break-permission", ly_symbol2scm ("allow"));
  43       system_->set_bound (RIGHT, command_column_);
  44     }
  45 }
  46
  47 void
  48 Paper_column_engraver::make_columns ()
  49 {
  50   /*
  51     ugh.
  52   */
  53   Paper_column *p1 = make_paper_column ("NonMusicalPaperColumn");
  54   Paper_column *p2 = make_paper_column ("PaperColumn");
  55   /*
  56      The columns are timestamped with now_mom () in
  57      stop_translation_timestep. Cannot happen now, because the
  58      first column is sometimes created before now_mom is initialised.
  59   */
  60
  61   set_columns (p1, p2);
  62 }
  63
  64 void
  65 Paper_column_engraver::initialize ()
  66 {
  67   system_ = dynamic_cast<System *> (unsmob_grob (get_property ("rootSystem")));
  68   make_columns ();
  69
  70   system_->set_bound (LEFT, command_column_);
  71   command_column_->set_property ("line-break-permission", ly_symbol2scm ("allow"));
  72 }
  73
  74 void
  75 Paper_column_engraver::acknowledge_item (Grob_info gi)
  76 {
  77   items_.push_back (gi.item ());
  78 }
  79
  80 void
  81 Paper_column_engraver::acknowledge_staff_spacing (Grob_info gi)
  82 {
  83   Pointer_group_interface::add_grob (command_column_,
  84                                      ly_symbol2scm ("spacing-wishes"),
  85                                      gi.grob ());
  86 }
  87 void
  88 Paper_column_engraver::acknowledge_note_spacing (Grob_info gi)
  89 {
  90   Pointer_group_interface::add_grob (musical_column_,
  91                                      ly_symbol2scm ("spacing-wishes"),
  92                                      gi.grob ());
  93 }
  94
  95 void
  96 Paper_column_engraver::set_columns (Paper_column *new_command,
  97                                     Paper_column *new_musical)
  98 {
  99   command_column_ = new_command;
 100   musical_column_ = new_musical;
 101   if (new_command)
 102     context ()->set_property ("currentCommandColumn", new_command->self_scm ());
 103
 104   if (new_musical)
 105     context ()->set_property ("currentMusicalColumn", new_musical->self_scm ());
 106
 107   system_->add_column (command_column_);
 108   system_->add_column (musical_column_);
 109 }
 110
 111 IMPLEMENT_TRANSLATOR_LISTENER (Paper_column_engraver, break);
 112 void
 113 Paper_column_engraver::listen_break (Stream_event *ev)
 114 {
 115   break_events_.push_back (ev);
 116 }
 117
 118 void
 119 Paper_column_engraver::process_music ()
 120 {
 121   for (vsize i = 0; i < break_events_.size (); i++)
 122     {
 123       string prefix;
 124       SCM name_sym = break_events_[i]->get_property ("class");
 125       string name = ly_scm2string (scm_symbol_to_string (name_sym));
 126       size_t end = name.rfind ("-event");
 127       if (end)
 128         prefix = name.substr (0, end);
 129       else
 130         {
 131           programming_error ("Paper_column_engraver doesn't know about this break-event");
 132           return;
 133         }
 134
 135       string perm_str = prefix + "-permission";
 136       string pen_str = prefix + "-penalty";
 137
 138       SCM cur_pen = command_column_->get_property (pen_str.c_str ());
 139       SCM pen = break_events_[i]->get_property ("break-penalty");
 140       SCM perm = break_events_[i]->get_property ("break-permission");
 141
 142       if (scm_is_number (pen))
 143         {
 144           Real new_pen = robust_scm2double (cur_pen, 0.0) + scm_to_double (pen);
 145           command_column_->set_property (pen_str.c_str (), scm_from_double (new_pen));
 146           command_column_->set_property (perm_str.c_str (), ly_symbol2scm ("allow"));
 147         }
 148       else
 149         command_column_->set_property (perm_str.c_str (), perm);
 150     }
 151
 152   bool start_of_measure = (last_moment_.main_part_ != now_mom ().main_part_
 153                            && !measure_position (context ()).main_part_);
 154
 155   /*
 156     We can't do this in start_translation_timestep(), since time sig
 157     changes won't have happened by then.
 158   */
 159   if (start_of_measure)
 160     {
 161       Moment mlen = Moment (measure_length (context ()));
 162       Grob *column = unsmob_grob (get_property ("currentCommandColumn"));
 163       if (column)
 164         column->set_property ("measure-length", mlen.smobbed_copy ());
 165       else
 166         programming_error ("No command column?");
 167     }
 168 }
 169
 170 void
 171 Paper_column_engraver::stop_translation_timestep ()
 172 {
 173   SCM m = now_mom ().smobbed_copy ();
 174   command_column_->set_property ("when", m);
 175   musical_column_->set_property ("when", m);
 176
 177   for (vsize i = 0; i < items_.size (); i++)
 178     {
 179       Item *elem = items_[i];
 180       if (!elem->get_parent (X_AXIS)
 181           || !unsmob_grob (elem->get_object ("axis-group-parent-X")))
 182         {
 183           bool br = Item::is_non_musical (elem);
 184           Axis_group_interface::add_element (br ? command_column_ : musical_column_, elem);
 185         }
 186     }
 187   items_.clear ();
 188
 189   if (to_boolean (get_property ("forbidBreak")))
 190     command_column_->set_property ("line-break-permission", SCM_EOL);
 191   else if (Paper_column::is_breakable (command_column_))
 192     {
 193       breaks_++;
 194       last_breakable_column_ = command_column_;
 195       last_breakable_moment_ = now_mom ();
 196       if (! (breaks_%8))
 197         progress_indication ("[" + to_string (breaks_) + "]");
 198     }
 199
 200   SCM page_br = get_property ("allowPageTurn");
 201   if (scm_is_pair (page_br) && last_breakable_moment_ >= Rational (0))
 202     {
 203       SCM pen = scm_cdr (page_br);
 204       Moment *m = unsmob_moment (scm_car (page_br));
 205       if (m && scm_is_number (pen) && *m <= last_breakable_moment_)
 206         {
 207           last_breakable_column_->set_property ("page-turn-permission", ly_symbol2scm ("allow"));
 208           last_breakable_column_->set_property ("page-turn-penalty", pen);
 209         }
 210     }
 211
 212   context ()->get_score_context ()->unset_property (ly_symbol2scm ("forbidBreak"));
 213   context ()->get_score_context ()->unset_property (ly_symbol2scm ("allowPageTurn"));
 214
 215   first_ = false;
 216   break_events_.clear ();
 217 }
 218
 219 void
 220 Paper_column_engraver::start_translation_timestep ()
 221 {
 222   /*
 223     TODO: don't make columns when skipTypesetting is true.
 224   */
 225   if (!first_)
 226     make_columns ();
 227 }
 228
 229 ADD_ACKNOWLEDGER (Paper_column_engraver, item);
 230 ADD_ACKNOWLEDGER (Paper_column_engraver, note_spacing);
 231 ADD_ACKNOWLEDGER (Paper_column_engraver, staff_spacing);
 232
 233 ADD_TRANSLATOR (Paper_column_engraver,
 234                 /* doc */ "Takes care of generating columns."
 235                 "\n\n "
 236                 "This engraver decides whether a column is breakable. The default is "
 237                 "that a column is always breakable. However, every Bar_engraver "
 238                 "that does not have a barline at a certain point will set forbidBreaks "
 239                 "in the score context to stop linebreaks.  In practice, this "
 240                 "means that you can make a breakpoint by creating a barline (assuming "
 241                 "that there are no beams or notes that prevent a breakpoint.) ",
 242
 243                 /* create */
 244                 "PaperColumn "
 245                 "NonMusicalPaperColumn",
 246
 247                 /* accept */ "break-event",
 248                 /* read */
 249                 "forbidBreak "
 250                 "allowPageTurn",
 251                 /* write */
 252                 "forbidBreak "
 253                 "allowPageTurn "
 254                 "currentCommandColumn "
 255                 "currentMusicalColumn");