]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/slur-configuration.cc
Run grand-replace (issue 3765)
[lilypond.git] / lily / slur-configuration.cc
index b1ce277351e250ce155b6607450432744256bdb4..a5d783703cbebdd43f7fd40aa6067680728c70f8 100644 (file)
@@ -1,14 +1,24 @@
 /*
-  slur-configuration.cc -- implement Slur_configuration
+  This file is part of LilyPond, the GNU music typesetter.
 
-  source file of the GNU LilyPond music typesetter
+  Copyright (C) 2004--2014 Han-Wen Nienhuys <hanwen@xs4all.nl>
 
-  (c) 2004--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 "slur-configuration.hh"
 
-
 #include "item.hh"
 #include "libc-extension.hh"
 #include "misc.hh"
 #include "spanner.hh"
 #include "staff-symbol-referencer.hh"
 #include "stem.hh"
+#include "tie.hh"
 #include "warn.hh"
 
 Bezier
 avoid_staff_line (Slur_score_state const &state,
-                 Bezier bez)
+                  Bezier bez)
 {
   Offset horiz (1, 0);
   vector<Real> ts = bez.solve_derivative (horiz);
@@ -32,39 +43,49 @@ avoid_staff_line (Slur_score_state const &state,
       && (state.extremes_[LEFT].staff_ == state.extremes_[RIGHT].staff_)
       && state.extremes_[LEFT].staff_ && state.extremes_[RIGHT].staff_)
     {
-      Real y = bez.curve_point (ts[0])[Y_AXIS];
+      Real t = ts[0]; //the first (usually only) point where slur is horizontal
+      Real y = bez.curve_point (t)[Y_AXIS];
+      // A Bezier curve at t moves 3t-3t² as far as the middle control points
+      Real factor = 3.0 * t * (1.0 - t);
 
       Grob *staff = state.extremes_[LEFT].staff_;
 
       Real p = 2 * (y - staff->relative_coordinate (state.common_[Y_AXIS], Y_AXIS))
-       / state.staff_space_;
-
-      Real distance = fabs (my_round (p) - p); //  in halfspaces
-      if (distance < 4 * state.thickness_
-         && (int) fabs (my_round (p))
-         <= 2 * Staff_symbol_referencer::staff_radius (staff) + 0.1
-         && (int (fabs (my_round (p))) % 2
-             != Staff_symbol_referencer::line_count (staff) % 2))
-       {
-         Direction resolution_dir
-           = (distance ? state.dir_ : Direction (sign (p - my_round (p))));
-
-         // TODO: parameter
-         Real newp = my_round (p) + resolution_dir
-           * 5 * state.thickness_;
-
-         Real dy = (newp - p) * state.staff_space_ / 2.0;
-
-         bez.control_[1][Y_AXIS] += dy;
-         bez.control_[2][Y_AXIS] += dy;
-       }
+               / state.staff_space_;
+
+      int round_p = (int) my_round (p);
+      if (!Staff_symbol_referencer::on_staff_line (staff, round_p))
+        round_p += (p > round_p) ? 1 : -1;
+      if (!Staff_symbol_referencer::on_staff_line (staff, round_p))
+        return bez;
+
+      Real const distance = (p - round_p) * state.staff_space_ / 2.0;
+      // Allow half the thickness of the slur at the point t, plus one basic
+      // blot-diameter (half for the slur outline, half for the staff line)
+      Real const min_distance = 0.5 * state.thickness_ * factor
+        + state.line_thickness_
+        + ((state.dir_ * distance > 0.0)
+           ? state.parameters_.gap_to_staffline_inside_
+           : state.parameters_.gap_to_staffline_outside_);
+      if (fabs (distance) < min_distance)
+        {
+          Direction resolution_dir = (distance > 0.0) ? UP : DOWN;
+
+          Real dy = resolution_dir * (min_distance - fabs (distance));
+
+          // Shape the curve, moving the horizontal point by factor * dy
+          bez.control_[1][Y_AXIS] += dy;
+          bez.control_[2][Y_AXIS] += dy;
+          // Move the entire curve by the remaining amount
+          bez.translate (Offset (0.0, dy - factor * dy));
+        }
     }
   return bez;
 }
 
 Real
-fit_factor (Offset dz_unit, Offset dz_perp,
-           Bezier curve, Direction d, vector<Offset> const &avoid)
+fit_factor (Offset dz_unit, Offset dz_perp, Real close_to_edge_length,
+            Bezier curve, Direction d, vector<Offset> const &avoid)
 {
   Real fit_factor = 0.0;
   Offset x0 = curve.control_[0];
@@ -80,27 +101,35 @@ fit_factor (Offset dz_unit, Offset dz_perp,
     {
       Offset z = (avoid[i] - x0);
       Offset p (dot_product (z, dz_unit),
-               d * dot_product (z, dz_perp));
+                d * dot_product (z, dz_perp));
+
+      bool close_to_edge = false;
+      for (LEFT_and_RIGHT (d))
+        close_to_edge = close_to_edge || -d * (p[X_AXIS] - curve_xext[d]) < close_to_edge_length;
+
+      if (close_to_edge)
+        continue;
 
       Real eps = 0.01;
-      Interval pext = eps * Interval (-1,1) + p[X_AXIS];
+      Interval pext = eps * Interval (-1, 1) + p[X_AXIS];
       pext.intersect (curve_xext);
+
       if (pext.is_empty () || pext.length () <= 1.999 * eps)
-       continue;
+        continue;
 
       Real y = curve.get_other_coordinate (X_AXIS, p[X_AXIS]);
       if (y)
-       fit_factor = max (fit_factor, (p[Y_AXIS] / y));
+        fit_factor = max (fit_factor, (p[Y_AXIS] / y));
     }
   return fit_factor;
 }
 
 void
 Slur_configuration::generate_curve (Slur_score_state const &state,
-                                   Real r_0, Real h_inf,
-                                   vector<Offset> const &avoid)
+                                    Real r_0, Real h_inf,
+                                    vector<Offset> const &avoid)
 {
-  Offset dz = attachment_[RIGHT]- attachment_[LEFT];;
+  Offset dz = attachment_[RIGHT] - attachment_[LEFT];;
   Offset dz_unit = dz;
   dz_unit *= 1 / dz.length ();
   Offset dz_perp = dz_unit * Offset (0, 1);
@@ -144,20 +173,21 @@ Slur_configuration::generate_curve (Slur_score_state const &state,
   Bezier curve;
   curve.control_[0] = attachment_[LEFT];
   curve.control_[1] = attachment_[LEFT] + dz_perp * height * state.dir_
-    + dz_unit * x1;
+                      + dz_unit * x1;
   curve.control_[2] = attachment_[RIGHT] + dz_perp * height * state.dir_
-    + dz_unit * x2;
+                      + dz_unit * x2;
   curve.control_[3] = attachment_[RIGHT];
 
-  Real ff = fit_factor (dz_unit, dz_perp, curve, state.dir_, avoid);
+  Real ff = fit_factor (dz_unit, dz_perp, state.parameters_.close_to_edge_length_,
+                        curve, state.dir_, avoid);
 
   height = max (height, min (height * ff, max_h));
 
   curve.control_[0] = attachment_[LEFT];
   curve.control_[1] = attachment_[LEFT] + dz_perp * height * state.dir_
-    + dz_unit * x1;
+                      + dz_unit * x1;
   curve.control_[2] = attachment_[RIGHT] + dz_perp * height * state.dir_
-    + dz_unit * x2;
+                      + dz_unit * x2;
   curve.control_[3] = attachment_[RIGHT];
 
   curve_ = avoid_staff_line (state, curve);
@@ -166,25 +196,23 @@ Slur_configuration::generate_curve (Slur_score_state const &state,
 
 Slur_configuration::Slur_configuration ()
 {
-  tags_ = 0x0;
   score_ = 0.0;
   index_ = -1;
 };
 
-
 void
-Slur_configuration::add_score (Real s, string desc)
+Slur_configuration::add_score (Real s, const string &desc)
 {
   if (s < 0)
     {
-      programming_error ("Negative demerits found for slur. Ignoring");
+      programming_error ("Negative demerits found for slur.  Ignoring");
       s = 0.0;
     }
-  
+
   if (s)
     {
       if (score_card_.length () > 0)
-       score_card_ += ", ";
+        score_card_ += ", ";
       score_card_ += to_string ("%s=%.2f", desc.c_str (), s);
       score_ += s;
     }
@@ -210,100 +238,88 @@ Slur_configuration::score_encompass (Slur_score_state const &state)
       bool edge = l_edge || r_edge;
 
       if (! (x < attachment_[RIGHT][X_AXIS]
-            && x > attachment_[LEFT][X_AXIS]))
-       continue;
+             && x > attachment_[LEFT][X_AXIS]))
+        continue;
 
       Real y = bez.get_other_coordinate (X_AXIS, x);
       if (!edge)
-       {
-         Real head_dy = (y - state.encompass_infos_[j].head_);
-         if (state.dir_ * head_dy < 0)
-           {
-             demerit += state.parameters_.head_encompass_penalty_;
-             convex_head_distances.push_back (0.0);
-           }
-         else
-           {
-             Real hd = (head_dy)
-               ? (1 / fabs (head_dy) - 1 / state.parameters_.free_head_distance_)
-               : state.parameters_.head_encompass_penalty_;
-             hd = min (max (hd, 0.0), state.parameters_.head_encompass_penalty_);
-
-             demerit += hd;
-           }
-
-         Real line_y = linear_interpolate (x,
-                                           attachment_[RIGHT][X_AXIS],
-                                           attachment_[LEFT][X_AXIS],
-                                           attachment_[RIGHT][Y_AXIS],
-                                           attachment_[LEFT][Y_AXIS]);
-
-         if (1) // state.dir_ * state.encompass_infos_[j].get_point (state.dir_) > state.dir_ *line_y )
-           {
-
-             Real closest
-               = state.dir_ * max (state.dir_ * state.encompass_infos_[j].get_point (state.dir_), state.dir_ * line_y);
-             Real d = fabs (closest - y);
-
-             convex_head_distances.push_back (d);
-           }
-       }
+        {
+          Real head_dy = (y - state.encompass_infos_[j].head_);
+          if (state.dir_ * head_dy < 0)
+            {
+              demerit += state.parameters_.head_encompass_penalty_;
+              convex_head_distances.push_back (0.0);
+            }
+          else
+            {
+              Real hd = (head_dy)
+                        ? (1 / fabs (head_dy) - 1 / state.parameters_.free_head_distance_)
+                        : state.parameters_.head_encompass_penalty_;
+              hd = min (max (hd, 0.0), state.parameters_.head_encompass_penalty_);
+
+              demerit += hd;
+            }
+
+          Real line_y = linear_interpolate (x,
+                                            attachment_[RIGHT][X_AXIS],
+                                            attachment_[LEFT][X_AXIS],
+                                            attachment_[RIGHT][Y_AXIS],
+                                            attachment_[LEFT][Y_AXIS]);
+
+          if (1) // state.dir_ * state.encompass_infos_[j].get_point (state.dir_) > state.dir_ *line_y )
+            {
+
+              Real closest
+                = state.dir_ * max (state.dir_ * state.encompass_infos_[j].get_point (state.dir_), state.dir_ * line_y);
+              Real d = fabs (closest - y);
+
+              convex_head_distances.push_back (d);
+            }
+        }
 
       if (state.dir_ * (y - state.encompass_infos_[j].stem_) < 0)
-       {
-         Real stem_dem = state.parameters_.stem_encompass_penalty_;
-         if ((l_edge && state.dir_ == UP)
-             || (r_edge && state.dir_ == DOWN))
-           stem_dem /= 5;
-
-         demerit += stem_dem;
-       }
-      else if (!edge)
-       {
-         Interval ext;
-         ext.add_point (state.encompass_infos_[j].stem_);
-         ext.add_point (state.encompass_infos_[j].head_);
-
-         // ?
-         demerit += -state.parameters_.closeness_factor_
-           * min (state.dir_
-                  * (y - (ext[state.dir_] + state.dir_ * state.parameters_.free_head_distance_)), 0.0)
-           / state.encompass_infos_.size ();
-       }
+        {
+          Real stem_dem = state.parameters_.stem_encompass_penalty_;
+          if ((l_edge && state.dir_ == UP)
+              || (r_edge && state.dir_ == DOWN))
+            stem_dem /= 5;
+
+          demerit += stem_dem;
+        }
     }
   add_score (demerit, "encompass");
-  
-  if (convex_head_distances.size ())
+
+  if (vsize n = convex_head_distances.size ())
     {
       Real avg_distance = 0.0;
       Real min_dist = infinity_f;
-      for (vsize j = 0; j < convex_head_distances.size (); j++)
-       {
-         min_dist = min (min_dist, convex_head_distances[j]);
-         avg_distance += convex_head_distances[j];
-       }
+
+      for (vsize j = 0; j < n; j++)
+        {
+          min_dist = min (min_dist, convex_head_distances[j]);
+          avg_distance += convex_head_distances[j];
+        }
 
       /*
-       For slurs over 3 or 4 heads, the average distance is not a
-       good normalizer.
+        For slurs over 3 or 4 heads, the average distance is not a
+        good normalizer.
       */
