]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/align-interface.cc
Fix some bugs in the dynamic engraver and PostScript backend
[lilypond.git] / lily / align-interface.cc
index 20f07919bde0c2392b0fff4d7539e32a40f8e53f..c315e4ec32258ff19eec3acea76b8ed89f8c7738 100644 (file)
-/*   
-  align-interface.cc --  implement Align_interface
-  
+/*
+  align-interface.cc -- implement Align_interface
+
   source file of the GNU LilyPond music typesetter
-  
-  (c) 2000--2004 Han-Wen Nienhuys <hanwen@cs.uu.nl>
-  
- */
+
+  (c) 2000--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
+*/
 
 #include "align-interface.hh"
-#include "grob.hh"
-#include "group-interface.hh"
+#include "spanner.hh"
+#include "item.hh"
 #include "axis-group-interface.hh"
+#include "pointer-group-interface.hh"
 #include "hara-kiri-group-spanner.hh"
-#include "paper-def.hh"
+#include "grob-array.hh"
+#include "international.hh"
+
+/*
+  TODO: for vertical spacing, should also include a rod & spring
+  scheme of sorts into this: the alignment should default to a certain
+  distance between element refpoints, unless bbox force a bigger
+  distance.
+ */
 
-MAKE_SCHEME_CALLBACK (Align_interface,alignment_callback,2);
+MAKE_SCHEME_CALLBACK (Align_interface, calc_positioning_done, 1);
 SCM
-Align_interface::alignment_callback (SCM element_smob, SCM axis)
+Align_interface::calc_positioning_done (SCM smob)
 {
-  Grob * me = unsmob_grob (element_smob);
-  Axis ax = (Axis)gh_scm2int (axis);
-  Grob * par = me->get_parent (ax);
-  if (par && !to_boolean (par->get_property ("positioning-done")))
-    {
-      Align_interface::align_elements_to_extents (par, ax);
-    }
-  return gh_double2scm (0.0);
+  Grob *me = unsmob_grob (smob);
+  SCM axis = scm_car (me->get_property ("axes"));
+  Axis ax = Axis (scm_to_int (axis));
+
+  SCM force = me->get_property ("forced-distance");
+  if (scm_is_number (force))
+    Align_interface::align_to_fixed_distance (me, ax);
+  else
+    Align_interface::align_elements_to_extents (me, ax);
+
+  return SCM_BOOL_T;
 }
 
-MAKE_SCHEME_CALLBACK (Align_interface,fixed_distance_alignment_callback,2);
+/*
+  merge with align-to-extents?
+*/
+MAKE_SCHEME_CALLBACK(Align_interface, stretch_after_break, 1)
 SCM
-Align_interface::fixed_distance_alignment_callback (SCM element_smob, SCM axis)
+Align_interface::stretch_after_break (SCM grob)
 {
-  Grob * me = unsmob_grob (element_smob);
-  Axis ax = (Axis)gh_scm2int (axis);
-  Grob * par = me->get_parent (ax);
-  if (par && !to_boolean (par->get_property ("positioning-done")))
+  Grob *me = unsmob_grob (grob);
+
+  Spanner *me_spanner = dynamic_cast<Spanner *> (me);
+  extract_grob_set (me, "elements", elems);
+
+  if (me_spanner && elems.size ())
     {
-      Align_interface::align_to_fixed_distance (par, ax);
+      Grob *common = common_refpoint_of_array (elems, me, Y_AXIS);
+
+      /* force position callbacks */
+      for (vsize i = 0; i < elems.size (); i++)
+       elems[i]->relative_coordinate (common, Y_AXIS);
+
+      SCM details =  me_spanner->get_bound (LEFT)->get_property ("line-break-system-details");
+      SCM extra_space_handle = scm_assoc (ly_symbol2scm ("fixed-alignment-extra-space"), details);
+      
+      Real extra_space = robust_scm2double (scm_is_pair (extra_space_handle)
+                                           ? scm_cdr (extra_space_handle)
+                                           : SCM_EOL,
+                                           0.0);
+
+      Direction stacking_dir = robust_scm2dir (me->get_property ("stacking-dir"),
+                                              DOWN);
+      Real delta  = extra_space / elems.size() * stacking_dir;
+      for (vsize i = 0; i < elems.size (); i++)
+       elems[i]->translate_axis (i * delta, Y_AXIS);
     }
-  return gh_double2scm (0.0);
+  
+  return SCM_UNSPECIFIED;
 }
 
 /*
-  merge with align-to-extents? 
- */
+  merge with align-to-extents?
+*/
 void
