]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/line-spanner.cc
Merge branch 'master' of ssh+git://hanwen@git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / lily / line-spanner.cc
index fad5b352513cb5f3d71048f3af2c2525caa5f1b6..db36434b04b252e7a33da6d629d94609ef29f9b2 100644 (file)
 
   source file of the GNU LilyPond music typesetter
 
-  (c) 2000--2002 Jan Nieuwenhuizen <janneke@gnu.org>
+  (c) 2000--2007 Jan Nieuwenhuizen <janneke@gnu.org>
 */
 
-#include "molecule.hh"
-#include "item.hh"
 #include "spanner.hh"
-#include "line-spanner.hh"
-#include "paper-def.hh"
-#include "paper-column.hh"
+#include "output-def.hh"
+#include "item.hh"
 #include "staff-symbol-referencer.hh"
 #include "font-interface.hh"
+#include "warn.hh"
+#include "align-interface.hh"
+#include "line-interface.hh"
+#include "moment.hh"
 
-#include <math.h>
-
-
-/*
-  slightishly clumsy interface?
-
-  Make  a Scheme expression for a line going from (0,0) to (dx,dy). 
- */
+#include "lily-proto.hh"
+#include "grob-interface.hh"
+#include "text-interface.hh"
 
-static SCM
-line_atom (Grob* me, Real thick, Real dx, Real dy)
+class Line_spanner
 {
-  SCM type = me->get_grob_property ("type");
-  Real staff_space = Staff_symbol_referencer::staff_space (me);
-  
-      // maybe these should be in line-thickness?
-  Real length = staff_space;
-  SCM s = me->get_grob_property ("dash-length");
-  if (gh_number_p (s))
-    length = gh_scm2double (s) * staff_space;
-
-  Real period = 2 * length + thick;
-  s = me->get_grob_property ("dash-period");
-  if (gh_number_p (s))
-    period = gh_scm2double (s) * staff_space;
-      
-  if (type == ly_symbol2scm ("dotted-line"))
-    length = thick;
-       
-  if (type == ly_symbol2scm ("line"))
-    length = period + thick;
-
-  Real on = length - thick;
-  Real off = period - on;
-
-  SCM list = scm_list_n (ly_symbol2scm ("dashed-line"),
-                     gh_double2scm (thick),
-                     gh_double2scm (on),
-                     gh_double2scm (off),
-                     gh_double2scm (dx),
-                     gh_double2scm (dy),
-                     SCM_UNDEFINED);
-
-  return list;
+public:
+  DECLARE_SCHEME_CALLBACK (print, (SCM));
+  DECLARE_SCHEME_CALLBACK (after_line_breaking, (SCM));
+  DECLARE_SCHEME_CALLBACK (calc_left_bound_info, (SCM));
+  DECLARE_SCHEME_CALLBACK (calc_left_bound_info_and_text, (SCM));
+  DECLARE_SCHEME_CALLBACK (calc_right_bound_info, (SCM));
+  DECLARE_SCHEME_CALLBACK (calc_bound_info, (SCM, Direction));
+  DECLARE_GROB_INTERFACE ();
+};
+
+
+static Grob *
+line_spanner_common_parent (Grob *me)
+{
+  Grob *common = find_fixed_alignment_parent (me);
+  if (!common)
+    {
+      common = Staff_symbol_referencer::get_staff_symbol (me);
+      if (common)
+       common = common->get_parent (Y_AXIS);
+      else
+       common = me->get_parent (Y_AXIS);
+    }
+
+  return common;
 }
 