-      Real n = convex_head_distances.size ();
       if (n <= 2)
-       {
-         Real fact = 1.0;
-         avg_distance += height_ * fact;
-         n += fact;
-       }
+        {
+          Real fact = 1.0;
+          avg_distance += height_ * fact;
+          ++n;
+        }
 
       /*
-       TODO: maybe it's better to use (avgdist - mindist)*factor
-       as penalty.
+        TODO: maybe it's better to use (avgdist - mindist)*factor
+        as penalty.
       */
       avg_distance /= n;
       Real variance_penalty = state.parameters_.head_slur_distance_max_ratio_;
       if (min_dist > 0.0)
-       variance_penalty
-         = min ((avg_distance / (min_dist + state.parameters_.absolute_closeness_measure_) - 1.0), variance_penalty);
+        variance_penalty
+          = min ((avg_distance / (min_dist + state.parameters_.absolute_closeness_measure_) - 1.0), variance_penalty);
 
       variance_penalty = max (variance_penalty, 0.0);
       variance_penalty *= state.parameters_.head_slur_distance_factor_;
@@ -315,73 +331,105 @@ Slur_configuration::score_encompass (Slur_score_state const &state)
 void
 Slur_configuration::score_extra_encompass (Slur_score_state const &state)
 {
+  // we find forbidden attachments
+  vector<Offset> forbidden_attachments;
+  for (vsize i = 0; i < state.extra_encompass_infos_.size (); i++)
+    if (Tie::has_interface (state.extra_encompass_infos_[i].grob_))
+      {
+        Grob *t = state.extra_encompass_infos_[i].grob_;
+        Grob *common_x = Grob::get_vertical_axis_group (t);
+        Real rp = t->relative_coordinate (common_x, X_AXIS);
+        SCM cp = t->get_property ("control-points");
+
+        Bezier b;
+        int j = 0;
+        for (SCM s = cp; scm_is_pair (s); s = scm_cdr (s))
+          {
+            b.control_[j] = ly_scm2offset (scm_car (s));
+            j++;
+          }
+        forbidden_attachments.push_back (Offset (b.control_[0]) + Offset (rp, 0));
+        forbidden_attachments.push_back (Offset (b.control_[3]) + Offset (rp, 0));
+      }
+
+  bool too_close = false;
+  for (vsize k = 0; k < forbidden_attachments.size (); k++)
+    for (LEFT_and_RIGHT (side))
+      if ((forbidden_attachments[k] - attachment_[side]).length () < state.parameters_.slur_tie_extrema_min_distance_)
+        {
+          too_close = true;
+          break;
+        }
+
+  if (too_close)
+    add_score (state.parameters_.slur_tie_extrema_min_distance_penalty_, "extra");
+
   for (vsize j = 0; j < state.extra_encompass_infos_.size (); j++)
     {
       Drul_array<Offset> attachment = attachment_;
       Extra_collision_info const &info (state.extra_encompass_infos_[j]);
-      
+
       Interval slur_wid (attachment[LEFT][X_AXIS], attachment[RIGHT][X_AXIS]);
 
       /*
-       to prevent numerical inaccuracies in
-       Bezier::get_other_coordinate ().
+        to prevent numerical inaccuracies in
+        Bezier::get_other_coordinate ().
       */
-      Direction d = LEFT;
+
       bool found = false;
       Real y = 0.0;
 
-      do
-       {
-         /*
-           We need to check for the bound explicitly, since the
-           slur-ending can be almost vertical, making the Y
-           coordinate a bad approximation of the object-slur
-           distance.
-         */
-         Item *as_item = dynamic_cast<Item *> (state.extra_encompass_infos_[j].grob_);
-         if (!as_item)
-           continue;
-         
-         Interval item_x = as_item->extent (state.common_[X_AXIS], X_AXIS);
-         item_x.intersect (state.extremes_[d].slur_head_x_extent_);
-         if (!item_x.is_empty ())
-           {
-             y = attachment[d][Y_AXIS];
-             found = true;
-           }
-             
-       }
-      while (flip (&d) != LEFT);
+      for (LEFT_and_RIGHT (d))
+        {
+          /*
+            We need to check for the bound explicitly, since the
+            slur-ending can be almost vertical, making the Y
+            coordinate a bad approximation of the object-slur
+            distance.
+          */
+          Item *as_item = dynamic_cast<Item *> (state.extra_encompass_infos_[j].grob_);
+          if (!as_item)
+            continue;
+
+          Interval item_x = as_item->extent (state.common_[X_AXIS], X_AXIS);
+          item_x.intersect (state.extremes_[d].slur_head_x_extent_);
+          if (!item_x.is_empty ())
+            {
+              y = attachment[d][Y_AXIS];
+              found = true;
+            }
+
+        }
 
       if (!found)
-       {
-         Real x = info.extents_[X_AXIS].linear_combination (info.idx_);
+        {
+          Real x = info.extents_[X_AXIS].linear_combination (info.idx_);
 
-         if (!slur_wid.contains (x))
-           continue;
+          if (!slur_wid.contains (x))
+            continue;
 
-         y = curve_.get_other_coordinate (X_AXIS, x);
-       }
+          y = curve_.get_other_coordinate (X_AXIS, x);
+        }
 
       Real dist = 0.0;
       if (info.type_ == ly_symbol2scm ("around"))
-       dist = info.extents_[Y_AXIS].distance (y);
+        dist = info.extents_[Y_AXIS].distance (y);
 
       /*
-       Have to score too: the curve enumeration is limited in its
-       shape, and may produce curves which collide anyway.
+        Have to score too: the curve enumeration is limited in its
+        shape, and may produce curves which collide anyway.
        */
       else if (info.type_ == ly_symbol2scm ("inside"))
-       dist = state.dir_ * (y - info.extents_[Y_AXIS][state.dir_]);
+        dist = state.dir_ * (y - info.extents_[Y_AXIS][state.dir_]);
       else
-       programming_error ("unknown avoidance type");
+        programming_error ("unknown avoidance type");
 
       dist = max (dist, 0.0);
-      
+
       Real penalty = info.penalty_ * peak_around (0.1 * state.parameters_.extra_encompass_free_distance_,
-                                                 state.parameters_.extra_encompass_free_distance_,
-                                                 dist);
-      
+                                                  state.parameters_.extra_encompass_free_distance_,
+                                                  dist);
+
       add_score (penalty, "extra");
     }
 }