-Align_interface::align_to_fixed_distance (Grob *me , Axis a)
+Align_interface::align_to_fixed_distance (Grob *me, Axis a)
 {
-  me->set_property ("positioning-done", SCM_BOOL_T);
-  
-  SCM d =   me->get_property ("stacking-dir");
-  
-  Direction stacking_dir = gh_number_p (d) ? to_dir (d) : CENTER;
-  if (!stacking_dir)
-    stacking_dir = DOWN;
+  Direction stacking_dir = robust_scm2dir (me->get_property ("stacking-dir"),
+                                          DOWN);
 
-  Real dy = robust_scm2double (me->get_property ("forced-distance"),0.0);
-  
-  Link_array<Grob> elems
-    = Pointer_group_interface__extract_grobs (me, (Grob*) 0, "elements");
+  Real dy = robust_scm2double (me->get_property ("forced-distance"), 0.0);
+
+  extract_grob_set (me, "elements", elem_source);
+
+  vector<Grob*> elems (elem_source); // writable..
 
-  Real where_f=0;
+  Real where_f = 0;
 
   Interval v;
   v.set_empty ();
-  Array<Real> translates;
-  
-  for (int j= elems.size (); j--; ) 
+  vector<Real> translates;
+
+  for (vsize j = elems.size (); j--;)
     {
       /*
        This is not very elegant, in that we need special support for
@@ -75,31 +106,27 @@ Align_interface::align_to_fixed_distance (Grob *me , Axis a)
        force_hara_kiri_callback () (extent and offset callback) is
        such that we might get into a loop if we call extent () or
        offset () the elements.
-       
-        
-       */
+      */
       if (a == Y_AXIS
          && Hara_kiri_group_spanner::has_interface (elems[j]))
        Hara_kiri_group_spanner::consider_suicide (elems[j]);
 
-      if (!elems[j]->live ())
-       elems.del (j);
+      if (!elems[j]->is_live ())
+       elems.erase (elems.begin () + j);
     }
 
-  for (int j =0; j < elems.size (); j++)
+  for (vsize j = 0; j < elems.size (); j++)
     {
       where_f += stacking_dir * dy;
-      translates.push (where_f);
+      translates.push_back (where_f);
       v.unite (Interval (where_f, where_f));
     }
 
   /*
-    TODO: support self-alignment-{Y,X}
-   */
-  for (int i = 0; i < translates.size (); i++)
-    {
-      elems[i]->translate_axis (translates[i] - v.center (), a);
-    }
+    TODO: support self-alignment-{Y, X}
+  */
+  for (vsize i = 0; i < translates.size (); i++)
+    elems[i]->translate_axis (translates[i] - v.center (), a);
 }
 
 /*
@@ -117,143 +144,168 @@ Align_interface::align_to_fixed_distance (Grob *me , Axis a)
   The original function has been taken over by
   align_to_fixed_distance ().
 */
+
 void
