]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/stem.cc
* buildscripts/analyse-cxx-log.py: new file. Read compile log to
[lilypond.git] / lily / stem.cc
index f258b7aedad25edd22db88d73c4b426d1a7ce226..6829af1a358d66f6b155f0b8577151973a14a709 100644 (file)
@@ -3,7 +3,7 @@
 
   source file of the GNU LilyPond music typesetter
 
-  (c) 1996--2005 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+  (c) 1996--2006 Han-Wen Nienhuys <hanwen@xs4all.nl>
   Jan Nieuwenhuizen <janneke@gnu.org>
 
   TODO: This is way too hairy
@@ -15,7 +15,8 @@
 
 #include "stem.hh"
 
-#include <math.h>              // rint
+#include <cmath>               // rint
+using namespace std;
 
 #include "lookup.hh"
 #include "directional-element-interface.hh"
@@ -79,48 +80,20 @@ Stem::chord_start_y (Grob *me)
 {
   Interval hp = head_positions (me);
   if (!hp.is_empty ())
-    return hp[get_direction (me)] * Staff_symbol_referencer::staff_space (me)
+    return hp[get_grob_direction (me)] * Staff_symbol_referencer::staff_space (me)
       * 0.5;
   return 0;
 }
 
-Real
-Stem::stem_end_position (Grob *me)
-{
-  SCM p = me->get_property ("stem-end-position");
-  Real pos;
-  if (!scm_is_number (p))
-    {
-      pos = get_default_stem_end_position (me);
-      me->set_property ("stem-end-position", scm_from_double (pos));
-    }
-  else
-    pos = scm_to_double (p);
 
-  return pos;
-}
-
-Direction
-Stem::get_direction (Grob *me)
-{
-  Direction d = get_grob_direction (me);
-
-  if (!d)
-    {
-      d = get_default_dir (me);
-      // urg, AAARGH!
-      set_grob_direction (me, d);
-    }
-  return d;
-}
 
 void
 Stem::set_stemend (Grob *me, Real se)
 {
   // todo: margins
-  Direction d = get_direction (me);
+  Direction d = get_grob_direction (me);
 
-  if (d && d * head_positions (me)[get_direction (me)] >= se * d)
+  if (d && d * head_positions (me)[get_grob_direction (me)] >= se * d)
     me->warning (_ ("weird stem size, check for narrow beams"));
 
   me->set_property ("stem-end-position", scm_from_double (se));
@@ -134,7 +107,7 @@ Stem::support_head (Grob *me)
   extract_grob_set (me, "note-heads", heads);
   if (heads.size () == 1)
     return heads[0];
-  
+
   return first_head (me);
 }
 