@@ -389,11 +437,11 @@ Slur_configuration::score_extra_encompass (Slur_score_state const &state)
 void
 Slur_configuration::score_edges (Slur_score_state const &state)
 {
-  Direction d = LEFT;
+
   Offset dz = attachment_[RIGHT]
-    - attachment_[LEFT];
+              - attachment_[LEFT];
   Real slope = dz[Y_AXIS] / dz[X_AXIS];
-  do
+  for (LEFT_and_RIGHT (d))
     {
       Real y = attachment_[d][Y_AXIS];
       Real dy = fabs (y - state.base_attachments_[d][Y_AXIS]);
@@ -401,22 +449,21 @@ Slur_configuration::score_edges (Slur_score_state const &state)
       Real factor = state.parameters_.edge_attraction_factor_;
       Real demerit = factor * dy;
       if (state.extremes_[d].stem_
-         && state.extremes_[d].stem_dir_ == state.dir_
-         && !Stem::get_beaming (state.extremes_[d].stem_, -d))
-       demerit /= 5;
+          && state.extremes_[d].stem_dir_ == state.dir_
+          // TODO - Stem::get_beaming() should be precomputed.
+          && !Stem::get_beaming (state.extremes_[d].stem_, -d))
+        demerit /= 5;
 
       demerit *= exp (state.dir_ * d * slope
-                     * state.parameters_.edge_slope_exponent_);
-
+                      * state.parameters_.edge_slope_exponent_);
 
       string dir_str = d == LEFT ? "L" : "R";
       add_score (demerit, dir_str + " edge");
     }
