]> git.donarmstrong.com Git - lilypond.git/blobdiff - lily/lookup.cc
doc patch by Graham Percival
[lilypond.git] / lily / lookup.cc
index 40af656ee39e06c0b55361966a02d799a869e349..e12dd064ff8f00ff5e38ad54a379eae090f36fa4 100644 (file)
@@ -3,7 +3,7 @@
 
   source file of the GNU LilyPond music typesetter
 
-  (c)  1997--2001 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+  (c)  1997--2002 Han-Wen Nienhuys <hanwen@cs.uu.nl>
 
   Jan Nieuwenhuizen <janneke@gnu.org>
 
@@ -45,8 +45,6 @@ Lookup::beam (Real slope, Real width, Real thick)
   return Molecule (b, at);
 }
 
-
-
 Molecule
 Lookup::dashed_slur (Bezier b, Real thick, Real dash)
 {
@@ -67,7 +65,26 @@ Lookup::dashed_slur (Bezier b, Real thick, Real dash)
   return   Molecule (box, at);
 }
 
-
+Molecule
+Lookup::line (Real th, Offset f, Offset t)
+{
+  SCM at = (scm_list_n (ly_symbol2scm ("draw-line"),
+                       gh_double2scm (th), 
+                       gh_double2scm (f[X_AXIS]),
+                       gh_double2scm (f[Y_AXIS]),
+                       gh_double2scm (t[X_AXIS]),
+                       gh_double2scm (t[Y_AXIS]),
+                       SCM_UNDEFINED));
+
+  Box box;
+  box.add_point (f);
+  box.add_point (t);
+
+  box[X_AXIS].widen (th/2);
+  box[Y_AXIS].widen (th/2);  
+
+  return Molecule (box, at);
+}
 
 
 Molecule
@@ -76,7 +93,6 @@ Lookup::blank (Box b)
   return Molecule (b, SCM_EOL);
 }
 
-
 Molecule
 Lookup::filledbox (Box b) 
 {
@@ -90,6 +106,58 @@ Lookup::filledbox (Box b)
   return Molecule (b,at);
 }
 
+/*
+ * round filled box:
+ *
+ *   __________________________________
+ *  /     \  ^           /     \      ^
+ * |         |blot              |     |
+ * |       | |dia       |       |     |
+ * |         |meter             |     |
+ * |\ _ _ /  v           \ _ _ /|     |
+ * |                            |     |
+ * |                            |     | Box
+ * |                    <------>|     | extent
+ * |                      blot  |     | (Y_AXIS)
+ * |                    diameter|     |
+ * |                            |     |
+ * |  _ _                  _ _  |     |
+ * |/     \              /     \|     |
+ * |                            |     |
+ * |       |            |       |     |
+ * |                            |     |
+ * x\_____/______________\_____/|_____v
+ * |(0,0)                       |
+ * |                            |
+ * |                            |
+ * |<-------------------------->|
+ *       Box extent(X_AXIS)
+ */
+Molecule
+Lookup::roundfilledbox (Box b, Real blotdiameter)
+{
+  if (b.x ().length () < blotdiameter)
+    {
+      programming_error (_f ("round filled box horizontal extent smaller than blot; decreasing blot"));
+      blotdiameter = b.x ().length ();
+    }
+  if (b.y ().length () < blotdiameter)
+    {
+      programming_error (_f ("round filled box vertical extent smaller than blot; decreasing blot"));
+      blotdiameter = b.y ().length ();
+    }
+
+  SCM at = (scm_list_n (ly_symbol2scm ("roundfilledbox"),
+                       gh_double2scm (-b[X_AXIS][LEFT]),
+                       gh_double2scm (b[X_AXIS][RIGHT]),
+                       gh_double2scm (-b[Y_AXIS][DOWN]),
+                       gh_double2scm (b[Y_AXIS][UP]),
+                       gh_double2scm (blotdiameter),
+                       SCM_UNDEFINED));
+
+  return Molecule (b,at);
+}
+
 Molecule
 Lookup::frame (Box b, Real thick)
 {
@@ -107,7 +175,6 @@ Lookup::frame (Box b, Real thick)
          edges[o][DOWN] = b[o][DOWN] - thick/2;
          edges[o][UP] = b[o][UP] + thick/2;      
          
-         
          m.add_molecule (filledbox (edges));
        }
       while (flip (&d) != LEFT);
@@ -116,7 +183,6 @@ Lookup::frame (Box b, Real thick)
   
 }
 
-
 /*
   Make a smooth curve along the points 
  */
@@ -151,7 +217,7 @@ Lookup::slur (Bezier curve, Real curvethick, Real linethick)
     }
   
   
