]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/side-position-interface.cc
release commit
[lilypond.git] / lily / side-position-interface.cc
index 6e018180fd05a83bc21ce7b4c0e661990476bd61..928d0e867970ae1fbf95e9f26a8bd15744559557 100644 (file)
-/*   
-  staff-side.cc --  implement Staff_side_element
-  
+/*
+  side-position-interface.cc -- implement Side_position_interface
+
   source file of the GNU LilyPond music typesetter
-  
-  (c) 1998--2000 Han-Wen Nienhuys <hanwen@cs.uu.nl>
-  
- */
-#include <math.h>              // ceil.
+
+  (c) 1998--2005 Han-Wen Nienhuys <hanwen@xs4all.nl>
+*/
 
 #include "side-position-interface.hh"
-#include "staff-symbol.hh"
-#include "debug.hh"
+
+#include <cmath>               // ceil.
+#include <algorithm>
+using namespace std;
+
+#include "note-head.hh"
+#include "warn.hh"
 #include "warn.hh"
 #include "dimensions.hh"
-#include "dimension-cache.hh"
 #include "staff-symbol-referencer.hh"
-
-Side_position_interface::Side_position_interface (Score_element const *e)
-{
-  elt_l_ = (Score_element*)e;
-}
+#include "pointer-group-interface.hh"
+#include "directional-element-interface.hh"
+#include "staff-symbol-referencer.hh"
+#include "staff-symbol.hh"
+#include "string-convert.hh"
+#include "misc.hh"
 
 void
-Side_position_interface::add_support (Score_element*e)
+Side_position_interface::add_support (Grob *me, Grob *e)
 {
-  SCM sup = elt_l_->get_elt_property ("side-support");
-  elt_l_->set_elt_property ("side-support",
-                           gh_cons (e->self_scm_,sup));
+  Pointer_group_interface::add_grob (me, ly_symbol2scm ("side-support-elements"), e);
 }
 
-
-
 Direction
-Side_position_interface::get_direction () const
+Side_position_interface::get_direction (Grob *me)
 {
-  SCM d = elt_l_->get_elt_property ("direction");
-  if (isdir_b (d))
-    return to_dir (d) ? to_dir (d) : DOWN;
+  Direction relative_dir = Direction (1);
+  SCM reldir = me->get_property ("side-relative-direction");
+  if (is_direction (reldir))
+    relative_dir = to_dir (reldir);
 
-  Direction relative_dir = UP;
-  SCM reldir = elt_l_->get_elt_property ("side-relative-direction");   // should use a lambda.
-  if (isdir_b (reldir))
-    {
-      relative_dir = to_dir (reldir);
-    }
-  
-  SCM other_elt = elt_l_->get_elt_property ("direction-source");
-  Score_element * e = unsmob_element(other_elt);
+  SCM other_elt = me->get_object ("direction-source");
+  Grob *e = unsmob_grob (other_elt);
   if (e)
-    {
-      return (Direction)(relative_dir * Side_position_interface (e).get_direction ());
-    }
-  
-  return DOWN;
+    return (Direction) (relative_dir * get_grob_direction (e));
+
+  return CENTER;
 }
-  
-/*
-   Callback that does the aligning. Puts the element next to the support
- */
 