-static SCM
-zigzag_atom (Grob* me, Real thick, Real dx, Real dy)
+SCM
+Line_spanner::calc_bound_info (SCM smob, Direction dir)
 {
-  Real staff_space = Staff_symbol_referencer::staff_space (me);
-  SCM ws = me->get_grob_property ("zigzag-width");
-  SCM ls = me->get_grob_property ("zigzag-length");
-  double w = (gh_number_p(ws) ? gh_scm2double(ws) : 1)*staff_space;
-  double l = (gh_number_p(ls) ? gh_scm2double(ls) : 1)*w;
-  double h = l>w/2 ? sqrt(l*l-w*w/4) : 0;
-  
-  SCM list = scm_list_n (ly_symbol2scm ("zigzag-line"),
-                     gh_bool2scm (true),
-                     gh_double2scm (w),
-                     gh_double2scm (h),
-                     gh_double2scm (thick),
-                     gh_double2scm (dx),
-                     gh_double2scm (dy),
-                     SCM_UNDEFINED);
-
-  return list;
-}
+  Spanner *me = unsmob_spanner (smob);
 
+  Grob *commonx = me->get_bound (LEFT)->common_refpoint (me->get_bound (RIGHT), X_AXIS);
+  commonx = me->common_refpoint (commonx, X_AXIS);
 
+  SCM bound_details = me->get_property ("bound-details");
 
-Molecule
-Line_spanner::line_molecule (Grob* me, Real thick, Real dx, Real dy)
-{
-  Molecule mol;
-  SCM type = me->get_grob_property ("type");
-  if (gh_symbol_p (type)
-      && (type == ly_symbol2scm ("line")
-         || type == ly_symbol2scm ("dashed-line")
-         || type == ly_symbol2scm ("dotted-line")
-         || (type == ly_symbol2scm ("trill") && dy != 0)))
-    {
-      Box b (Interval (-0.5* thick +  (0 <? dx) ,0.5* thick+ (0 >? dx)),
-            Interval (- 0.5* thick + (0<? dy), 0.5*thick + (0 >? dy)));
-      mol = Molecule (b, line_atom (me, thick, dx, dy));
-    }
-  else if (gh_symbol_p (type)
-          && type == ly_symbol2scm ("zigzag"))
+  SCM details = SCM_BOOL_F;
+  if (details == SCM_BOOL_F)
+    details = ly_assoc_get ((dir == LEFT)
+                           ? ly_symbol2scm ("left")
+                           : ly_symbol2scm ("right"), bound_details, SCM_BOOL_F);
+
+  if (me->get_bound (dir)->break_status_dir ())
     {
-      // TODO:
-      Box b (Interval (-0.5* thick +  (0 <? dx) ,0.5* thick+ (0 >? dx)),
-            Interval (- 0.5* thick + (0<? dy), 0.5*thick + (0 >? dy)));
-      mol = Molecule (b, zigzag_atom (me, thick, dx, dy));
+      SCM extra = ly_assoc_get ((dir == LEFT)
+                               ? ly_symbol2scm ("left-broken")
+                               : ly_symbol2scm ("right-broken"), bound_details, SCM_EOL);
 
+      for (SCM s = extra; scm_is_pair (s); s = scm_cdr (s))
+       details = scm_cons (scm_car (s), details);
     }
-  else if (gh_symbol_p (type)
-          && type == ly_symbol2scm ("trill"))
+  
+  if (details == SCM_BOOL_F)
+    details = ly_assoc_get (ly_symbol2scm ("default"), bound_details, SCM_EOL);
+
+  SCM text = ly_assoc_get (ly_symbol2scm ("text"), details, SCM_BOOL_F);
+  if (Text_interface::is_markup (text))
     {
-      SCM alist_chain = Font_interface::font_alist_chain (me);
-      SCM style_chain = scm_list_n (gh_cons (ly_symbol2scm ("font-family"),
-                                         ly_symbol2scm ("music")),
-                                SCM_UNDEFINED);
-      
-      Font_metric *fm = Font_interface::get_font (me,
-                                                 scm_list_n (style_chain,
-                                                          alist_chain,
-                                                          SCM_UNDEFINED));
-      Molecule m = fm->find_by_name ("scripts-trill-element");
-      do
-       mol.add_at_edge (X_AXIS, RIGHT, m, 0,0);
-      while (m.extent (X_AXIS).length ()
-            && mol.extent (X_AXIS).length ()
-            + m.extent (X_AXIS).length () < dx);
-
-      /*
-       FIXME: should center element on x/y
-       */
-      mol.translate_axis (m.extent (X_AXIS).length () / 2, X_AXIS);
-      mol.translate_axis (-(mol.extent (Y_AXIS)[DOWN]
-                           + mol.extent (Y_AXIS).length ())/2, Y_AXIS); 
+      Output_def *layout = me->layout ();
+      SCM properties = Font_interface::text_font_alist_chain (me);
+      details = scm_acons (ly_symbol2scm ("stencil"),
+                          Text_interface::interpret_markup (layout->self_scm (),
+                                                            properties, text),
+                          details);
     }
-  return mol;
-}
-
-Offset
-Line_spanner::get_broken_offset (Grob *me, Direction dir)
-{
-  Spanner *spanner = dynamic_cast<Spanner*> (me);
-  Item* bound = spanner->get_bound (dir);
   
-  if (!bound->break_status_dir ())
+  if (!scm_is_number (ly_assoc_get (ly_symbol2scm ("X"), details, SCM_BOOL_F)))
     {
-      Grob *common[] = {
-       bound->common_refpoint (Staff_symbol_referencer::get_staff_symbol (me),
-                               X_AXIS),
-       bound->common_refpoint (Staff_symbol_referencer::get_staff_symbol (me),
-                               Y_AXIS)
-      };
-  
-      return Offset (abs (bound->extent (common[X_AXIS], X_AXIS)[-dir]),
-                     bound->extent (common[Y_AXIS], Y_AXIS).center ());
+      Direction attach = (Direction)
+       robust_scm2int (ly_assoc_get (ly_symbol2scm ("attach-dir"),
+                                                    details, SCM_BOOL_F),
+                       CENTER);
+
+      details = scm_acons (ly_symbol2scm ("X"),
+                          scm_from_double (me->get_bound (dir)->extent (commonx, X_AXIS)
+                                           .linear_combination (attach)),
+                          details);
     }
-  return Offset ();
-}
+  
 