-  SCM at = (scm_list_n (ly_symbol2scm ("bezier-sandwich"),
+  SCM at = (scm_list_n (ly_symbol2scm ("bezier-bow"),
                     ly_quote_scm (list),
                     gh_double2scm (linethick),
                     SCM_UNDEFINED));
@@ -164,6 +230,93 @@ Lookup::slur (Bezier curve, Real curvethick, Real linethick)
   return Molecule (b, at);
 }
 
+/*
+ * Bezier Sandwich:
+ *
+ *                               .|
+ *                        .       |
+ *              top .             |
+ *              . curve           |
+ *          .                     |
+ *       .                        |
+ *     .                          |
+ *    |                           |
+ *    |                          .|
+ *    |                     .
+ *    |         bottom .
+ *    |            . curve
+ *    |         .
+ *    |      .
+ *    |   .
+ *    | .
+ *    |.
+ *    |
+ *
+ */
+Molecule
+Lookup::bezier_sandwich (Bezier top_curve, Bezier bottom_curve)
+{
+  /*
+    Need the weird order b.o. the way PS want its arguments  
+   */
+  SCM list = SCM_EOL;
+  list = gh_cons (ly_offset2scm (bottom_curve.control_[3]), list);
+  list = gh_cons (ly_offset2scm (bottom_curve.control_[0]), list);
+  list = gh_cons (ly_offset2scm (bottom_curve.control_[1]), list);
+  list = gh_cons (ly_offset2scm (bottom_curve.control_[2]), list);
+  list = gh_cons (ly_offset2scm (top_curve.control_[0]), list);
+  list = gh_cons (ly_offset2scm (top_curve.control_[3]), list);
+  list = gh_cons (ly_offset2scm (top_curve.control_[2]), list);
+  list = gh_cons (ly_offset2scm (top_curve.control_[1]), list);
+
+  SCM horizontal_bend = scm_list_n (ly_symbol2scm ("bezier-sandwich"),
+                                   ly_quote_scm (list),
+                                   gh_double2scm (0.0),
+                                   SCM_UNDEFINED);
+
+  Interval x_extent = top_curve.extent (X_AXIS);
+  x_extent.unite (bottom_curve.extent (X_AXIS));
+  Interval y_extent = top_curve.extent (Y_AXIS);
+  y_extent.unite (bottom_curve.extent (Y_AXIS));
+  Box b (x_extent, y_extent);
+
+  return Molecule (b, horizontal_bend);
+}
+
+/*
+ * Horizontal Slope:
+ *
+ *            /|   ^
+ *           / |   |
+ *          /  |   | height
+ *         /   |   |
+ *        /    |   v
+ *       |    /
+ *       |   /
+ * (0,0) x  /slope=dy/dx
+ *       | /
+ *       |/
+ *
+ *       <----->
+ *        width
+ */
+Molecule
+Lookup::horizontal_slope (Real width, Real slope, Real height)
+{
+  SCM width_scm = gh_double2scm (width);
+  SCM slope_scm = gh_double2scm (slope);
+  SCM height_scm = gh_double2scm (height);
+  SCM horizontal_slope = scm_list_n (ly_symbol2scm ("beam"),
+                                    width_scm, slope_scm,
+                                    height_scm, SCM_UNDEFINED);
+  Box b (Interval (0, width),
+        Interval (-height/2, height/2 + width*slope));
+  return Molecule (b, horizontal_slope);
+}
+
+/*
+  TODO: junk me.
+ */
 Molecule
 Lookup::accordion (SCM s, Real staff_space, Font_metric *fm) 
 {
@@ -175,33 +328,33 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
     {
       Molecule r = fm->find_by_name ("accordion-accDiscant");
       m.add_molecule (r);
-      if (reg.left_str (1) == "F")
+      if (reg.left_string (1) == "F")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 2.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
       int eflag = 0x00;
-      if (reg.left_str (3) == "EEE")
+      if (reg.left_string (3) == "EEE")
        {
          eflag = 0x07;
-         reg = reg.right_str (reg.length_i ()-3);
+         reg = reg.right_string (reg.length ()-3);
        }
-      else if (reg.left_str (2) == "EE")
+      else if (reg.left_string (2) == "EE")
        {
          eflag = 0x05;
-         reg = reg.right_str (reg.length_i ()-2);
+         reg = reg.right_string (reg.length ()-2);
        }
-      else if (reg.left_str (2) == "Eh")
+      else if (reg.left_string (2) == "Eh")
        {
          eflag = 0x04;
-         reg = reg.right_str (reg.length_i ()-2);
+         reg = reg.right_string (reg.length ()-2);
        }
-      else if (reg.left_str (1) == "E")
+      else if (reg.left_string (1) == "E")
        {
          eflag = 0x02;
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
       if (eflag & 0x02)
        {
@@ -223,7 +376,7 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
          d.translate_axis (-0.8 * staff_space PT, X_AXIS);
          m.add_molecule (d);
        }
-      if (reg.left_str (2) == "SS")
+      if (reg.left_string (2) == "SS")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (0.5 * staff_space PT, Y_AXIS);
@@ -231,26 +384,26 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
          m.add_molecule (d);
          d.translate_axis (-0.8 * staff_space PT, X_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-2);
+         reg = reg.right_string (reg.length ()-2);
        }
-      if (reg.left_str (1) == "S")
+      if (reg.left_string (1) == "S")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (0.5 * staff_space PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
     }
   else if (sym == "Freebase")
     {
       Molecule r = fm->find_by_name ("accordion-accFreebase");
       m.add_molecule (r);
-      if (reg.left_str (1) == "F")
+      if (reg.left_string (1) == "F")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 1.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
       if (reg == "E")
        {
@@ -263,22 +416,22 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
     {
       Molecule r = fm->find_by_name ("accordion-accBayanbase");
       m.add_molecule (r);
-      if (reg.left_str (1) == "T")
+      if (reg.left_string (1) == "T")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 2.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
       /* include 4' reed just for completeness. You don't want to use this. */
-      if (reg.left_str (1) == "F")
+      if (reg.left_string (1) == "F")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 1.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
-      if (reg.left_str (2) == "EE")
+      if (reg.left_string (2) == "EE")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 0.5 PT, Y_AXIS);
@@ -286,55 +439,55 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
          m.add_molecule (d);
          d.translate_axis (-0.8 * staff_space PT, X_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-2);
+         reg = reg.right_string (reg.length ()-2);
        }
-      if (reg.left_str (1) == "E")
+      if (reg.left_string (1) == "E")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 0.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
     }
   else if (sym == "Stdbase")
     {
       Molecule r = fm->find_by_name ("accordion-accStdbase");
       m.add_molecule (r);
-      if (reg.left_str (1) == "T")
+      if (reg.left_string (1) == "T")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 3.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
-      if (reg.left_str (1) == "F")
+      if (reg.left_string (1) == "F")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 2.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
-      if (reg.left_str (1) == "M")
+      if (reg.left_string (1) == "M")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 2 PT, Y_AXIS);
          d.translate_axis (staff_space PT, X_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
-      if (reg.left_str (1) == "E")
+      if (reg.left_string (1) == "E")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 1.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
-      if (reg.left_str (1) == "S")
+      if (reg.left_string (1) == "S")
        {
          Molecule d = fm->find_by_name ("accordion-accDot");
          d.translate_axis (staff_space * 0.5 PT, Y_AXIS);
          m.add_molecule (d);
-         reg = reg.right_str (reg.length_i ()-1);
+         reg = reg.right_string (reg.length ()-1);
        }
     }
   /* ugh maybe try to use regular font for S.B. and B.B and only use one font
@@ -362,10 +515,6 @@ Lookup::accordion (SCM s, Real staff_space, Font_metric *fm)
   return m;  
 }
 
-/*
-  TODO: should use slope instead?  Angle gives nasty rad <-> degree
-  conversions.
-*/
 Molecule
 Lookup::repeat_slash (Real w, Real s, Real t)
 {
@@ -380,3 +529,46 @@ Lookup::repeat_slash (Real w, Real s, Real t)
 
   return Molecule (b, slashnodot); //  http://slashnodot.org
 }
+
+Molecule
+Lookup::bracket (Axis a, Interval iv, Real thick, Real protude)
+{
+  Box b;
+  Axis other = Axis((a+1)%2);
+  b[a] = iv;
+  b[other] = Interval(-1, 1) * thick * 0.5;
+  
+  Molecule m =  filledbox (b);
+
+  b[a] = Interval (iv[UP] - thick, iv[UP]);
+  Interval oi = Interval (-thick/2, thick/2 + fabs (protude)) ;
+  oi *=  sign (protude);
+  b[other] = oi;
+  m.add_molecule (filledbox (b));
+  b[a] = Interval (iv[DOWN], iv[DOWN]  +thick);
+  m.add_molecule (filledbox(b));
+
+  return m;
+}
+
+/*
+  TODO: use rounded boxes.
+ */
+LY_DEFINE(ly_bracket ,"ly:bracket",
+         4, 0, 0,
+         (SCM a, SCM iv, SCM t, SCM p),
+         "Make a bracket in direction @var{a}. The extent of the bracket is
+given by @var{iv}. The wings protude by an amount of @var{p}, which
+may be negative. The thickness is given by @var{t}.")
+{
+  SCM_ASSERT_TYPE(ly_axis_p (a), a, SCM_ARG1, __FUNCTION__, "axis") ;
+  SCM_ASSERT_TYPE(ly_number_pair_p (iv), iv, SCM_ARG2, __FUNCTION__, "number pair") ;
+  SCM_ASSERT_TYPE(gh_number_p (t), a, SCM_ARG3, __FUNCTION__, "number") ;
+  SCM_ASSERT_TYPE(gh_number_p (p), a, SCM_ARG4, __FUNCTION__, "number") ;
+
+
+  return Lookup::bracket ((Axis)gh_scm2int (a), ly_scm2interval (iv),
+                         gh_scm2double (t),
+                         gh_scm2double (p)).smobbed_copy ();
+}
+