lily/paper-book.cc

   1 /*
   2   paper-book.cc -- implement Paper_book
   3
   4   source file of the GNU LilyPond music typesetter
   5
   6   (c) 2004--2007 Jan Nieuwenhuizen <janneke@gnu.org>
   7 */
   8
   9 #include "paper-book.hh"
  10
  11 #include "grob.hh"
  12 #include "main.hh"
  13 #include "output-def.hh"
  14 #include "paper-column.hh"
  15 #include "paper-score.hh"
  16 #include "paper-system.hh"
  17 #include "text-interface.hh"
  18 #include "warn.hh"
  19 #include "program-option.hh"
  20 #include "page-marker.hh"
  21
  22 #include "ly-smobs.icc"
  23
  24 Paper_book::Paper_book ()
  25 {
  26   header_ = SCM_EOL;
  27   header_0_ = SCM_EOL;
  28   pages_ = SCM_BOOL_F;
  29   scores_ = SCM_EOL;
  30   performances_ = SCM_EOL;
  31   systems_ = SCM_BOOL_F;
  32
  33   paper_ = 0;
  34   smobify_self ();
  35 }
  36
  37 Paper_book::~Paper_book ()
  38 {
  39 }
  40
  41 IMPLEMENT_DEFAULT_EQUAL_P (Paper_book);
  42 IMPLEMENT_SMOBS (Paper_book);
  43 IMPLEMENT_TYPE_P (Paper_book, "ly:paper-book?");
  44
  45 SCM
  46 Paper_book::mark_smob (SCM smob)
  47 {
  48   Paper_book *b = (Paper_book *) SCM_CELL_WORD_1 (smob);
  49   if (b->paper_)
  50     scm_gc_mark (b->paper_->self_scm ());
  51   scm_gc_mark (b->header_);
  52   scm_gc_mark (b->header_0_);
  53   scm_gc_mark (b->pages_);
  54   scm_gc_mark (b->performances_);
  55   scm_gc_mark (b->scores_);
  56   return b->systems_;
  57 }
  58
  59 int
  60 Paper_book::print_smob (SCM smob, SCM port, scm_print_state*)
  61 {
  62   Paper_book *b = (Paper_book *) SCM_CELL_WORD_1 (smob);
  63   (void)b;
  64   scm_puts ("#<Paper_book>", port);
  65   return 1;
  66 }
  67
  68 SCM
  69 dump_fields ()
  70 {
  71   SCM fields = SCM_EOL;
  72   for (vsize i = dump_header_fieldnames_global.size (); i--;)
  73     fields
  74       = scm_cons (ly_symbol2scm (dump_header_fieldnames_global[i].c_str ()),
  75                   fields);
  76   return fields;
  77 }
  78
  79 void
  80 Paper_book::add_score (SCM s)
  81 {
  82   scores_ = scm_cons (s, scores_);
  83 }
  84
  85 void
  86 Paper_book::add_performance (SCM s)
  87 {
  88   performances_ = scm_cons (s, performances_);
  89 }
  90
  91 void
  92 Paper_book::output (SCM output_channel)
  93 {
  94   if (scm_is_pair (performances_))
  95     {
  96       SCM proc = ly_lily_module_constant ("write-performances-midis");
  97
  98       scm_call_2 (proc, performances (), output_channel);
  99     }
 100
 101   if (scores_ == SCM_EOL)
 102     return;
 103
 104   /* Generate all stencils to trigger font loads.  */
 105   pages ();
 106
 107   SCM scopes = SCM_EOL;
 108   if (ly_is_module (header_))
 109     scopes = scm_cons (header_, scopes);
 110
 111   string mod_nm = "scm framework-" + get_output_backend_name ();
 112
 113   SCM mod = scm_c_resolve_module (mod_nm.c_str ());
 114
 115   if (get_program_option ("print-pages"))
 116     {
 117       SCM func = scm_c_module_lookup (mod, "output-framework");
 118
 119       func = scm_variable_ref (func);
 120       scm_apply_0 (func, scm_list_n (output_channel,
 121                                      self_scm (),
 122                                      scopes,
 123                                      dump_fields (),
 124                                      SCM_UNDEFINED));
 125     }
 126
 127   if (get_program_option ("preview"))
 128     {
 129       SCM func = scm_c_module_lookup (mod, "output-preview-framework");
 130       func = scm_variable_ref (func);
 131       scm_apply_0 (func, scm_list_n (output_channel,
 132                                      self_scm (),
 133                                      scopes,
 134                                      dump_fields (),
 135                                      SCM_UNDEFINED));
 136     }
 137 }
 138
 139 void
 140 Paper_book::classic_output (SCM output)
 141 {
 142   if (scm_is_pair (performances_))
 143     {
 144       SCM proc = ly_lily_module_constant ("write-performances-midis");
 145
 146       scm_call_2 (proc, performances (), output);
 147     }
 148
 149   /* Generate all stencils to trigger font loads.  */
 150   systems ();
 151
 152   SCM scopes = SCM_EOL;
 153   if (ly_is_module (header_))
 154     scopes = scm_cons (header_, scopes);
 155
 156   if (ly_is_module (header_0_))
 157     scopes = scm_cons (header_0_, scopes);
 158
 159   string format = get_output_backend_name ();
 160   string mod_nm = "scm framework-" + format;
 161
 162   SCM mod = scm_c_resolve_module (mod_nm.c_str ());
 163   SCM func = scm_c_module_lookup (mod, "output-classic-framework");
 164
 165   func = scm_variable_ref (func);
 166   scm_apply_0 (func, scm_list_n (output,
 167                                  self_scm (),
 168                                  scopes,
 169                                  dump_fields (),
 170                                  SCM_UNDEFINED));
 171
 172   progress_indication ("\n");
 173 }
 174
 175 /* TODO: resurrect more complex user-tweaks for titling?  */
 176 Stencil
 177 Paper_book::book_title ()
 178 {
 179   SCM title_func = paper_->lookup_variable (ly_symbol2scm ("book-title"));
 180   Stencil title;
 181
 182   SCM scopes = SCM_EOL;
 183   if (ly_is_module (header_))
 184     scopes = scm_cons (header_, scopes);
 185
 186   SCM tit = SCM_EOL;
 187   if (ly_is_procedure (title_func))
 188     tit = scm_call_2 (title_func,
 189                       paper_->self_scm (),
 190                       scopes);
 191
 192   if (unsmob_stencil (tit))
 193     title = *unsmob_stencil (tit);
 194
 195   if (!title.is_empty ())
 196     title.align_to (Y_AXIS, UP);
 197
 198   return title;
 199 }
 200
 201 Stencil
 202 Paper_book::score_title (SCM header)
 203 {
 204   SCM title_func = paper_->lookup_variable (ly_symbol2scm ("score-title"));
 205
 206   Stencil title;
 207
 208   SCM scopes = SCM_EOL;
 209   if (ly_is_module (header_))
 210     scopes = scm_cons (header_, scopes);
 211
 212   if (ly_is_module (header))
 213     scopes = scm_cons (header, scopes);
 214
 215   SCM tit = SCM_EOL;
 216   if (ly_is_procedure (title_func))
 217     tit = scm_call_2 (title_func,
 218                       paper_->self_scm (),
 219                       scopes);
 220
 221   if (unsmob_stencil (tit))
 222     title = *unsmob_stencil (tit);
 223
 224   if (!title.is_empty ())
 225     title.align_to (Y_AXIS, UP);
 226
 227   return title;
 228 }
 229
 230 void
 231 set_page_permission (SCM sys, SCM symbol, SCM permission)
 232 {
 233   if (Paper_score *ps = dynamic_cast<Paper_score*> (unsmob_music_output (sys)))
 234     {
 235       vector<Grob*> cols = ps->get_columns ();
 236       if (cols.size ())
 237         {
 238           Paper_column *col = dynamic_cast<Paper_column*> (cols.back ());
 239           col->set_property (symbol, permission);
 240           col->find_prebroken_piece (LEFT)->set_property (symbol, permission);
 241         }
 242     }
 243   else if (Prob *pb = unsmob_prob (sys))
 244     pb->set_property (symbol, permission);
 245 }
 246
 247 /* read the breakbefore property of a score block and set up the preceding
 248    system-spec to honour it. That is, SYS should be the system spec that
 249    immediately precedes the score (from which HEADER is taken)
 250    in the get_system_specs () list */
 251 void
 252 set_system_penalty (SCM sys, SCM header)
 253 {
 254   if (ly_is_module (header))
 255     {
 256       SCM force = ly_module_lookup (header, ly_symbol2scm ("breakbefore"));
 257       if (SCM_VARIABLEP (force)
 258           && scm_is_bool (SCM_VARIABLE_REF (force)))
 259         {
 260           if (to_boolean (SCM_VARIABLE_REF (force)))
 261             {
 262               set_page_permission (sys, ly_symbol2scm ("page-break-permission"),
 263                                    ly_symbol2scm ("force"));
 264               set_page_permission (sys, ly_symbol2scm ("line-break-permission"),
 265                                    ly_symbol2scm ("force"));
 266             }
 267           else
 268             set_page_permission (sys, ly_symbol2scm ("page-break-permission"), SCM_EOL);
 269         }
 270     }
 271 }
 272
 273 void
 274 set_labels (SCM sys, SCM labels)
 275 {
 276   if (Paper_score *ps = dynamic_cast<Paper_score*> (unsmob_music_output (sys)))
 277     {
 278       vector<Grob*> cols = ps->get_columns ();
 279       if (cols.size ())
 280         {
 281           Paper_column *col = dynamic_cast<Paper_column*> (cols[0]);
 282           col->set_property ("labels",
 283                              scm_append_x (scm_list_2 (col->get_property ("labels"),
 284                                                        labels)));
 285           Paper_column *col_right = dynamic_cast<Paper_column*> (col->find_prebroken_piece (RIGHT));
 286           col_right->set_property ("labels",
 287                                    scm_append_x (scm_list_2 (col_right->get_property ("labels"),
 288                                                              labels)));
 289         }
 290     }
 291   else if (Prob *pb = unsmob_prob (sys))
 292     pb->set_property ("labels",
 293                       scm_append_x (scm_list_2 (pb->get_property ("labels"),
 294                                                 labels)));
 295 }
 296
 297 SCM
 298 Paper_book::get_score_title (SCM header)
 299 {
 300   Stencil title = score_title (header);
 301   if (title.is_empty ())
 302     title = score_title (header_);
 303   if (!title.is_empty ())
 304     {
 305       /*
 306         TODO: this should come from the \layout {} block, which should
 307         override settings from \paper {}
 308       */
 309       SCM props = paper_->lookup_variable (ly_symbol2scm ("score-title-properties"));
 310       Prob *ps = make_paper_system (props);
 311       paper_system_set_stencil (ps, title);
 312
 313       return ps->self_scm ();
 314     }
 315
 316   return SCM_BOOL_F;
 317 }
 318
 319
 320 SCM
 321 Paper_book::get_system_specs ()
 322 {
 323   SCM system_specs = SCM_EOL;
 324
 325   Stencil title = book_title ();
 326   if (!title.is_empty ())
 327     {
 328       SCM props = paper_->lookup_variable (ly_symbol2scm ("book-title-properties"));
 329       Prob *ps = make_paper_system (props);
 330       paper_system_set_stencil (ps, title);
 331
 332       system_specs = scm_cons (ps->self_scm (), system_specs);
 333       ps->unprotect ();
 334     }
 335
 336   SCM page_properties
 337     = scm_call_1 (ly_lily_module_constant ("layout-extract-page-properties"),
 338                   paper_->self_scm ());
 339
 340   SCM interpret_markup_list = ly_lily_module_constant ("interpret-markup-list");
 341   SCM header = SCM_EOL;
 342   SCM labels = SCM_EOL;
 343   for (SCM s = scm_reverse (scores_); scm_is_pair (s); s = scm_cdr (s))
 344     {
 345       if (ly_is_module (scm_car (s)))
 346         {
 347           header = scm_car (s);
 348           if (header_0_ == SCM_EOL)
 349             header_0_ = header;
 350         }
 351       else if (Page_marker *page_marker = unsmob_page_marker (scm_car (s)))
 352         {
 353           /* page markers are used to set page breaking/turning permission,
 354              or to place bookmarking labels */
 355           if (scm_is_symbol (page_marker->permission_symbol ()))
 356             {
 357               /* set previous element page break or turn permission */
 358               if (scm_is_pair (system_specs))
 359                 set_page_permission (scm_car (system_specs),
 360                                      page_marker->permission_symbol (),
 361                                      page_marker->permission_value ());
 362             }
 363           if (scm_is_symbol (page_marker->label ()))
 364             {
 365               /* The next element label is to be set */
 366               labels = scm_cons (page_marker->label (), labels);
 367             }
 368         }
 369       else if (Music_output *mop = unsmob_music_output (scm_car (s)))
 370         {
 371           if (Paper_score *pscore = dynamic_cast<Paper_score *> (mop))
 372             {
 373               SCM title = get_score_title (header);
 374
 375               if (scm_is_pair (system_specs))
 376                 set_system_penalty (scm_car (system_specs), header);
 377
 378               if (unsmob_prob (title))
 379                 {
 380                   system_specs = scm_cons (title, system_specs);
 381                   unsmob_prob (title)->unprotect ();
 382                 }
 383
 384               header = SCM_EOL;
 385               system_specs = scm_cons (pscore->self_scm (), system_specs);
 386               if (scm_is_pair (labels))
 387                 {
 388                   set_labels (scm_car (system_specs), labels);
 389                   labels = SCM_EOL;
 390                 }
 391             }
 392           else
 393             {
 394               /*
 395                 Ignore MIDI
 396               */
 397             }
 398         }
 399       else if (Text_interface::is_markup_list (scm_car (s)))
 400         {
 401           SCM texts = scm_call_3 (interpret_markup_list,
 402                                   paper_->self_scm (),
 403                                   page_properties,
 404                                   scm_car (s));
 405           for (SCM list = texts ; scm_is_pair (list) ; list = scm_cdr (list))
 406             {
 407               SCM t = scm_car (list);
 408               // TODO: init props
 409               Prob *ps = make_paper_system (SCM_EOL);
 410               ps->set_property ("page-break-permission", ly_symbol2scm ("allow"));
 411               ps->set_property ("page-turn-permission", ly_symbol2scm ("allow"));
 412
 413               paper_system_set_stencil (ps, *unsmob_stencil (t));
 414               ps->set_property ("is-title", SCM_BOOL_T);
 415               if (scm_is_pair (scm_cdr (list)))
 416                 {
 417                   /* If an other markup is following, set this markup
 418                    * next padding and next space to 0, so that baseline-skip
 419                    * only should be taken into account for lines vertical
 420                    * spacing. */
 421                   ps->set_property ("next-padding", scm_double2num (0.0));
 422                   ps->set_property ("next-space", scm_double2num (0.0));
 423                 }
 424               system_specs = scm_cons (ps->self_scm (), system_specs);
 425               ps->unprotect ();
 426
 427               if (scm_is_pair (labels))
 428                 {
 429                   set_labels (scm_car (system_specs), labels);
 430                   labels = SCM_EOL;
 431                 }
 432               // FIXME: figure out penalty.
 433               //set_system_penalty (ps, scores_[i].header_);
 434             }
 435         }
 436       else
 437         assert (0);
 438     }
 439
 440   system_specs = scm_reverse_x (system_specs, SCM_EOL);
 441   return system_specs;
 442 }
 443
 444 SCM
 445 Paper_book::systems ()
 446 {
 447   if (systems_ != SCM_BOOL_F)
 448     return systems_;
 449
 450   systems_ = SCM_EOL;
 451   SCM specs = get_system_specs ();
 452   for (SCM s = specs; scm_is_pair (s); s = scm_cdr (s))
 453     {
 454       if (Paper_score *pscore = dynamic_cast<Paper_score*> (unsmob_music_output (scm_car (s))))
 455         {
 456           SCM system_list = scm_vector_to_list (pscore->get_paper_systems ());
 457           system_list = scm_reverse (system_list);
 458           systems_ = scm_append (scm_list_2 (system_list, systems_));
 459         }
 460       else
 461         {
 462           systems_ = scm_cons (scm_car (s), systems_);
 463         }
 464     }
 465
 466   systems_ = scm_reverse (systems_);
 467
 468   /* backwards compatibility for the old page breaker */
 469   int i = 0;
 470   Prob *last = 0;
 471   for (SCM s = systems_; scm_is_pair (s); s = scm_cdr (s))
 472     {
 473       Prob *ps = unsmob_prob (scm_car (s));
 474       ps->set_property ("number", scm_from_int (++i));
 475
 476       if (last
 477           && to_boolean (last->get_property ("is-title"))
 478           && !scm_is_number (ps->get_property ("penalty")))
 479         ps->set_property ("penalty", scm_from_int (10000));
 480       last = ps;
 481
 482       if (scm_is_pair (scm_cdr (s)))
 483         {
 484           SCM perm = ps->get_property ("page-break-permission");
 485           Prob *next = unsmob_prob (scm_cadr (s));
 486           if (perm == SCM_EOL)
 487             next->set_property ("penalty", scm_from_int (10001));
 488           else if (perm == ly_symbol2scm ("force"))
 489             next->set_property ("penalty", scm_from_int (-10001));
 490         }
 491     }
 492
 493   return systems_;
 494 }
 495
 496 SCM
 497 Paper_book::pages ()
 498 {
 499   if (SCM_BOOL_F != pages_)
 500     return pages_;
 501
 502   pages_ = SCM_EOL;
 503   SCM proc = paper_->c_variable ("page-breaking-wrapper");
 504   pages_ = scm_apply_0 (proc, scm_list_1 (self_scm ()));
 505
 506   /* set systems_ from the pages */
 507   if (systems_ == SCM_BOOL_F)
 508     {
 509       systems_ = SCM_EOL;
 510       for (SCM p = pages_; scm_is_pair (p); p = scm_cdr (p))
 511         {
 512           Prob *page = unsmob_prob (scm_car (p));
 513           SCM systems = page->get_property ("lines");
 514
 515           systems_ = scm_append (scm_list_2 (systems_, systems));
 516         }
 517     }
 518
 519   return pages_;
 520 }
 521
 522 SCM
 523 Paper_book::performances () const
 524 {
 525   return scm_reverse (performances_);
 526 }