-Align_interface::align_elements_to_extents (Grob * me, Axis a)
+Align_interface::align_elements_to_extents (Grob *me, Axis a)
 {
-  me->set_property ("positioning-done", SCM_BOOL_T);
-  
-  SCM d =   me->get_property ("stacking-dir");
-  
-  Direction stacking_dir = gh_number_p (d) ? to_dir (d) : CENTER;
-  if (!stacking_dir)
-    stacking_dir = DOWN;
-  
-  Interval threshold  = robust_scm2interval ( me->get_property ("threshold"), Interval (0, Interval::infinity ()));
+  Spanner *me_spanner = dynamic_cast<Spanner *> (me);
+
+
+  SCM line_break_details = SCM_EOL;
+  if (a == Y_AXIS && me_spanner)
+    {
+      line_break_details = me_spanner->get_bound (LEFT)->get_property ("line-break-system-details");
+
+      if (!me->get_system ())
+       me->warning (_ ("vertical alignment called before line-breaking.\n"
+                       "Only do cross-staff spanners with PianoStaff."));
+
+    }
   
-  Array<Interval> dims;
+  Direction stacking_dir = robust_scm2dir (me->get_property ("stacking-dir"),
+                                          DOWN);
+
+  Interval threshold = robust_scm2interval (me->get_property ("threshold"),
+                                           Interval (0, Interval::infinity ()));
 
-  Link_array<Grob> elems;
-  Link_array<Grob> all_grobs
-    = Pointer_group_interface__extract_grobs (me, (Grob*) 0, "elements");
-  for (int i=0; i < all_grobs.size (); i++) 
+  vector<Interval> dims;
+  vector<Grob*> elems;
+
+  extract_grob_set (me, "elements", all_grobs);
+  for (vsize i = 0; i < all_grobs.size (); i++)
     {
       Interval y = all_grobs[i]->extent (me, a);
       if (!y.is_empty ())
        {
-         Grob *e =dynamic_cast<Grob*> (all_grobs[i]);
+         Grob *e = dynamic_cast<Grob *> (all_grobs[i]);
 
-         elems.push (e);
-         dims.push (y);          
+         elems.push_back (e);
+         dims.push_back (y);
        }
     }
-  
+
   /*
     Read self-alignment-X and self-alignment-Y. This may seem like
     code duplication. (and really: it is), but this is necessary to
     prevent ugly cyclic dependencies that arise when you combine
     self-alignment on a child with alignment of children.
   */
- static SCM  prop_syms[2];
+  SCM align ((a == X_AXIS)
+            ? me->get_property ("self-alignment-X")
+            : me->get_property ("self-alignment-Y"));
 
-  if (!prop_syms[0])
-    {
-      prop_syms[X_AXIS] = ly_symbol2scm ("self-alignment-X");
-      prop_syms[Y_AXIS] = ly_symbol2scm ("self-alignment-Y");
-    }
-  
-  SCM align (me->internal_get_property (prop_syms[a]));
-  
-  Array<Real> translates ;
   Interval total;
-  Real where_f=0;
+  Real where = 0;
+  Real extra_space = 0.0;
+  SCM extra_space_handle = scm_assq (ly_symbol2scm ("alignment-extra-space"), line_break_details);
+
+  extra_space = robust_scm2double (scm_is_pair (extra_space_handle)
+                                  ? scm_cdr (extra_space_handle)
+                                  : SCM_EOL,
+                                  extra_space);
   
-  for (int j=0 ;  j < elems.size (); j++) 
+  vector<Real> translates;
+  for (vsize j = 0; j < elems.size (); j++)
     {
-      Real dy = -  dims[j][-stacking_dir];
+      Real dy = -dims[j][-stacking_dir];
       if (j)
-       dy += dims[j-1][stacking_dir];
-
+       dy += dims[j - 1][stacking_dir];
 
       /*
        we want dy to be > 0
-       */
-      dy *= stacking_dir; 
+      */
+      dy *= stacking_dir;
       if (j)
+       dy = min (max (dy, threshold[SMALLER]), threshold[BIGGER]);
+
+      where += stacking_dir * (dy + extra_space / elems.size ());
+      total.unite (dims[j] + where);
+      translates.push_back (where);
+    }
+
+  SCM offsets_handle = scm_assq (ly_symbol2scm ("alignment-offsets"), line_break_details);
+  if (scm_is_pair (offsets_handle))
+    {
+      vsize i = 0;
+      for (SCM s = scm_cdr (offsets_handle); scm_is_pair (s) && i < translates.size (); s = scm_cdr (s), i++)
        {
-         dy = (dy >? threshold[SMALLER])
-           <? threshold[BIGGER];
+         if (scm_is_number (scm_car (s)))
+           translates[i] = scm_to_double (scm_car (s));
        }
-
-      where_f += stacking_dir * dy;
-      total.unite (dims[j] +   where_f);
-      translates.push (where_f);
     }
 
   
   Real center_offset = 0.0;
+  
   /*
-    also move the grobs that were empty, to maintain spatial order. 
+    also move the grobs that were empty, to maintain spatial order.
   */
-  Array<Real> all_translates;
+  vector<Real> all_translates;
   if (translates.size ())
     {
-      int i =0;
-      int j =0;
       Real w = translates[0];
-      while (j  < all_grobs.size ())
+      for  (vsize i = 0, j = 0; j < all_grobs.size (); j++)
        {
          if (i < elems.size () && all_grobs[j] == elems[i])
-           {
-             w = translates[i++];
-           }
-         all_translates.push (w);
-         j++;
+           w = translates[i++];
+         all_translates.push_back (w);
        }
 
-
       /*
        FIXME: uncommenting freaks out the Y-alignment of
        line-of-score.
-       */
-      if (gh_number_p (align))
-       center_offset = total.linear_combination (gh_scm2double (align));
+      */
+      if (scm_is_number (align))
+       center_offset = total.linear_combination (scm_to_double (align));
 
-      for (int j = 0 ;  j < all_grobs.size (); j++)
+      for (vsize j = 0; j < all_grobs.size (); j++)
        all_grobs[j]->translate_axis (all_translates[j] - center_offset, a);
     }
 }
 Axis