-Offset
-Line_spanner::broken_trend_offset (Grob *me, Direction dir)
-{
-  /* A broken line-spaner should maintain the same vertical trend
-     the unbroken line-spanner would have had.
-     From slur */
-  Offset o;
-  if (Spanner *mother =  dynamic_cast<Spanner*> (me->original_))
+  if (!scm_is_number (ly_assoc_get (ly_symbol2scm ("Y"), details, SCM_BOOL_F)))
     {
-      for (int i = dir == LEFT ? 0 : mother->broken_intos_.size () - 1;
-          dir == LEFT ? i < mother->broken_intos_.size () : i > 0;
-          dir == LEFT ? i++ : i--)
+      Real y = 0.0;
+
+      Real extra_dy = robust_scm2double (me->get_property ("extra-dy"),
+                                        0.0);
+         
+      if (me->get_bound (dir)->break_status_dir ())
        {
-         if (mother->broken_intos_[i - dir] == me)
+         /*
+           This is hairy. For the normal case, we simply find common
+           parents, and draw a line between the bounds. When two note
+           heads are on different systems, there is no common parent
+           anymore. We have to find the piano-staff object.
+         */
+
+         Spanner *next_sp = me->broken_neighbor (dir);
+         Item *next_bound = next_sp->get_bound (dir);
+
+         if (next_bound->break_status_dir ())
            {
-             Grob *neighbour = mother->broken_intos_[i];
-             Offset neighbour_o = get_broken_offset (neighbour, dir);
-             Offset me_o = get_broken_offset (me, -dir);
-             // Hmm, why not return me_o[X], but recalc in brew_mol?
-             o = Offset (0,
- (neighbour_o[Y_AXIS]*me_o[X_AXIS]
-                          - me_o[Y_AXIS]*neighbour_o[X_AXIS]) * dir /
- (me_o[X_AXIS] + neighbour_o[X_AXIS]));
-             break;
+             programming_error ("no note heads for the line spanner on neighbor line?"
+                                " Confused.");
+             me->suicide ();
+             return SCM_EOL;
            }
+
+         Grob *next_common_y = line_spanner_common_parent (next_bound);
+         Interval next_ext = next_bound->extent (next_common_y, Y_AXIS);
+
+         y = next_ext.center ();
+       }
+      else
+       {
+         Grob *commony = me->common_refpoint (me->get_bound (dir), Y_AXIS);
+         y = me->get_bound (dir)->extent (commony, Y_AXIS).center ();
+         details = scm_acons (ly_symbol2scm ("common-Y"), commony->self_scm (), details);
        }
-    }
-  return o;
-}
 