-Real
-Side_position_interface::side_position (Score_element const *cme, Axis axis)
+/* Put the element next to the support, optionally taking in
+   account the extent of the support.  */
+SCM
+Side_position_interface::general_side_position (Grob *me, Axis a, bool use_extents)
 {
-  Score_element* me = (Score_element*)cme;
-  Score_element *common = me->parent_l (axis);
-  SCM support = me->get_elt_property ("side-support");
-  for (SCM s = support; s != SCM_EOL; s = gh_cdr (s))
-    {
-      Score_element * e  = unsmob_element (gh_car (s));
-      if (e)
-       common = common->common_refpoint (e, axis);
-    }
-  
-  Interval dim;
-  for (SCM s = support; s != SCM_EOL; s = gh_cdr (s))
-    {
+  Real ss = Staff_symbol_referencer::staff_space (me);
 
-      Score_element * e  = unsmob_element ( gh_car (s));
-      if (e)
-       {
-         Real coord = e->relative_coordinate (common, axis);
+  extract_grob_set (me, "side-support-elements", support);
 
-         dim.unite (coord + e->extent (axis));
-       }
-    }
+  Grob *common = common_refpoint_of_array (support, me->get_parent (a), a);
+  Grob *staff_symbol = Staff_symbol_referencer::get_staff_symbol (me);
+  bool include_staff = 
+    staff_symbol
+    && a == Y_AXIS
+    && scm_is_number (me->get_property ("staff-padding"))
+    && !to_boolean (me->get_property ("quantize-position"));
 
-  if (dim.empty_b ())
+  Interval dim;
+  Interval staff_extents;
+  if (include_staff)
     {
-      dim = Interval(0,0);
-    }
-
-  Direction dir = Side_position_interface (me).get_direction ();
-    
-  Real off =  me->parent_l (axis)->relative_coordinate (common, axis);
-  SCM minimum = me->remove_elt_property ("minimum-space");
+      common = staff_symbol->common_refpoint (common, Y_AXIS);
+      staff_extents = staff_symbol->extent (common, Y_AXIS);
 
-  Real total_off = dim[dir] + off;
-  SCM padding = me->remove_elt_property ("padding");
-  if (gh_number_p (padding))
-    {
-      total_off += gh_scm2double (padding) * dir;
+      if (include_staff)
+       dim.unite (staff_extents);
     }
-  if (gh_number_p (minimum) && total_off * dir < gh_scm2double (minimum))
+
+  for (int i = 0; i < support.size (); i++)
     {
-      total_off = gh_scm2double (minimum) * dir;
+      Grob *e = support[i];
+      if (e)
+       if (use_extents)
+         dim.unite (e->extent (common, a));
+       else
+         {
+           Real x = e->relative_coordinate (common, a);
+           dim.unite (Interval (x, x));
+         }
     }
-  if (fabs (total_off) > 100 CM)
-    programming_error ("Huh ? Improbable staff side dim.");
 
-  return total_off;
-}
+  if (dim.is_empty ())
+    dim = Interval (0, 0);
 
-/**
-  callback that centers the element on itself
- */
-Real
-Side_position_interface::aligned_on_self (Score_element const*elm, Axis ax)
-{
-  String s ("self-alignment-");
+  Direction dir = get_grob_direction (me);
+
+  Real off = me->get_parent (a)->relative_coordinate (common, a);
+  Real minimum_space = ss * robust_scm2double (me->get_property ("minimum-space"), -1);
 
-  s +=  (ax == X_AXIS) ? "X" : "Y";
+  Real total_off = dim.linear_combination (dir) - off;
+  total_off += dir * ss * robust_scm2double (me->get_property ("padding"), 0);
 
-  SCM align (elm->get_elt_property (s));
-  if (isdir_b (align))
+  if (minimum_space >= 0
+      && dir
+      && total_off * dir < minimum_space)
+    total_off = minimum_space * dir;
+  
+  /* FIXME: 100CM should relate to paper size.  */
+  if (fabs (total_off) > 100 CM)
     {
-      Direction d = to_dir (align);
-      Interval ext(elm->extent (ax));
+      String msg
+       = String_convert::form_string ("Improbable offset for grob %s: %f%s",
+                                      me->name ().to_str0 (), total_off,
+                                      INTERNAL_UNIT);
 
-      if (ext.empty_b ())
-       {
-         programming_error ("I'm empty. Can't align on self");
-         return 0.0;
-       }
-      else if (d)
-       {
-         return - ext[d];
-       }
-      return - ext.center ();
+      programming_error (msg);
     }
-  else
-    return 0.0;
+  return scm_from_double (total_off);
 }
 
 