-  while (flip (&d) != LEFT);
 }
 
 void
-Slur_configuration ::score_slopes (Slur_score_state const &state)
+Slur_configuration::score_slopes (Slur_score_state const &state)
 {
   Real dy = state.musical_dy_;
   Offset slur_dz = attachment_[RIGHT] - attachment_[LEFT];
@@ -424,8 +471,8 @@ Slur_configuration ::score_slopes (Slur_score_state const &state)
   Real demerit = 0.0;
 
   demerit += max ((fabs (slur_dy / slur_dz[X_AXIS])
-                  - state.parameters_.max_slope_), 0.0)
-    * state.parameters_.max_slope_factor_;
+                   - state.parameters_.max_slope_), 0.0)
+             * state.parameters_.max_slope_factor_;
 
   /* 0.2: account for staffline offset. */
   Real max_dy = (fabs (dy) + 0.2);
@@ -434,11 +481,11 @@ Slur_configuration ::score_slopes (Slur_score_state const &state)
 
   if (!state.is_broken_)
     demerit += state.parameters_.steeper_slope_factor_
-      * (max (fabs (slur_dy) -max_dy, 0.0));
+               * (max (fabs (slur_dy) - max_dy, 0.0));
 
   demerit += max ((fabs (slur_dy / slur_dz[X_AXIS])
-                  - state.parameters_.max_slope_), 0.0)
-    * state.parameters_.max_slope_factor_;
+                   - state.parameters_.max_slope_), 0.0)
+             * state.parameters_.max_slope_factor_;
 
   if (sign (dy) == 0
       && sign (slur_dy) != 0
@@ -450,17 +497,58 @@ Slur_configuration ::score_slopes (Slur_score_state const &state)
       && sign (slur_dy)
       && sign (slur_dy) != sign (dy))
     demerit += state.edge_has_beams_