@@ -149,7 +122,7 @@ Stem::head_count (Grob *me)
 Grob *
 Stem::first_head (Grob *me)
 {
-  Direction d = get_direction (me);
+  Direction d = get_grob_direction (me);
   if (d)
     return extremal_heads (me)[-d];
   return 0;
@@ -159,7 +132,7 @@ Stem::first_head (Grob *me)
 Grob *
 Stem::last_head (Grob *me)
 {
-  Direction d = get_direction (me);
+  Direction d = get_grob_direction (me);
   if (d)
     return extremal_heads (me)[d];
   return 0;
@@ -180,7 +153,7 @@ Stem::extremal_heads (Grob *me)
 
   Drul_array<Grob *> exthead (0, 0);
   extract_grob_set (me, "note-heads", heads);
-  
+
   for (int i = heads.size (); i--;)
     {
       Grob *n = heads[i];
@@ -212,7 +185,7 @@ Stem::note_head_positions (Grob *me)
 {
   Array<int> ps;
   extract_grob_set (me, "note-heads", heads);
-  
+
   for (int i = heads.size (); i--;)
     {
       Grob *n = heads[i];
@@ -229,7 +202,6 @@ void
 Stem::add_head (Grob *me, Grob *n)
 {
   n->set_object ("stem", me->self_scm ());
-  n->add_dependency (me);
 
   if (Note_head::has_interface (n))
     Pointer_group_interface::add_grob (me, ly_symbol2scm ("note-heads"), n);
@@ -248,58 +220,93 @@ Stem::is_invisible (Grob *me)
           && scm_to_int (me->get_property ("duration-log")) >= 1);
 }
 
-Direction
-Stem::get_default_dir (Grob *me)
+MAKE_SCHEME_CALLBACK (Stem, calc_stem_end_position, 1)
+SCM
+Stem::calc_stem_end_position (SCM smob)
 {
-  int staff_center = 0;
+  Grob *me = unsmob_grob (smob);
+
+  if (!head_count (me))
+    return scm_from_double (0.0);
+
+  
+  Real ss = Staff_symbol_referencer::staff_space (me);
+  int durlog = duration_log (me);
+  Array<Real> a;
+
+  /* WARNING: IN HALF SPACES */
+  Real length = robust_scm2double (me->get_property ("length"), 7);
+
+  Direction dir = get_grob_direction (me);
   Interval hp = head_positions (me);
-  if (hp.is_empty ())
-    return CENTER;
+  Real stem_end = dir ? hp[dir] + dir * length : 0;
+
+  /* TODO: change name  to extend-stems to staff/center/'()  */
+  bool no_extend_b = to_boolean (me->get_property ("no-stem-extend"));
+  if (!no_extend_b && dir * stem_end < 0)
+    stem_end = 0.0;
+
+  
+  /* Make a little room if we have a upflag and there is a dot.
+     previous approach was to lengthen the stem. This is not
+     good typesetting practice.  */
+  if (!get_beam (me) && dir == UP
+      && durlog > 2)
+    {
+      Grob *closest_to_flag = extremal_heads (me)[dir];
+      Grob *dots = closest_to_flag
+       ? Rhythmic_head::get_dots (closest_to_flag) : 0;
+
+      if (dots)
+       {
+         Real dp = Staff_symbol_referencer::get_position (dots);
+         Real flagy = flag (me).extent (Y_AXIS)[-dir] * 2 / ss;
 
-  int udistance = (int) (UP *hp[UP] - staff_center);
-  int ddistance = (int) (DOWN *hp[DOWN] - staff_center);
+         /* Very gory: add myself to the X-support of the parent,
+            which should be a dot-column. */
+         if (dir * (stem_end + flagy - dp) < 0.5)
+           {
+             Grob *par = dots->get_parent (X_AXIS);
 
-  if (sign (ddistance - udistance))
-    return Direction (sign (ddistance - udistance));
+             if (Dot_column::has_interface (par))
+               {
+                 Side_position_interface::add_support (par, me);
+
+                 /* TODO: apply some better logic here. The flag is
+                    curved inwards, so this will typically be too
+                    much. */
+               }
+           }
+       }
+    }
 
-  return to_dir (me->get_property ("neutral-direction"));
+  return scm_from_double (stem_end);
 }
 
-Real
-Stem::get_default_stem_end_position (Grob *me)
+
+MAKE_SCHEME_CALLBACK (Stem, calc_length, 1)
+SCM
+Stem::calc_length (SCM smob)
 {
-  Real ss = Staff_symbol_referencer::staff_space (me);
+  Grob *me = unsmob_grob (smob);
+  
+  SCM details = me->get_property ("details");
   int durlog = duration_log (me);
-  SCM s;
-  Array<Real> a;
 
-  /* WARNING: IN HALF SPACES */
+  Real ss = Staff_symbol_referencer::staff_space (me);
   Real length = 7;
-  SCM scm_len = me->get_property ("length");
-  if (scm_is_number (scm_len))
-    length = scm_to_double (scm_len);
-  else
-    {
-      s = me->get_property ("lengths");
-      if (scm_is_pair (s))
-       length = 2 * scm_to_double (robust_list_ref (durlog - 2, s));
-    }
+  SCM s = scm_cdr (scm_assq (ly_symbol2scm ("lengths"), details));
+  if (scm_is_pair (s))
+    length = 2 * scm_to_double (robust_list_ref (durlog - 2, s));
 
-  /* URGURGURG
-     'set-default-stemlen' sets direction too.   */
-  Direction dir = get_direction (me);
-  if (!dir)
-    {
-      dir = get_default_dir (me);
-      set_grob_direction (me, dir);
-    }
+  Direction dir = get_grob_direction (me);
 
   /* Stems in unnatural (forced) direction should be shortened,
      according to [Roush & Gourlay] */
   Interval hp = head_positions (me);
   if (dir && dir * hp[dir] >= 0)
     {
-      SCM sshorten = me->get_property ("stem-shorten");
+      SCM sshorten = scm_cdr (scm_assq (ly_symbol2scm ("stem-shorten"), details));
       SCM scm_shorten = scm_is_pair (sshorten)
        ? robust_list_ref (max (duration_log (me) - 2, 0), sshorten) : SCM_EOL;
       Real shorten = 2* robust_scm2double (scm_shorten, 0);
@@ -311,6 +318,8 @@ Stem::get_default_stem_end_position (Grob *me)
       length -= shorten;
     }
 
+  length *= robust_scm2double (me->get_property ("length-fraction"), 1.0);
+
   /* Tremolo stuff.  */
   Grob *t_flag = unsmob_grob (me->get_object ("tremolo-flag"));
   if (t_flag && !unsmob_grob (me->get_object ("beam")))
@@ -337,49 +346,9 @@ Stem::get_default_stem_end_position (Grob *me)
        }
       length = max (length, minlen + 1.0);
     }
-
-  Real st = dir ? hp[dir] + dir * length : 0;
-
-  /* TODO: change name  to extend-stems to staff/center/'()  */
-  bool no_extend_b = to_boolean (me->get_property ("no-stem-extend"));
-  if (!no_extend_b && dir * st < 0)
-    st = 0.0;
-
-  /* Make a little room if we have a upflag and there is a dot.
-     previous approach was to lengthen the stem. This is not
-     good typesetting practice.  */
-  if (!get_beam (me) && dir == UP
-      && durlog > 2)
-    {
-      Grob *closest_to_flag = extremal_heads (me)[dir];
-      Grob *dots = closest_to_flag
-       ? Rhythmic_head::get_dots (closest_to_flag) : 0;
-
-      if (dots)
-       {
-         Real dp = Staff_symbol_referencer::get_position (dots);
-         Real flagy = flag (me).extent (Y_AXIS)[-dir] * 2 / ss;
-
-         /* Very gory: add myself to the X-support of the parent,
-            which should be a dot-column. */
-         if (dir * (st + flagy - dp) < 0.5)
-           {
-             Grob *par = dots->get_parent (X_AXIS);
-
-             if (Dot_column::has_interface (par))
-               {
-                 Side_position_interface::add_support (par, me);
-
-                 /* TODO: apply some better logic here. The flag is
-                    curved inwards, so this will typically be too
-                    much. */
-               }
-           }
-       }
-    }
-  return st;
+  
+  return scm_from_double (length);
 }
-
 /* The log of the duration (Number of hooks on the flag minus two)  */
 int
 Stem::duration_log (Grob *me)
@@ -388,16 +357,18 @@ Stem::duration_log (Grob *me)
   return (scm_is_number (s)) ? scm_to_int (s) : 2;
 }
 
-void
-Stem::position_noteheads (Grob *me)
+MAKE_SCHEME_CALLBACK(Stem, calc_positioning_done, 1);
+SCM
+Stem::calc_positioning_done (SCM smob)
 {
+  Grob *me = unsmob_grob (smob);  
   if (!head_count (me))
-    return;
+    return SCM_BOOL_T;
 
   extract_grob_set (me, "note-heads", ro_heads);
   Link_array<Grob> heads (ro_heads);
   heads.sort (compare_position);
-  Direction dir = get_direction (me);
+  Direction dir = get_grob_direction (me);
 
   if (dir < 0)
     heads.reverse ();
@@ -405,6 +376,13 @@ Stem::position_noteheads (Grob *me)
   Real thick = thickness (me);
 
   Grob *hed = support_head (me);
+  if (!dir)
+    {
+      programming_error ("Stem dir must be up or down.");
+      dir = UP;
+      set_grob_direction (me, dir);
+    }
+  
   Real w = hed->extent (hed, X_AXIS)[dir];
   for (int i = 0; i < heads.size (); i++)
     heads[i]->translate_axis (w - heads[i]->extent (heads[i], X_AXIS)[dir],
@@ -427,7 +405,7 @@ Stem::position_noteheads (Grob *me)
            {
              Real ell = heads[i]->extent (heads[i], X_AXIS).length ();
 
-             Direction d = get_direction (me);
+             Direction d = get_grob_direction (me);
              /*
                Reversed head should be shifted ell-thickness, but this
                looks too crowded, so we only shift ell-0.5*thickness.
@@ -466,73 +444,109 @@ Stem::position_noteheads (Grob *me)
 
       lastpos = int (p);
     }
+
+  return SCM_BOOL_T;
 }
 
-MAKE_SCHEME_CALLBACK (Stem, before_line_breaking, 1);
+MAKE_SCHEME_CALLBACK(Stem, calc_direction, 1);
 SCM
-Stem::before_line_breaking (SCM smob)
+Stem::calc_direction (SCM smob)
 {
   Grob *me = unsmob_grob (smob);
-
-  /*
-    Do the calculations for visible stems, but also for invisible stems
-    with note heads (i.e. half notes.)
-  */
-  if (head_count (me))
+  Direction dir = CENTER;
+  if (Grob *beam = unsmob_grob (me->get_object ("beam")))
     {
-      stem_end_position (me);  // ugh. Trigger direction calc.
-      position_noteheads (me);
+      SCM ignore_me = beam->get_property ("direction");
+      (void) ignore_me;
+      dir = get_grob_direction (me);
     }
+  else
+    {
+      SCM dd = me->get_property ("default-direction");
+      dir = to_dir (dd);
+      if (!dir)
+       return me->get_property ("neutral-direction");
+    }
+  
+  return scm_from_int (dir);
+}
+
+MAKE_SCHEME_CALLBACK(Stem, calc_default_direction, 1);
+SCM
+Stem::calc_default_direction (SCM smob)
+{
+  Grob *me = unsmob_grob (smob);
 
-  return SCM_UNSPECIFIED;
+  Direction dir = CENTER;
+  int staff_center = 0;
+  Interval hp = head_positions (me);
+  if (!hp.is_empty ())
+    {
+      int udistance = (int) (UP * hp[UP] - staff_center);
+      int ddistance = (int) (DOWN * hp[DOWN] - staff_center);
+      
+      dir = Direction (sign (ddistance - udistance));
+    }
+  
+  return scm_from_int (dir);
 }
 
-/*
-  ugh.
-  When in a beam with tuplet brackets, brew_mol is called early,
-  caching a wrong value.
-*/
-MAKE_SCHEME_CALLBACK (Stem, height, 2);
+
+MAKE_SCHEME_CALLBACK (Stem, height, 1);
 SCM
-Stem::height (SCM smob, SCM ax)
+Stem::height (SCM smob)
 {
-  Axis a = (Axis)scm_to_int (ax);
   Grob *me = unsmob_grob (smob);
-  assert (a == Y_AXIS);
 
-  /*
-    ugh. - this dependency should be automatic.
+  Direction dir = get_grob_direction (me);
+  
+  /* Trigger callback.
+
+  UGH. Should be automatic
   */
   Grob *beam = get_beam (me);
   if (beam)
     {
-      Beam::after_line_breaking (beam->self_scm ());
+      beam->get_property ("positions");
     }
 
-  SCM mol = me->get_uncached_stencil ();
-  Interval iv;
-  if (mol != SCM_EOL)
-    iv = unsmob_stencil (mol)->extent (a);
-  if (Grob *b = get_beam (me))
+  /*
+    Can't get_stencil(), since that would cache stencils too early.
+    This causes problems with beams.
+   */
+  Stencil *stencil = unsmob_stencil (print (smob));
+  Interval iv = stencil ? stencil->extent (Y_AXIS) : Interval();
+  if (beam)
     {
-      Direction d = get_direction (me);
-      if (d == CENTER)
+      if (dir == CENTER)
        {
          programming_error ("no stem direction");
-         d = UP;
+         dir = UP;
        }
-      iv[d] += d * Beam::get_thickness (b) * 0.5;
+      iv[dir] += dir * Beam::get_thickness (beam) * 0.5;
     }
 
   return ly_interval2scm (iv);
 }
 
+Real
+Stem::stem_end_position (Grob *me)
+{
+  return robust_scm2double (me->get_property ("stem-end-position"), 0);
+}
+
 Stencil
 Stem::flag (Grob *me)
 {
-  /* TODO: maybe property stroke-style should take different values,
-     e.g. "" (i.e. no stroke), "single" and "double" (currently, it's
-     '() or "grace").  */
+  int log = duration_log (me);
+  if (log < 3
+      || unsmob_grob (me->get_object ("beam")))
+    return Stencil ();
+
+  /*
+    TODO: maybe property stroke-style should take different values,
+    e.g. "" (i.e. no stroke), "single" and "double" (currently, it's
+    '() or "grace").  */
   String flag_style;
 
   SCM flag_style_scm = me->get_property ("flag-style");
@@ -558,21 +572,17 @@ Stem::flag (Grob *me)
        {
          int p = (int) (rint (stem_end_position (me)));
          staffline_offs
-           = Staff_symbol_referencer::on_staffline (me, p) ? "0" : "1";
+           = Staff_symbol_referencer::on_line (me, p) ? "0" : "1";
        }
       else
-       {
-         staffline_offs = "2";
-       }
+       staffline_offs = "2";
     }
   else
-    {
-      staffline_offs = "";
-    }
+    staffline_offs = "";
 
-  char dir = (get_direction (me) == UP) ? 'u' : 'd';
+  char dir = (get_grob_direction (me) == UP) ? 'u' : 'd';
   String font_char = flag_style
-    + to_string (dir) + staffline_offs + to_string (duration_log (me));
+    + to_string (dir) + staffline_offs + to_string (log);
   Font_metric *fm = Font_interface::get_default_font (me);
   Stencil flag = fm->find_by_name ("flags." + font_char);
   if (flag.is_empty ())
@@ -582,7 +592,7 @@ Stem::flag (Grob *me)
   if (scm_is_string (stroke_style_scm))
     {
       String stroke_style = ly_scm2string (stroke_style_scm);
-      if (!stroke_style.is_empty ())
+      if (!stroke_style.empty ())
        {
          String font_char = to_string (dir) + stroke_style;
          Stencil stroke = fm->find_by_name ("flags." + font_char);
@@ -596,28 +606,25 @@ Stem::flag (Grob *me)
   return flag;
 }
 
-MAKE_SCHEME_CALLBACK (Stem, width_callback, 2);
+MAKE_SCHEME_CALLBACK (Stem, width, 1);
 SCM
-Stem::width_callback (SCM e, SCM ax)
+Stem::width (SCM e)
 {
-  (void) ax;
-  assert (scm_to_int (ax) == X_AXIS);
   Grob *me = unsmob_grob (e);
 
   Interval r;
 
   if (is_invisible (me))
-    {
-      r.set_empty ();
-    }
-  else if (unsmob_grob (me->get_object ("beam")) || abs (duration_log (me)) <= 2)
+    r.set_empty ();
+  else if (unsmob_grob (me->get_object ("beam"))
+          || abs (duration_log (me)) <= 2)
     {
       r = Interval (-1, 1);
       r *= thickness (me) / 2;
     }
   else
     {
-      r = Interval (-1,1) * thickness (me) * 0.5;
+      r = Interval (-1, 1) * thickness (me) * 0.5;
       r.unite (flag (me).extent (X_AXIS));
     }
   return ly_interval2scm (r);
@@ -636,7 +643,7 @@ Stem::print (SCM smob)
 {
   Grob *me = unsmob_grob (smob);
   Stencil mol;
-  Direction d = get_direction (me);
+  Direction d = get_grob_direction (me);
 
   Real stemlet_length = robust_scm2double (me->get_property ("stemlet-length"),
                                           0.0);
@@ -659,7 +666,7 @@ Stem::print (SCM smob)
   if (is_invisible (me))
     return SCM_EOL;
 
-  Real y2 = stem_end_position (me);
+  Real y2 = robust_scm2double (me->get_property ("stem-end-position"), 0.0);
   Real y1 = y2;
   Real half_space = Staff_symbol_referencer::staff_space (me) * 0.5;
 
@@ -679,13 +686,13 @@ Stem::print (SCM smob)
 
   Interval stem_y (min (y1, y2), max (y2, y1));
 
-  if (Grob *hed = support_head (me))
+  if (Grob *head = support_head (me))
     {
       /*
        must not take ledgers into account.
       */
-      Interval head_height = hed->extent (hed, Y_AXIS);
-      Real y_attach = Note_head::stem_attachment_coordinate (hed, Y_AXIS);
+      Interval head_height = head->extent (head, Y_AXIS);
+      Real y_attach = Note_head::stem_attachment_coordinate (head, Y_AXIS);
 
       y_attach = head_height.linear_combination (y_attach);
       stem_y[Direction (-d)] += d * y_attach / half_space;
@@ -694,7 +701,7 @@ Stem::print (SCM smob)
   // URG
   Real stem_width = thickness (me);
   Real blot
-    = me->get_layout ()->get_dimension (ly_symbol2scm ("blotdiameter"));
+    = me->layout ()->get_dimension (ly_symbol2scm ("blotdiameter"));
 
   Box b = Box (Interval (-stem_width / 2, stem_width / 2),
               Interval (stem_y[DOWN] * half_space, stem_y[UP] * half_space));
@@ -702,25 +709,38 @@ Stem::print (SCM smob)
   Stencil ss = Lookup::round_filled_box (b, blot);
   mol.add_stencil (ss);
 
-  if (!get_beam (me) && abs (duration_log (me)) > 2)
+  mol.add_stencil (get_translated_flag (me));
+
+  return mol.smobbed_copy ();
+}
+
+Stencil
+Stem::get_translated_flag (Grob *me)
+{
+  Stencil fl = flag (me);
+  if (!fl.is_empty ())
     {
-      Stencil fl = flag (me);
-      fl.translate_axis (stem_y[d] * half_space - d * blot / 2, Y_AXIS);
+      Direction d = get_grob_direction (me);
+      Real blot
+       = me->layout ()->get_dimension (ly_symbol2scm ("blotdiameter"));
+      Real stem_width = thickness (me);
+      Real half_space = Staff_symbol_referencer::staff_space (me) * 0.5;
+      Real y2 = robust_scm2double (me->get_property ("stem-end-position"), 0.0);
+      fl.translate_axis (y2 * half_space - d * blot / 2, Y_AXIS);
       fl.translate_axis (stem_width / 2, X_AXIS);
-      mol.add_stencil (fl);
     }
-
-  return mol.smobbed_copy ();
+  return fl;
 }
 
+
 /*
   move the stem to right of the notehead if it is up.
 */
-MAKE_SCHEME_CALLBACK (Stem, offset_callback, 2);
+MAKE_SCHEME_CALLBACK (Stem, offset_callback, 1);
 SCM
-Stem::offset_callback (SCM element_smob, SCM)
+Stem::offset_callback (SCM smob)
 {
-  Grob *me = unsmob_grob (element_smob);
+  Grob *me = unsmob_grob (smob);
   Real r = 0.0;
 
   if (Grob *f = first_head (me))
@@ -733,7 +753,7 @@ Stem::offset_callback (SCM element_smob, SCM)
       else
        attach = Note_head::stem_attachment_coordinate (f, X_AXIS);
 
-      Direction d = get_direction (me);
+      Direction d = get_grob_direction (me);
       Real real_attach = head_wid.linear_combination (d * attach);
       r = real_attach;
 
@@ -766,25 +786,21 @@ Stem::get_beam (Grob *me)
 Stem_info
 Stem::get_stem_info (Grob *me)
 {
-  /* Return cached info if available */
-  SCM scm_info = me->get_property ("stem-info");
-  if (!scm_is_pair (scm_info))
-    {
-      calc_stem_info (me);
-      scm_info = me->get_property ("stem-info");
-    }
-
   Stem_info si;
   si.dir_ = get_grob_direction (me);
+  
+  SCM scm_info = me->get_property ("stem-info");
   si.ideal_y_ = scm_to_double (scm_car (scm_info));
   si.shortest_y_ = scm_to_double (scm_cadr (scm_info));
   return si;
 }
 
 /* TODO: add extra space for tremolos!  */
-void
-Stem::calc_stem_info (Grob *me)
+MAKE_SCHEME_CALLBACK(Stem, calc_stem_info, 1);
+SCM
+Stem::calc_stem_info (SCM smob)
 {
+  Grob *me = unsmob_grob (smob);
   Direction my_dir = get_grob_direction (me);
 
   if (!my_dir)
@@ -795,25 +811,38 @@ Stem::calc_stem_info (Grob *me)
 
   Real staff_space = Staff_symbol_referencer::staff_space (me);
   Grob *beam = get_beam (me);
+
+  if (beam)
+    {
+      (void) beam->get_property ("beaming");
+    }
+  
   Real beam_translation = Beam::get_beam_translation (beam);
   Real beam_thickness = Beam::get_thickness (beam);
   int beam_count = Beam::get_direction_beam_count (beam, my_dir);
+  Real length_fraction
+    = robust_scm2double (me->get_property ("length-fraction"), 1.0);
 
   /* Simple standard stem length */
-  SCM lengths = me->get_property ("beamed-lengths");
+  SCM details = me->get_property ("details");
+  SCM lengths = scm_cdr (scm_assq (ly_symbol2scm ("beamed-lengths"), details));
+  
   Real ideal_length
     = scm_to_double (robust_list_ref (beam_count - 1, lengths))
-
     * staff_space
+    * length_fraction
+    
     /* stem only extends to center of beam
      */
     - 0.5 * beam_thickness;
 
   /* Condition: sane minimum free stem length (chord to beams) */
-  lengths = me->get_property ("beamed-minimum-free-lengths");
+  lengths = scm_cdr (scm_assq (ly_symbol2scm ("beamed-minimum-free-lengths"), details));
+
   Real ideal_minimum_free
     = scm_to_double (robust_list_ref (beam_count - 1, lengths))
-    * staff_space;
+    * staff_space
+    * length_fraction;
 
   /* UGH
      It seems that also for ideal minimum length, we must use
@@ -868,12 +897,13 @@ Stem::calc_stem_info (Grob *me)
 
   ideal_y -= robust_scm2double (beam->get_property ("shorten"), 0);
 
+  SCM bemfl = scm_cdr (scm_assq (ly_symbol2scm ("beamed-extreme-minimum-free-lengths"),
+                                details));
+  
   Real minimum_free
-    = scm_to_double (robust_list_ref
-                    (beam_count - 1,
-                     me->get_property
-                     ("beamed-extreme-minimum-free-lengths")))
-    * staff_space;
+    = scm_to_double (robust_list_ref (beam_count - 1, bemfl))
+    * staff_space
+    * length_fraction;
 
   Real minimum_length = minimum_free
     + height_of_my_beams
@@ -886,14 +916,13 @@ Stem::calc_stem_info (Grob *me)
       y_ext.widen (0.5);       // FIXME. Should be tunable? 
       minimum_length = max (minimum_length, y_ext.length ());
     }
-  
+
   ideal_y *= my_dir;
   Real minimum_y = note_start + minimum_length;
   Real shortest_y = minimum_y * my_dir;
 
-  me->set_property ("stem-info",
-                   scm_list_2 (scm_from_double (ideal_y),
-                               scm_from_double (shortest_y)));
+  return scm_list_2 (scm_from_double (ideal_y),
+                    scm_from_double (shortest_y));
 }
 
 Slice
@@ -911,15 +940,49 @@ ADD_INTERFACE (Stem, "stem-interface",
               "The stem represent the graphical stem.  "
               "In addition, it internally connects note heads, beams and"
               "tremolos. "
-              "Rests and whole notes have invisible stems.",
-              "tremolo-flag french-beaming "
-              "avoid-note-head thickness "
-              "stemlet-length rests "
-              "stem-info beamed-lengths beamed-minimum-free-lengths "
-              "beamed-extreme-minimum-free-lengths lengths beam stem-shorten "
-              "duration-log beaming neutral-direction stem-end-position "
-              "note-heads direction length flag-style "
-              "no-stem-extend stroke-style");
+              "Rests and whole notes have invisible stems."
+
+              "\n\nThe following properties may be set in the details list." 
+              "@table @code\n"
+              "@item  beamed-lengths \n"
+              "list of stem lengths given beam multiplicity. \n"
+              "@item beamed-minimum-free-lengths \n"
+              "list of normal minimum free stem lengths (chord to beams) given beam multiplicity.\n"
+              "@item beamed-extreme-minimum-free-lengths\n"
+              "list of extreme minimum free stem lengths (chord to beams) given beam multiplicity.\n"
+              "@item lengths\n"
+              "Default stem lengths. The list gives a length for each flag-count.\n"
+              "@item stem-shorten\n"
+              "How much a stem in a forced direction "
+              "should be shortened. The list gives an amount depending on the number "
+              "of flags/beams."
+              "@end table\n"
+              ,
+
+              /* properties */
+              "avoid-note-head "
+              "beam "
+              "beaming "
+              "default-direction "
+              "details "
+              "direction "
+              "duration-log "
+              "flag-style "
+              "french-beaming "
+              "length "
+              "length-fraction "
+              "neutral-direction "
+              "no-stem-extend "
+              "note-heads "
+              "positioning-done "
+              "rests "
+              "stem-end-position "
+              "stem-info "
+              "stemlet-length "
+              "stroke-style "
+              "thickness "
+              "tremolo-flag "
+              );
 
 /****************************************************************/