-
-Real
-directed_round (Real f, Direction d)
+MAKE_SCHEME_CALLBACK (Side_position_interface, y_aligned_on_support_refpoints, 1);
+SCM
+Side_position_interface::y_aligned_on_support_refpoints (SCM smob)
 {
-  if (d < 0)
-    return floor (f);
-  else
-    return ceil (f);
+  return general_side_position (unsmob_grob (smob), Y_AXIS, false); 
 }
 
-/*
-  Callback that quantises in staff-spaces, rounding in the direction
-  of the elements "direction" elt property. */
-Real
-Side_position_interface::quantised_position (Score_element const *me, Axis a)
-{
-  Side_position_interface s(me);
-  Direction d = s.get_direction ();
-  Staff_symbol_referencer_interface si (me);
-
-  if (si.has_interface_b ())
-    {
-      Real p = si.position_f ();
-      Real rp = directed_round (p, d);
 
-      int ip = int  (rp);
-      if ((ip % 2) == 0)
-       {
-         ip += d;
-         rp += d;
-       }
-
-      return (rp - p) * si.staff_space () / 2.0;
-    }
-  return 0.0;
-}
 
 /*
   Position next to support, taking into account my own dimensions and padding.
- */
-Real
-Side_position_interface::aligned_side (Score_element const*me, Axis ax)
-{
-  Side_position_interface s(me);
-  Direction d = s.get_direction ();
-  Real o = side_position (me,ax);
-
-  Interval iv =  me->extent (ax);
-
-  if (!iv.empty_b ())
-    {
-      o += - iv[-d];
-
-      SCM pad = me->get_elt_property ("padding");
-      if (gh_number_p (pad))
-       o += d *gh_scm2double (pad) ; 
-    }
-  return o;
-}
+*/
 
-/*
-  Position centered on parent.
- */
-Real
-Side_position_interface::centered_on_parent (Score_element const* me, Axis a)
+MAKE_SCHEME_CALLBACK (Side_position_interface, x_aligned_side, 1);
+SCM
+Side_position_interface::x_aligned_side (SCM smob)
 {
-  Score_element *him = me->parent_l (a);
-
-  return him->extent (a).center ();  
+  return aligned_side (unsmob_grob (smob), X_AXIS);
 }
 
-
-void
-Side_position_interface::add_staff_support ()
+MAKE_SCHEME_CALLBACK (Side_position_interface, y_aligned_side, 1);
+SCM
+Side_position_interface::y_aligned_side (SCM smob)
 {
-  Staff_symbol_referencer_interface si (elt_l_);
-  if (si.staff_symbol_l ())
-    {
-      add_support (si.staff_symbol_l ());
-    }
+  return aligned_side (unsmob_grob (smob), Y_AXIS);
 }
 
-void
-Side_position_interface::set_axis (Axis a)
+SCM
+Side_position_interface::aligned_side (Grob*me, Axis a)
 {
-  // prop transparent ? 
-  if (elt_l_->get_elt_property ("side-support") == SCM_UNDEFINED)
-    elt_l_->set_elt_property ("side-support" ,SCM_EOL);
-
-  if (!elt_l_->has_offset_callback_b (aligned_side, a))
-    elt_l_->add_offset_callback (aligned_side, a);
-}
+  Direction dir = get_grob_direction (me);
 
+  Real o = scm_to_double (general_side_position (me, a, true));
+  Interval iv = me->extent (me, a);
 
