2 slur-scoring.cc -- Score based slur formatting
4 source file of the GNU LilyPond music typesetter
6 (c) 1996--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
7 Jan Nieuwenhuizen <janneke@gnu.org>
11 #include "slur-scoring.hh"
13 #include "accidental-interface.hh"
15 #include "directional-element-interface.hh"
16 #include "libc-extension.hh"
18 #include "note-column.hh"
19 #include "output-def.hh"
20 #include "paper-column.hh"
22 #include "pointer-group-interface.hh"
23 #include "slur-configuration.hh"
26 #include "staff-symbol-referencer.hh"
27 #include "staff-symbol.hh"
34 - curve around flag for y coordinate
36 - short-cut: try a smaller region first.
38 - handle non-visible stems better.
40 - try to prune number of scoring criteria
42 - take encompass-objects more into account when determining
45 - calculate encompass scoring directly after determining slur shape.
49 struct Slur_score_state;
51 Slur_score_state::Slur_score_state ()
55 edge_has_beams_ = false;
56 has_same_beam_ = false;
64 Slur_score_state::~Slur_score_state ()
66 junk_pointers (configurations_);
70 broken_trend_y (Slur_score_state const &state, Direction hdir)
72 /* A broken slur should maintain the same vertical trend
73 the unbroken slur would have had. */
75 if (Spanner *mother = dynamic_cast<Spanner *> (state.slur_->original ()))
77 Grob *neighbor = mother->broken_neighbor (hdir);
82 Spanner *common_mother
83 = dynamic_cast<Spanner *> (state.common_[Y_AXIS]->original ());
85 = broken_spanner_index (dynamic_cast<Spanner *> (state.common_[Y_AXIS]));
86 int common_j = common_k + hdir;
88 if (common_j < 0 || vsize (common_j) >= common_mother->broken_intos_.size ())
91 Grob *common_next_system = common_mother->broken_intos_[common_j];
93 SCM last_point = scm_car (scm_last_pair (neighbor->get_property ("control-points")));
95 return scm_to_double (scm_cdr (last_point))
96 + neighbor->relative_coordinate (common_next_system, Y_AXIS);
102 copy slur dir forwards across line break.
105 Slur_score_state::set_next_direction ()
107 if (extremes_[RIGHT].note_column_)
110 if (Grob *neighbor = slur_->broken_neighbor (RIGHT))
112 set_grob_direction (neighbor, dir_);
117 Slur_score_state::get_encompass_info (Grob *col) const
119 Grob *stem = unsmob_grob (col->get_object ("stem"));
124 programming_error ("no stem for note column");
125 ei.x_ = col->relative_coordinate (common_[X_AXIS], X_AXIS);
126 ei.head_ = ei.stem_ = col->extent (common_[Y_AXIS],
130 Direction stem_dir = get_grob_direction (stem);
132 if (Grob *head = Note_column::first_head (col))
133 ei.x_ = head->extent (common_[X_AXIS], X_AXIS).center ();
135 ei.x_ = col->extent (common_[X_AXIS], X_AXIS).center ();
137 Grob *h = Stem::extremal_heads (stem)[Direction (dir_)];
140 ei.head_ = ei.stem_ = col->extent (common_[Y_AXIS], Y_AXIS)[dir_];
144 ei.head_ = h->extent (common_[Y_AXIS], Y_AXIS)[dir_];
146 if ((stem_dir == dir_)
147 && !stem->extent (stem, Y_AXIS).is_empty ())
149 ei.stem_ = stem->extent (common_[Y_AXIS], Y_AXIS)[dir_];
150 if (Grob *b = Stem::get_beam (stem))
151 ei.stem_ += stem_dir * 0.5 * Beam::get_thickness (b);
153 Interval x = stem->extent (common_[X_AXIS], X_AXIS);
154 ei.x_ = x.is_empty ()
155 ? stem->relative_coordinate (common_[X_AXIS], X_AXIS)
164 Drul_array<Bound_info>
165 Slur_score_state::get_bound_info () const
167 Drul_array<Bound_info> extremes;
170 Direction dir = dir_;
174 extremes[d].bound_ = slur_->get_bound (d);
175 if (Note_column::has_interface (extremes[d].bound_))
177 extremes[d].note_column_ = extremes[d].bound_;
178 extremes[d].stem_ = Note_column::get_stem (extremes[d].note_column_);
179 if (extremes[d].stem_)
181 extremes[d].stem_dir_ = get_grob_direction (extremes[d].stem_);
183 for (int a = X_AXIS; a < NO_AXES; a++)
186 Interval s = extremes[d].stem_->extent (common_[ax], ax);
190 do not issue warning. This happens for rests and
194 + extremes[d].stem_->relative_coordinate (common_[ax], ax);
196 extremes[d].stem_extent_[ax] = s;
199 extremes[d].slur_head_
200 = Stem::extremal_heads (extremes[d].stem_)[dir];
201 if (!extremes[d].slur_head_
202 && Note_column::has_rests (extremes[d].bound_))
203 extremes[d].slur_head_ = Note_column::get_rest (extremes[d].bound_);
204 extremes[d].staff_ = Staff_symbol_referencer
205 ::get_staff_symbol (extremes[d].stem_);
206 extremes[d].staff_space_ = Staff_symbol_referencer
207 ::staff_space (extremes[d].stem_);
210 if (extremes[d].slur_head_)
211 extremes[d].slur_head_x_extent_
212 = extremes[d].slur_head_->extent (common_[X_AXIS], X_AXIS);
216 while (flip (&d) != LEFT);
222 Slur_score_state::fill (Grob *me)
224 slur_ = dynamic_cast<Spanner *> (me);
226 = internal_extract_grob_array (me, ly_symbol2scm ("note-columns"));
228 if (columns_.empty ())
234 Slur::replace_breakable_encompass_objects (me);
235 staff_space_ = Staff_symbol_referencer::staff_space (me);
236 Real lt = me->layout ()->get_dimension (ly_symbol2scm ("line-thickness"));
237 thickness_ = robust_scm2double (me->get_property ("thickness"), 1.0) * lt;
239 dir_ = get_grob_direction (me);
240 parameters_.fill (me);
242 extract_grob_set (me, "note-columns", columns);
243 extract_grob_set (me, "encompass-objects", extra_objects);
245 Spanner *sp = dynamic_cast<Spanner *> (me);
247 for (int i = X_AXIS; i < NO_AXES; i++)
250 common_[a] = common_refpoint_of_array (columns, me, a);
251 common_[a] = common_refpoint_of_array (extra_objects, common_[a], a);
257 If bound is not in note-columns, we don't want to know about
261 common_[a] = common_[a]->common_refpoint (sp->get_bound (d), a);
263 while (flip (&d) != LEFT);
266 extremes_ = get_bound_info ();
267 is_broken_ = (!extremes_[LEFT].note_column_
268 || !extremes_[RIGHT].note_column_);
271 = (extremes_[LEFT].stem_ && extremes_[RIGHT].stem_
272 && Stem::get_beam (extremes_[LEFT].stem_) == Stem::get_beam (extremes_[RIGHT].stem_));
274 base_attachments_ = get_base_attachments ();
276 Drul_array<Real> end_ys
277 = get_y_attachment_range ();
279 configurations_ = enumerate_attachments (end_ys);
280 for (vsize i = 0; i < columns_.size (); i++)
281 encompass_infos_.push_back (get_encompass_info (columns_[i]));
283 extra_encompass_infos_ = get_extra_encompass_infos ();
291 && extremes_[d].slur_head_)
293 * extremes_[d].slur_head_->relative_coordinate (common_[Y_AXIS], Y_AXIS);
295 while (flip (&d) != LEFT);
298 = (extremes_[LEFT].stem_ && Stem::get_beam (extremes_[LEFT].stem_))
299 || (extremes_[RIGHT].stem_ && Stem::get_beam (extremes_[RIGHT].stem_));
301 set_next_direction ();
308 MAKE_SCHEME_CALLBACK(Slur, calc_control_points, 1)
310 Slur::calc_control_points (SCM smob)
312 Spanner *me = unsmob_spanner (smob);
314 Slur_score_state state;
320 state.generate_curves ();
322 SCM end_ys = me->get_property ("positions");
325 if (is_number_pair (end_ys))
326 best = state.configurations_[state.get_closest_index (end_ys)]->curve_;
328 best = state.get_best_curve ();
330 SCM controls = SCM_EOL;
331 for (int i = 4; i--;)
333 Offset o = best.control_[i]
334 - Offset (me->relative_coordinate (state.common_[X_AXIS], X_AXIS),
335 me->relative_coordinate (state.common_[Y_AXIS], Y_AXIS));
336 controls = scm_cons (ly_offset2scm (o), controls);
343 Slur_score_state::get_best_curve ()
348 #if DEBUG_SLUR_SCORING
349 bool debug_slurs = to_boolean (slur_->layout ()
350 ->lookup_variable (ly_symbol2scm ("debug-slur-scoring")));
351 SCM inspect_quants = slur_->get_property ("inspect-quants");
352 SCM inspect_index = slur_->get_property ("inspect-index");
354 && scm_is_integer (inspect_index))
356 opt_idx = scm_to_int (inspect_index);
357 configurations_[opt_idx]->calculate_score (*this);
358 opt = configurations_[opt_idx]->score ();
361 && scm_is_pair (inspect_quants))
363 opt_idx = get_closest_index (inspect_quants);
364 configurations_[opt_idx]->calculate_score (*this);
365 opt = configurations_[opt_idx]->score ();
370 for (vsize i = 0; i < configurations_.size (); i++)
371 configurations_[i]->calculate_score (*this);
372 for (vsize i = 0; i < configurations_.size (); i++)
374 if (configurations_[i]->score () < opt)
376 opt = configurations_[i]->score ();
382 #if DEBUG_SLUR_SCORING
388 total = configurations_[opt_idx]->card ();
389 total += to_string (" TOTAL=%.2f idx=%d", configurations_[opt_idx]->score (), opt_idx);
396 slur_->set_property ("quant-score",
397 scm_makfrom0str (total.c_str ()));
404 programming_error ("No optimal slur found. Guessing 0.");
407 return configurations_[opt_idx]->curve_;
411 Slur_score_state::breakable_bound_item (Direction d) const
413 Grob *col = slur_->get_bound (d)->get_column ();
415 extract_grob_set (slur_, "encompass-objects", extra_encompasses);
417 for (vsize i = 0; i < extra_encompasses.size (); i++)
419 Item *item = dynamic_cast<Item*> (extra_encompasses[i]);
420 if (item && col == item->get_column ())
428 Slur_score_state::get_closest_index (SCM inspect_quants) const
430 Drul_array<Real> ins = ly_scm2interval (inspect_quants);
434 for (vsize i = 0; i < configurations_.size (); i++)
436 Real d = fabs (configurations_[i]->attachment_[LEFT][Y_AXIS] - ins[LEFT])
437 + fabs (configurations_[i]->attachment_[RIGHT][Y_AXIS] - ins[RIGHT]);
445 programming_error ("can't not find quant");
450 TODO: should analyse encompasses to determine sensible region, and
451 should limit slopes available.
455 Slur_score_state::get_y_attachment_range () const
457 Drul_array<Real> end_ys;
461 if (extremes_[d].note_column_)
464 * max (max (dir_ * (base_attachments_[d][Y_AXIS]
465 + parameters_.region_size_ * dir_),
466 dir_ * (dir_ + extremes_[d].note_column_->extent (common_[Y_AXIS], Y_AXIS)[dir_])),
467 dir_ * base_attachments_[-d][Y_AXIS]);
470 end_ys[d] = base_attachments_[d][Y_AXIS] + parameters_.region_size_ * dir_;
472 while (flip (&d) != LEFT);
478 spanner_less (Spanner *s1, Spanner *s2)
484 b1[d] = s1->get_bound (d)->get_column ()->get_rank ();
485 b2[d] = s2->get_bound (d)->get_column ()->get_rank ();
487 while (flip (&d) != LEFT);
489 return b2[LEFT] <= b1[LEFT] && b2[RIGHT] >= b1[RIGHT]
490 && (b2[LEFT] != b1[LEFT] || b2[RIGHT] != b1[RIGHT]);
494 Slur_score_state::get_base_attachments () const
496 Drul_array<Offset> base_attachment;
500 Grob *stem = extremes_[d].stem_;
501 Grob *head = extremes_[d].slur_head_;
505 if (extremes_[d].note_column_)
509 fixme: X coord should also be set in this case.
512 && !Stem::is_invisible (stem)
513 && extremes_[d].stem_dir_ == dir_
514 && Stem::get_beaming (stem, -d)
515 && Stem::get_beam (stem)
516 && (!spanner_less (slur_, Stem::get_beam (stem))
518 y = extremes_[d].stem_extent_[Y_AXIS][dir_];
520 y = head->extent (common_[Y_AXIS], Y_AXIS)[dir_];
521 y += dir_ * 0.5 * staff_space_;
523 y = move_away_from_staffline (y, head);
525 Grob *fh = Note_column::first_head (extremes_[d].note_column_);
527 = (fh ? fh->extent (common_[X_AXIS], X_AXIS)
528 : extremes_[d].bound_->extent (common_[X_AXIS], X_AXIS))
529 .linear_combination (CENTER);
531 base_attachment[d] = Offset (x, y);
533 while (flip (&d) != LEFT);
537 if (!extremes_[d].note_column_)
542 if (Grob *g = breakable_bound_item (d))
544 x = robust_relative_extent (g, common_[X_AXIS], X_AXIS)[RIGHT];
547 x = robust_relative_extent (extremes_[d].bound_, common_[X_AXIS], X_AXIS)[d];
549 x = slur_->get_broken_left_end_align ();
551 Grob *col = (d == LEFT) ? columns_[0] : columns_.back ();
553 if (extremes_[-d].bound_ != col)
555 y = robust_relative_extent (col, common_[Y_AXIS], Y_AXIS)[dir_];
556 y += dir_ * 0.5 * staff_space_;
558 if (get_grob_direction (col) == dir_
559 && Note_column::get_stem (col)
560 && !Stem::is_invisible (Note_column::get_stem (col)))
561 y -= dir_ * 1.5 * staff_space_;
564 y = base_attachment[-d][Y_AXIS];
566 y = move_away_from_staffline (y, col);
568 base_attachment[d] = Offset (x, y);
571 while (flip (&d) != LEFT);
575 for (int a = X_AXIS; a < NO_AXES; a++)
577 Real &b = base_attachment[d][Axis (a)];
579 if (isinf (b) || isnan (b))
581 programming_error ("slur attachment is inf/nan");
586 while (flip (&d) != LEFT);
588 return base_attachment;
592 Slur_score_state::move_away_from_staffline (Real y,
593 Grob *on_staff) const
598 Grob *staff_symbol = Staff_symbol_referencer::get_staff_symbol (on_staff);
603 = (y - staff_symbol->relative_coordinate (common_[Y_AXIS],
605 * 2.0 / staff_space_;
607 if (fabs (pos - my_round (pos)) < 0.2
608 && Staff_symbol_referencer::on_line (on_staff, (int) rint (pos))
609 && Staff_symbol_referencer::line_count (on_staff) - 1 >= rint (pos))
610 y += 1.5 * staff_space_ * dir_ / 10;
616 Slur_score_state::generate_avoid_offsets () const
618 vector<Offset> avoid;
619 vector<Grob*> encompasses = columns_;
621 for (vsize i = 0; i < encompasses.size (); i++)
623 if (extremes_[LEFT].note_column_ == encompasses[i]
624 || extremes_[RIGHT].note_column_ == encompasses[i])
627 Encompass_info inf (get_encompass_info (encompasses[i]));
628 Real y = dir_ * (max (dir_ * inf.head_, dir_ * inf.stem_));
630 avoid.push_back (Offset (inf.x_, y + dir_ * parameters_.free_head_distance_));
633 extract_grob_set (slur_, "encompass-objects", extra_encompasses);
634 for (vsize i = 0; i < extra_encompasses.size (); i++)
636 if (Slur::has_interface (extra_encompasses[i]))
638 Grob *small_slur = extra_encompasses[i];
639 Bezier b = Slur::get_curve (small_slur);
641 Offset z = b.curve_point (0.5);
642 z += Offset (small_slur->relative_coordinate (common_[X_AXIS], X_AXIS),
643 small_slur->relative_coordinate (common_[Y_AXIS], Y_AXIS));
645 z[Y_AXIS] += dir_ * parameters_.free_slur_distance_;
648 else if (extra_encompasses[i]->get_property ("avoid-slur") == ly_symbol2scm ("inside"))
650 Grob *g = extra_encompasses [i];
651 Interval xe = g->extent (common_[X_AXIS], X_AXIS);
652 Interval ye = g->extent (common_[Y_AXIS], Y_AXIS);
656 avoid.push_back (Offset (xe.center(), ye[dir_]));
663 Slur_score_state::generate_curves () const
665 Real r_0 = robust_scm2double (slur_->get_property ("ratio"), 0.33);
666 Real h_inf = staff_space_ * scm_to_double (slur_->get_property ("height-limit"));
668 vector<Offset> avoid = generate_avoid_offsets ();
669 for (vsize i = 0; i < configurations_.size (); i++)
670 configurations_[i]->generate_curve (*this, r_0, h_inf, avoid);
673 vector<Slur_configuration*>
674 Slur_score_state::enumerate_attachments (Drul_array<Real> end_ys) const
676 vector<Slur_configuration*> scores;
678 Drul_array<Offset> os;
679 os[LEFT] = base_attachments_[LEFT];
680 Real minimum_length = staff_space_
681 * robust_scm2double (slur_->get_property ("minimum-length"), 2.0);
683 for (int i = 0; dir_ * os[LEFT][Y_AXIS] <= dir_ * end_ys[LEFT]; i++)
685 os[RIGHT] = base_attachments_[RIGHT];
686 for (int j = 0; dir_ * os[RIGHT][Y_AXIS] <= dir_ * end_ys[RIGHT]; j++)
688 Slur_configuration s;
690 Drul_array<bool> attach_to_stem (false, false);
693 os[d][X_AXIS] = base_attachments_[d][X_AXIS];
694 if (extremes_[d].stem_
695 && !Stem::is_invisible (extremes_[d].stem_)
696 && extremes_[d].stem_dir_ == dir_)
698 Interval stem_y = extremes_[d].stem_extent_[Y_AXIS];
699 stem_y.widen (0.25 * staff_space_);
700 if (stem_y.contains (os[d][Y_AXIS]))
702 os[d][X_AXIS] = extremes_[d].stem_extent_[X_AXIS][-d]
704 attach_to_stem[d] = true;
706 else if (dir_ * extremes_[d].stem_extent_[Y_AXIS][dir_]
707 < dir_ * os[d][Y_AXIS]
708 && !extremes_[d].stem_extent_[X_AXIS].is_empty ())
710 os[d][X_AXIS] = extremes_[d].stem_extent_[X_AXIS].center ();
713 while (flip (&d) != LEFT);
716 dz = os[RIGHT] - os[LEFT];
717 if (dz[X_AXIS] < minimum_length
718 || fabs (dz[Y_AXIS] / dz[X_AXIS]) > parameters_.max_slope_)
722 if (extremes_[d].slur_head_
723 && !extremes_[d].slur_head_x_extent_.is_empty ())
725 os[d][X_AXIS] = extremes_[d].slur_head_x_extent_.center ();
726 attach_to_stem[d] = false;
729 while (flip (&d) != LEFT);
732 dz = os[RIGHT] - os[LEFT];
735 if (extremes_[d].slur_head_
736 && !attach_to_stem[d])
738 /* Horizontally move tilted slurs a little. Move
739 more for bigger tilts.
743 -= dir_ * extremes_[d].slur_head_x_extent_.length ()
744 * sin (dz.arg ()) / 3;
747 while (flip (&d) != LEFT);
750 s.index_ = scores.size ();
752 scores.push_back (new Slur_configuration (s));
754 os[RIGHT][Y_AXIS] += dir_ * staff_space_ / 2;
757 os[LEFT][Y_AXIS] += dir_ * staff_space_ / 2;
760 assert (scores.size () > 0);
764 vector<Extra_collision_info>
765 Slur_score_state::get_extra_encompass_infos () const
767 extract_grob_set (slur_, "encompass-objects", encompasses);
768 vector<Extra_collision_info> collision_infos;
769 for (vsize i = encompasses.size (); i--;)
771 if (Slur::has_interface (encompasses[i]))
773 Spanner *small_slur = dynamic_cast<Spanner *> (encompasses[i]);
774 Bezier b = Slur::get_curve (small_slur);
776 Offset relative (small_slur->relative_coordinate (common_[X_AXIS], X_AXIS),
777 small_slur->relative_coordinate (common_[Y_AXIS], Y_AXIS));
779 for (int k = 0; k < 3; k++)
781 Direction hdir = Direction (k - 1);
784 Only take bound into account if small slur starts
785 together with big slur.
787 if (hdir && small_slur->get_bound (hdir) != slur_->get_bound (hdir))
790 Offset z = b.curve_point (k / 2.0);
795 yext[dir_] = z[Y_AXIS] + dir_ * thickness_ * 1.0;
797 Interval xext (-1, 1);
798 xext = xext * (thickness_ * 2) + z[X_AXIS];
799 Extra_collision_info info (small_slur,
803 parameters_.extra_object_collision_penalty_);
804 collision_infos.push_back (info);
809 Grob *g = encompasses [i];
810 Interval xe = g->extent (common_[X_AXIS], X_AXIS);
811 Interval ye = g->extent (common_[Y_AXIS], Y_AXIS);
814 Real penalty = parameters_.extra_object_collision_penalty_;
815 if (Accidental_interface::has_interface (g))
817 penalty = parameters_.accidental_collision_;
818 /* Begin copy accidental.cc */
820 if (to_boolean (g->get_property ("cautionary")))
822 SCM cstyle = g->get_property ("cautionary-style");
823 parens = ly_is_equal (cstyle, ly_symbol2scm ("parentheses"));
826 SCM accs = g->get_property ("accidentals");
827 SCM scm_style = g->get_property ("style");
828 if (!scm_is_symbol (scm_style)
830 && scm_ilength (accs) == 1)
832 /* End copy accidental.cc */
833 switch (scm_to_int (scm_car (accs)))
849 ye.widen (thickness_ * 0.5);
850 xe.widen (thickness_ * 1.0);
851 Extra_collision_info info (g, xp, xe, ye, penalty);
852 collision_infos.push_back (info);
856 return collision_infos;
859 Extra_collision_info::Extra_collision_info (Grob *g, Real idx, Interval x, Interval y, Real p)
862 extents_[X_AXIS] = x;
863 extents_[Y_AXIS] = y;
866 type_ = g->get_property ("avoid-slur");
869 Extra_collision_info::Extra_collision_info ()