+      y += dir * extra_dy / 2; 
+      details = scm_acons (ly_symbol2scm ("Y"), scm_from_double (y), details);
+    }
 
-/*
-  Warning: this thing is a cross-staff object, so it should have empty Y-dimensions.
+  return details;
+}
 
- (If not, you risk that this is called from the staff-alignment
-  routine, via molecule_extent. At this point, the staves aren't
-  separated yet, so it doesn't work cross-staff.
+MAKE_SCHEME_CALLBACK (Line_spanner, calc_right_bound_info, 1);
+SCM
+Line_spanner::calc_right_bound_info (SCM smob)
+{
+  return Line_spanner::calc_bound_info (smob, RIGHT);
+}
 
-*/
+MAKE_SCHEME_CALLBACK (Line_spanner, calc_left_bound_info, 1);
+SCM
+Line_spanner::calc_left_bound_info (SCM smob)
+{
+  return Line_spanner::calc_bound_info (smob, LEFT);
+}
 
-MAKE_SCHEME_CALLBACK (Line_spanner, brew_molecule, 1);
+MAKE_SCHEME_CALLBACK (Line_spanner, calc_left_bound_info_and_text, 1);
 SCM
-Line_spanner::brew_molecule (SCM smob) 
+Line_spanner::calc_left_bound_info_and_text (SCM smob)
 {
-  Grob *me= unsmob_grob (smob);
-
-  Spanner *spanner = dynamic_cast<Spanner*> (me);
-  Item* bound_drul[] = {
-    spanner->get_bound (LEFT),
-    0,
-    spanner->get_bound (RIGHT)
-  };
-  
-  Item** bound = bound_drul + 1;
+  SCM alist = Line_spanner::calc_bound_info (smob, LEFT);
+  Spanner *me = unsmob_spanner (smob);
 
-  Grob *common[] = { 0, 0 };
-  for (Axis a = X_AXIS;  a < NO_AXES; a = Axis (a + 1))
+  SCM text = me->get_property ("text");
+  if (Text_interface::is_markup (text)
+      && me->get_bound (LEFT)->break_status_dir () == CENTER
+      && ly_assoc_get (ly_symbol2scm ("stencil"), alist, SCM_BOOL_F) == SCM_BOOL_F)
     {
-      common[a] = bound[LEFT]->common_refpoint (bound[RIGHT], a);
-      
-      if (!common[a])
-       return SCM_EOL;
+      Output_def *layout = me->layout ();
+      SCM properties = Font_interface::text_font_alist_chain (me);
+      alist = scm_acons (ly_symbol2scm ("stencil"),
+                        Text_interface::interpret_markup (layout->self_scm (),
+                                                          properties, text),
+                        alist);
     }
   
-  Real gap = gh_scm2double (me->get_grob_property ("gap"));
-  Real dist; /*distance between points */
+  return alist;
+}
+
+MAKE_SCHEME_CALLBACK (Line_spanner, print, 1);
+SCM
+Line_spanner::print (SCM smob)
+{
+  Spanner *me = dynamic_cast<Spanner *> (unsmob_grob (smob));
+
+  Interval_t<Moment> moments = me->spanned_time ();
+  /*
+    We remove the line at the start of the line.  For piano voice
+    indicators, it makes no sense to have them at the start of the
+    line.
 
-  Offset ofxy (gap, 0); /*offset from start point to start of line*/
-  Offset dxy ;
-  Offset my_off;
-  Offset his_off;
+    I'm not sure what the official rules for glissandi are, but
+    usually the 2nd note of the glissando is "exact", so when playing
+    from the start of the line, there is no need to glide.
 
+    From a typographical p.o.v. this makes sense, since the amount of
+    space left of a note at the start of a line is very small.
+
+    --hwn.
+
+  */
+  if (moments.length () == Moment (0,0))
+    return SCM_EOL;
   
-  if (bound[LEFT]->break_status_dir () || bound[RIGHT]->break_status_dir ())
-    /* across line break */
-    {
-      Direction broken = bound[LEFT]->break_status_dir () ? LEFT : RIGHT;
+  Drul_array<SCM> bounds (me->get_property ("left-bound-info"),
+                         me->get_property ("right-bound-info"));
+
+  
+  Grob *commonx = me->get_bound (LEFT)->common_refpoint (me->get_bound (RIGHT), X_AXIS);
+  commonx = me->common_refpoint (commonx, X_AXIS);
 
-      dxy[X_AXIS] = bound[RIGHT]->extent (common[X_AXIS], X_AXIS)[LEFT]
-       - bound[LEFT]->extent (common[X_AXIS], X_AXIS)[RIGHT];
+  Drul_array<Offset> span_points;
+
+  Direction d =  LEFT;
+  do
+    {
+      Offset z (robust_scm2double (ly_assoc_get (ly_symbol2scm ("X"),
+                                                bounds[d], SCM_BOOL_F), 0.0)
+               + commonx->relative_coordinate (commonx, X_AXIS),
+               robust_scm2double (ly_assoc_get (ly_symbol2scm ("Y"),
+                                                bounds[d], SCM_BOOL_F), 0.0));
       
-      dxy += broken_trend_offset (me, broken);
-      dxy[X_AXIS] -= 1 * gap;
+      span_points[d] = z;
+    }
+  while (flip (&d) != LEFT);
+
+  Drul_array<Real> gaps (0, 0);
+  Drul_array<bool> arrows (0, 0);
+  Drul_array<Stencil*> stencils (0,0);
+  Drul_array<Grob*> common_y (0, 0);
+  do
+    {
+      gaps[d] = robust_scm2double (ly_assoc_get (ly_symbol2scm ("padding"),
+                                                bounds[d], SCM_BOOL_F), 0.0);
+      arrows[d] = to_boolean (ly_assoc_get (ly_symbol2scm ("arrow"),
+                                           bounds[d], SCM_BOOL_F));
+      stencils[d] = unsmob_stencil (ly_assoc_get (ly_symbol2scm ("stencil"),
+                                                 bounds[d], SCM_BOOL_F));
+      common_y[d] = unsmob_grob (ly_assoc_get (ly_symbol2scm ("common-Y"),
+                                              bounds[d], SCM_BOOL_F));
+      if (!common_y[d])
+       common_y[d] = me; 
+    }
+  while (flip (&d) != LEFT);
 
-      my_off = Offset (0,
-                      me->relative_coordinate (common[Y_AXIS], Y_AXIS));
+  Grob *my_common_y = common_y[LEFT]->common_refpoint (common_y[RIGHT], Y_AXIS);
+  do
+    span_points[d][Y_AXIS] += common_y[d]->relative_coordinate (my_common_y, Y_AXIS);
+  while (flip (&d) != LEFT);
 
-      his_off = Offset (0, 
-                       bound[-broken]->relative_coordinate (common[Y_AXIS],
-                                                            Y_AXIS));
+  Offset dz = (span_points[RIGHT] - span_points[LEFT]);
+  Offset dz_dir = dz.direction ();
+  if (gaps[LEFT] + gaps[RIGHT] > dz.length ())
+    {
+      return SCM_EOL;
+    }
 
-      if (broken == LEFT)
+  Stencil line;
+  do
+    {
+      if (stencils[d])
        {
-         my_off[Y_AXIS] += dxy[Y_AXIS];
+        Stencil s = stencils[d]->translated (span_points[d]);
+        SCM align = ly_assoc_get (ly_symbol2scm ("stencil-align-dir-y"),
+                                  bounds[d], SCM_BOOL_F);
+        SCM off = ly_assoc_get (ly_symbol2scm ("stencil-offset"),
+                                  bounds[d], SCM_BOOL_F);
+
+        if (scm_is_number (align)) 
+          s.align_to (Y_AXIS, scm_to_double (align));
+
+        /*
+          todo: should use font-size.
+         */
+        if (is_number_pair (off))
+          s.translate (ly_scm2offset (off));
+        
+        line.add_stencil (s);
        }
     }
-  else
+  while (flip (&d) != LEFT);
+
+  do
     {
-      Real off = gap + ((bound[LEFT]->extent (bound[LEFT], X_AXIS).length ()*3)/4); // distance from center to start of line
-      dxy[X_AXIS] = bound[RIGHT]->extent (common[X_AXIS], X_AXIS).center ()
-       - bound[LEFT]->extent (common[X_AXIS], X_AXIS).center ();
-      dxy[Y_AXIS] = bound[RIGHT]->extent (common[Y_AXIS], Y_AXIS).center ()
-       - bound[LEFT]->extent (common[Y_AXIS], Y_AXIS).center ();
-
-      dist = sqrt (dxy[X_AXIS]*dxy[X_AXIS]+dxy[Y_AXIS]*dxy[Y_AXIS]);
-      ofxy = dxy* (off/dist);
-      dxy -= 2*ofxy;
-
-      my_off = Offset (me->relative_coordinate (common[X_AXIS], X_AXIS),
-                      me->relative_coordinate (common[Y_AXIS], Y_AXIS)); 
+      if (stencils[d])
+       span_points[d] += dz_dir *
+         (stencils[d]->extent (X_AXIS)[-d] / dz_dir[X_AXIS]);
       
-      his_off = Offset (bound[LEFT]->relative_coordinate (common[X_AXIS],
-                                                         X_AXIS),
-                       bound[LEFT]->relative_coordinate (common[Y_AXIS],
-                                                         Y_AXIS)); 
-      
-      }
-
-  Real thick = me->get_paper ()->get_var ("linethickness");  
-
-  SCM s = me->get_grob_property ("thickness");
-  if (gh_number_p (s))
-    thick *= gh_scm2double (s);
-
-  
-  Molecule line = line_molecule (me, thick, dxy[X_AXIS], dxy[Y_AXIS]);
-  line.translate_axis (bound[LEFT]->extent (bound[LEFT],
-                                           X_AXIS).length ()/2, X_AXIS); 
-  line.translate (ofxy - my_off + his_off);
+      span_points[d] += -d * gaps[d] *  dz.direction ();
+    }
+  while (flip (&d) != LEFT);
+
+  line.add_stencil (Line_interface::line (me, 
+                                         span_points[LEFT],
+                                         span_points[RIGHT]));
+
+  line.add_stencil (Line_interface::arrows (me,
+                                           span_points[LEFT],
+                                           span_points[RIGHT],
+                                           arrows[LEFT],
+                                           arrows[RIGHT]));
+
+  line.translate (Offset (-me->relative_coordinate (commonx, X_AXIS),
+                         -me->relative_coordinate (my_common_y, Y_AXIS)));
+                         
+    
   return line.smobbed_copy ();
 }
 
-
-
-ADD_INTERFACE (Line_spanner, "line-spanner-interface",
-  "Generic line drawn between two objects, eg. for use with glissandi.\n"
-"gap is measured in staff-spaces.\n"
-"The property 'type is one of: line, dashed-line, trill, dotted-line or zigzag.\n"
-"\n",
-  "gap dash-period dash-length zigzag-width zigzag-length thickness type");
-
+ADD_INTERFACE (Line_spanner,
+              "Generic line drawn between two objects, e.g. for use with glissandi.\n"
+              "The property @code{style} can be @code{line}, "
+              "@code{dashed-line}, @code{trill}, \n"
+              "@code{dotted-line} or @code{zigzag}.\n"
+              "\n",
+
+              "extra-dy "
+              "gap "
+              "thickness "
+              "bound-details " 
+              "left-bound-info " 
+              "right-bound-info " 
+              );