-void
-Side_position_interface::set_quantised (Axis a)
-{
-  elt_l_->add_offset_callback (quantised_position, a);
-}
-
-Axis
-Side_position_interface::get_axis () const
-{
-  if (elt_l_->has_offset_callback_b (&side_position, X_AXIS)
-      || elt_l_->has_offset_callback_b (&aligned_side , X_AXIS))
-    return X_AXIS;
+  if (!iv.is_empty ())
+    {
+      if (!dir)
+       {
+         programming_error ("direction unknown, but aligned-side wanted");
+         dir = DOWN;
+       }
+      o += -iv[-dir];
+    }
 
-  
-  return Y_AXIS;
-}
+  /*
+    Maintain a minimum distance to the staff. This is similar to side
+    position with padding, but it will put adjoining objects on a row if
+    stuff sticks out of the staff a little.
+  */
+  Grob *staff = Staff_symbol_referencer::get_staff_symbol (me);
+  if (staff && a == Y_AXIS)
+    {
+      if (to_boolean (me->get_property ("quantize-position")))
+       {
+         Grob *common = me->common_refpoint (staff, Y_AXIS);
+         Real my_off = me->relative_coordinate (common, Y_AXIS);
+         Real staff_off = staff->relative_coordinate (common, Y_AXIS);
+         Real ss = Staff_symbol::staff_space (staff);
+         Real position = 2 * (my_off + o - staff_off) / ss;
+         Real rounded = directed_round (position, dir);
+         Grob *head = me->get_parent (X_AXIS);
+      
+         if (rounded <= Staff_symbol_referencer::staff_radius (me) 
+             || (Note_head::has_interface (head)
+                 && sign (Staff_symbol_referencer::get_position (head)) == - dir))
+           {
+             o += dir *(rounded - position) * 0.5 * ss;
+             if (Staff_symbol_referencer::on_staffline (me, int (rounded)))
+               o += dir * 0.5 * ss;
+           }
+       }
+      else if (scm_is_number (me->get_property ("staff-padding")))
+       {
+         Real padding
+           = Staff_symbol_referencer::staff_space (me)
+           * scm_to_double (me->get_property ("staff-padding"));
 
-void
-Side_position_interface::set_direction (Direction d) 
-{
-  elt_l_->set_elt_property ("direction", gh_int2scm (d));
-}
+         Grob *common = me->common_refpoint (staff, Y_AXIS);
 
-void
-Side_position_interface::set_minimum_space (Real m)
-{
-  elt_l_->set_elt_property ("minimum-space", gh_double2scm (m));
+         Interval staff_size = staff->extent (common, Y_AXIS);
+         Real diff = dir*staff_size[dir] + padding - dir * (o + iv[-dir]);
+         o += dir * max (diff, 0.0);
+       }
+    }
+  return scm_from_double (o);
 }
 
 void
-Side_position_interface::set_padding (Real p)
+Side_position_interface::set_axis (Grob *me, Axis a)
 {
-  elt_l_->set_elt_property ("padding", gh_double2scm (p));
+  add_offset_callback (me,
+                      (a==X_AXIS)
+                      ? x_aligned_side_proc
+                      : y_aligned_side_proc,
+                      a);
 }
 
-bool
-Side_position_interface::has_interface_b () const
-{
-  return elt_l_->get_elt_property ("side-support") != SCM_UNDEFINED;
-}
-
-bool
-Side_position_interface::supported_b () const
+// ugh. doesn't catch all variants. 
+Axis
+Side_position_interface::get_axis (Grob *me)
 {
-  SCM s =elt_l_->get_elt_property  ("side-support"); 
-  return s != SCM_UNDEFINED && s != SCM_EOL;
-}
-
-
+  if (me->get_property_data (ly_symbol2scm ("X-offset"))
+      == Side_position_interface::x_aligned_side_proc)
+    return X_AXIS;
+  else if (me->get_property_data (ly_symbol2scm ("Y-offset"))
+          == Side_position_interface::y_aligned_side_proc)
+    return Y_AXIS;
+
+  return NO_AXES;
+}
+
+ADD_INTERFACE (Side_position_interface, "side-position-interface",
+              "Position a victim object (this one) next to other objects (the "
+              "support).   The property @code{direction} signifies where to put the  "
+              "victim object relative to the support (left or right, up or down?)\n\n "
+              "The routine also takes the size the staff into account if "
+              "@code{staff-padding} is set. If undefined, the staff symbol is ignored.",
+
+              /* properties */
+              "direction "
+              "direction-source "
+              "minimum-space "
+              "padding "
+              "side-relative-direction "
+              "side-support-elements "
+              "slur-padding "
+              "staff-padding "
+              "quantize-position "
+              );