-Align_interface::axis (Grob*me)
+Align_interface::axis (Grob *me)
 {
-  return  Axis (gh_scm2int (ly_car (me->get_property ("axes"))));
+  return Axis (scm_to_int (scm_car (me->get_property ("axes"))));
 }
 
 void
-Align_interface::add_element (Grob*me,Grob* s, SCM cb)
+Align_interface::add_element (Grob *me, Grob *element)
 {
-  s->add_offset_callback (cb, Align_interface::axis (me));
-  Axis_group_interface::add_element (me, s);
+  Axis a = Align_interface::axis (me);
+  SCM sym = axis_offset_symbol (a);
+  SCM proc = axis_parent_positioning (a);
+    
+  element->internal_set_property (sym, proc);
+  Axis_group_interface::add_element (me, element);
 }
 
 void
-Align_interface::set_axis (Grob*me,Axis a)
+Align_interface::set_ordered (Grob *me)
 {
-  Axis_group_interface::set_axes (me, a,a);
-}
+  SCM ga_scm = me->get_object ("elements");
+  Grob_array *ga = unsmob_grob_array (ga_scm);
+  if (!ga)
+    {
+      ga_scm = Grob_array::make_array ();
+      ga = unsmob_grob_array (ga_scm);
+      me->set_object ("elements", ga_scm);
+    }
 
+  ga->set_ordered (true);
+}
 
 /*
   Find Y-axis parent of G that has a #'forced-distance property. This
   has the effect of finding the piano-staff given an object in that
   piano staff.
- */
+*/
 Grob *
-find_fixed_alignment_parent  (Grob *g)
+find_fixed_alignment_parent (Grob *g)
 {
   while (g)
     {
-      if (gh_number_p (g->get_property ("forced-distance")))
+      if (scm_is_number (g->get_property ("forced-distance")))
        return g;
 
       g = g->get_parent (Y_AXIS);
@@ -262,19 +314,29 @@ find_fixed_alignment_parent  (Grob *g)
   return 0;
 }
 
-
-
-
-ADD_INTERFACE (Align_interface, "align-interface",
-              "Order grobs from top to bottom, left to right, right to left or bottom"
-              "to top."
+ADD_INTERFACE (Align_interface,
+              "align-interface",
+              
+              "Order grobs from top to bottom, left to right, right to left or bottom "
+              "to top.  "
+              "For vertical alignments of staves, the @code{break-system-details} of "
+              "the left @internalsref{NonMusicalPaperColumn} may be set to tune vertical spacing "
+              "Set @code{alignment-extra-space} to add extra space for staves. Set "
+              "@code{fixed-alignment-extra-space} to force staves in PianoStaves further apart."
               ,
-              "forced-distance stacking-dir align-dir threshold positioning-done "
-              "center-element elements axes");
-
+              
+              /*
+                properties
+               */
+              "forced-distance "
+              "stacking-dir "
+              "align-dir "
+              "threshold "
+              "positioning-done "
+              "elements axes");
 
 struct Foobar
 {
-  bool has_interface (Grob*);
+  bool has_interface (Grob *);
 };