-      ? state.parameters_.same_slope_penalty_ / 10
-      : state.parameters_.same_slope_penalty_;
+               ? state.parameters_.same_slope_penalty_ / 10
+               : state.parameters_.same_slope_penalty_;
 
   add_score (demerit, "slope");
 }
 
+// This is a temporary hack to see how much we can gain by using a
+// priority queue on the beams to score.
+static int score_count = 0;
+LY_DEFINE (ly_slur_score_count, "ly:slur-score-count", 0, 0, 0,
+           (),
+           "count number of slur scores.")
+{
+  return scm_from_int (score_count);
+}
+
 void
-Slur_configuration::calculate_score (Slur_score_state const &state)
+Slur_configuration::run_next_scorer (Slur_score_state const &state)
+{
+  switch (next_scorer_todo)
+    {
+    case EXTRA_ENCOMPASS:
+      score_extra_encompass (state);
+      break;
+    case SLOPE:
+      score_slopes (state);
+      break;
+    case EDGES:
+      score_edges (state);
+      break;
+    case ENCOMPASS:
+      score_encompass (state);
+      break;
+    default:
+      assert (false);
+    }
+  next_scorer_todo++;
+  score_count++;
+}
+
+bool
+Slur_configuration::done () const
+{
+  return next_scorer_todo >= NUM_SCORERS;
+}
+
+Slur_configuration *
+Slur_configuration::new_config (Drul_array<Offset> const &offs, int idx)
 {
-  score_extra_encompass (state);
-  score_slopes (state);
-  score_edges (state);
-  score_encompass (state);
+  Slur_configuration *conf = new Slur_configuration;
+  conf->attachment_ = offs;
+  conf->index_ = idx;
+  conf->next_scorer_todo = INITIAL_SCORE + 1;
+  return conf;
 }