/*
- tie.cc -- implement Tie
+ This file is part of LilyPond, the GNU music typesetter.
- source file of the GNU LilyPond music typesetter
+ Copyright (C) 1997--2015 Han-Wen Nienhuys <hanwen@xs4all.nl>
- (c) 1997--2005 Han-Wen Nienhuys <hanwen@cs.uu.nl>
+ LilyPond is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ LilyPond is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
*/
#include "tie.hh"
-
-#include "spanner.hh"
+#include "main.hh"
+#include "bezier.hh"
+#include "directional-element-interface.hh"
+#include "font-interface.hh"
+#include "grob-array.hh"
#include "lookup.hh"
+#include "note-head.hh"
#include "output-def.hh"
-#include "rhythmic-head.hh"
-#include "bezier.hh"
#include "paper-column.hh"
-#include "warn.hh"
+#include "pointer-group-interface.hh"
+#include "rhythmic-head.hh"
+#include "semi-tie.hh"
+#include "spanner.hh"
#include "staff-symbol-referencer.hh"
-#include "directional-element-interface.hh"
-#include "bezier.hh"
#include "stem.hh"
-#include "note-head.hh"
+#include "text-interface.hh"
#include "tie-column.hh"
+#include "tie-configuration.hh"
+#include "tie-formatting-problem.hh"
+#include "warn.hh"
+#include "semi-tie-column.hh"
-int
-Tie::compare (Grob *const &s1,
- Grob *const &s2)
+bool
+Tie::less (Grob *g1, Grob *g2)
{
- return sign (Tie::get_position (s1) - Tie::get_position (s2));
+ Spanner *s1 = dynamic_cast<Spanner *> (g1);
+ if (!s1)
+ {
+ g1->programming_error ("grob is not a tie");
+ return false;
+ }
+
+ Spanner *s2 = dynamic_cast<Spanner *> (g2);
+ if (!s2)
+ {
+ g2->programming_error ("grob is not a tie");
+ return true;
+ }
+
+ return get_position (s1) < get_position (s2);
}
void
-Tie::set_head (Grob *me, Direction d, Grob *h)
+Tie::set_head (Spanner *me, Direction d, Grob *h)
{
- dynamic_cast<Spanner *> (me)->set_bound (d, h);
- me->add_dependency (h);
+ me->set_bound (d, h);
}
-Grob *
-Tie::head (Grob *me, Direction d)
+Item *
+Tie::head (Spanner *me, Direction d)
{
- Item *it = dynamic_cast<Spanner*> (me)->get_bound (d);
- if (Note_head::has_interface (it))
- return it;
- else
- return 0;
+ Item *it = me->get_bound (d);
+ return has_interface<Note_head> (it) ? it : 0;
}
int
-Tie::get_column_rank (Grob *me, Direction d)
+Tie::get_column_rank (Spanner *me, Direction d)
{
- Spanner *span = dynamic_cast<Spanner *> (me);
- Grob *h = head (me, d);
- if (!h)
- h = span->get_bound (d);
-
- Grob *col = dynamic_cast<Item *> (h)->get_column ();
- return Paper_column::get_rank (col);
+ return Paper_column::get_rank (me->get_bound (d)->get_column ());
}
int
-Tie::get_position (Grob *me)
+Tie::get_position (Spanner *me)
{
- Direction d = head (me, LEFT) ? LEFT : RIGHT;
- return (int) Staff_symbol_referencer::get_position (head (me, d));
+ for (LEFT_and_RIGHT (d))
+ {
+ Grob *h = head (me, d);
+ if (h)
+ return (int) rint (Staff_symbol_referencer::get_position (h));
+ }
+
+ /*
+ TODO: this is theoretically possible for ties across more than 2
+ systems.. We should look at the first broken copy.
+
+ */
+ programming_error ("Tie without heads. Suicide");
+ me->suicide ();
+ return 0;
}
/*
(what about linebreaks? )
*/
Direction
-Tie::get_default_dir (Grob *me)
-{
- Item *sl = head (me, LEFT) ? Rhythmic_head::get_stem (head (me, LEFT)) : 0;
- Item *sr = head (me, RIGHT) ? Rhythmic_head::get_stem (head (me, RIGHT)) : 0;
- if (sl && sr)
- {
- if (get_grob_direction (sl) == UP
- && get_grob_direction (sr) == UP)
- return DOWN;
- }
- else if (sl || sr)
- {
- Item *s = sl ? sl : sr;
- return -get_grob_direction (s);
- }
-
- return UP;
-}
-
-void
-Tie::set_direction (Grob *me)
+Tie::get_default_dir (Spanner *me)
{
- if (!get_grob_direction (me))
+ Drul_array<Grob *> stems;
+ for (LEFT_and_RIGHT (d))
{
- if (Tie_column::has_interface (me->get_parent (Y_AXIS)))
- Tie_column::set_directions (me->get_parent (Y_AXIS));
- else
- set_grob_direction (me, Tie::get_default_dir (me));
- }
-}
+ Grob *one_head = head (me, d);
+ if (!one_head)
+ one_head = head (me->broken_neighbor (d), d);
-Interval
-Tie::get_default_attachments (Spanner *me, Grob *common, Real gap,
- int *staff_position,
- bool *in_between
- )
-{
- Real staff_space = Staff_symbol_referencer::staff_space (me);
- Direction dir = get_grob_direction (me);
- Interval attachments;
- Direction d = LEFT;
- do
- {
- attachments[d]
- = robust_relative_extent (me->get_bound (d),
- common,
- X_AXIS)[-d]
- - gap * d;
+ Grob *stem = one_head ? Rhythmic_head::get_stem (one_head) : 0;
+ stems[d] = (stem && !Stem::is_invisible (stem)) ? stem : 0;
}
- while (flip (&d) != LEFT);
- if (attachments.length () < 0.6 * staff_space)
+ if (stems[LEFT] && stems[RIGHT])
{
- /*
- Let short ties start over note heads, instead of between.
- */
- Drul_array<bool> allow (true, true);
-
- Direction d = LEFT;
- do {
- if (Note_head::has_interface (me->get_bound (d)))
- {
- Grob *stem = unsmob_grob (me->get_bound (d)->get_object ("stem"));
- if (get_grob_direction (stem) == dir
- && -d == dir)
- allow[d] = false;
- }
- } while (flip (&d) != LEFT);
-
- if (allow[LEFT] && allow[RIGHT])
- {
- *staff_position += dir;
- do
- {
- if (Note_head::has_interface (me->get_bound (d)))
- {
- Interval extent
- = robust_relative_extent (me->get_bound (d),
- common, X_AXIS);
-
- attachments[d] = extent.linear_combination (- 0.5 * d);
- *in_between = false;
- }
- }
- while (flip (&d) != LEFT);
- }
- }
+ if (get_grob_direction (stems[LEFT]) == UP
+ && get_grob_direction (stems[RIGHT]) == UP)
+ return DOWN;
- return attachments;
-}
+ // And why not return UP if both stems are DOWN?
-Interval
-get_skyline_attachment (Drul_array< Array < Skyline_entry > > const &skylines,
- Real y)
-{
- Interval attachments;
- Direction d = LEFT;
- do
- {
- attachments[d] = skyline_height (skylines[d], y, -d);
+ // And when stems conflict, why fall directly through to using
+ // neutral-direction without considering get_position (me)?
}
- while (flip (&d) != LEFT);
-
- return attachments;
+ else if (stems[LEFT])
+ return -get_grob_direction (stems[LEFT]);
+ else if (stems[RIGHT])
+ return -get_grob_direction (stems[RIGHT]);
+ else if (int p = get_position (me))
+ return Direction (sign (p));
+
+ return to_dir (me->get_property ("neutral-direction"));
}
-
-void
-Tie::get_configuration (Grob *me_grob, Grob *common,
- Tie_configuration *conf,
- Drul_array< Array < Skyline_entry > > const *skylines,
- Tie_details const &details
- )
+
+MAKE_SCHEME_CALLBACK (Tie, calc_direction, 1);
+SCM
+Tie::calc_direction (SCM smob)
{
- Spanner *me = dynamic_cast<Spanner*> (me_grob);
- if (!head (me, LEFT) && !head (me, RIGHT))
+ // In this method, Tie and Semi_tie require the same logic with different
+ // types. It might be clearer to use a template.
+ Grob *me = unsmob<Grob> (smob);
+ Grob *yparent = me->get_parent (Y_AXIS);
+ if ((has_interface<Tie_column> (yparent)
+ || has_interface<Semi_tie_column> (yparent))
+ && unsmob<Grob_array> (yparent->get_object ("ties"))
+ // && unsmob<Grob_array> (yparent->get_object ("ties"))->size () > 1
+ )
{
- programming_error ("tie without heads");
- me->suicide ();
- return ;
- }
+ /* trigger positioning. */
+ (void) yparent->get_property ("positioning-done");
- /*
- UGH. Don't mirror Tie_configuration.
- */
- conf->head_position_ = (int) Tie::get_position (me);
- if (!conf->dir_)
- conf->dir_ = get_grob_direction (me);
- if (!conf->dir_)
- conf->dir_ = get_default_dir (me);
-
-
- Real staff_space = details.staff_space_;
- bool in_between = true;
- Real gap = robust_scm2double (me->get_property ("x-gap"), 0.2);
-
- if (conf->attachment_x_.is_empty())
- {
- if (!skylines)
- conf->attachment_x_ = get_default_attachments (me, common, gap,
- &conf->position_,
- &in_between);
- else
- {
- Real y = staff_space * 0.5 * conf->position_;
- conf->attachment_x_ = get_skyline_attachment (*skylines, y);
- conf->attachment_x_.widen (-gap);
- }
+ return me->get_property_data ("direction");
}
- Bezier b = slur_shape (conf->attachment_x_.length(),
- details.height_limit_,
- details.ratio_);
- b.scale (1, conf->dir_);
-
- Offset middle = b.curve_point (0.5);
- Offset edge = b.curve_point (0.0);
-
- conf->position_ = int (rint (conf->position_));
-
- Real dy = fabs (middle[Y_AXIS] - edge[Y_AXIS]);
- bool in_space = !(Staff_symbol_referencer::on_staffline (me, (int) conf->position_));
- bool fits_in_space =
- (dy < 0.6 * staff_space);
-
- /*
- Avoid dot
- */
- Grob *left_dot = unsmob_grob (me->get_bound (LEFT)->get_object ("dot"));
- int dot_pos = left_dot
- ? int (Staff_symbol_referencer::get_position (left_dot))
- : 0;
- if (left_dot
- && (conf->position_ == dot_pos
- || conf->position_ + conf->dir_ == dot_pos))
- {
- conf->position_ += conf->dir_;
- in_space = !in_space;
-
- if (skylines)
- {
- Real y = staff_space * 0.5 * conf->position_;
- conf->attachment_x_ = get_skyline_attachment (*skylines, y);
- conf->attachment_x_.widen (-gap);
- Bezier b = slur_shape (conf->attachment_x_.length(),
- details.height_limit_,
- details.ratio_);
- Offset middle = b.curve_point (0.5);
- Offset edge = b.curve_point (0.0);
- dy = fabs (middle[Y_AXIS] - edge[Y_AXIS]);
- fits_in_space =
- (dy < 0.6 * staff_space);
- }
- }
-
- /*
- Avoid flag.
- */
- Grob *left_stem = unsmob_grob (me->get_bound (LEFT)->get_object ("stem"));
- if (left_stem)
- {
- Stencil flag = Stem::get_translated_flag (left_stem);
- Real y = conf->position_ * staff_space * 0.5;
- if (flag.extent (Y_AXIS).contains (y))
- {
- conf->position_ += conf->dir_;
- in_space = !in_space;
- }
- }
-
- if (in_space != fits_in_space)
- {
- if (in_space)
- {
- conf->position_ += conf->dir_;
- }
- else
- {
- in_space = true;
- conf->position_ += conf->dir_;
- }
-
- /*
- ugh: code dup.
- */
- if (skylines)
- {
- Real y = staff_space * 0.5 * conf->position_;
- conf->attachment_x_ = get_skyline_attachment (*skylines, y);
- conf->attachment_x_.widen (-gap);
-
- Bezier b = slur_shape (conf->attachment_x_.length(),
- details.height_limit_,
- details.ratio_);
- Offset middle = b.curve_point (0.5);
- Offset edge = b.curve_point (0.0);
- dy = fabs (middle[Y_AXIS] - edge[Y_AXIS]);
- fits_in_space =
- (dy < 0.6 * staff_space);
- }
- }
+ programming_error ("no Tie_column or Semi_tie_column. Killing grob.");
+ me->suicide ();
+ return scm_from_int (CENTER);
+}
+SCM
+Tie::get_default_control_points (Spanner *me)
+{
+ Grob *common = me;
+ common = me->get_bound (LEFT)->common_refpoint (common, X_AXIS);
+ common = me->get_bound (RIGHT)->common_refpoint (common, X_AXIS);
- /*
- Putting larger in-space ties next to the notes forces
- the edges to be opposite (Y-wise) to the tie direction.
- */
- if (conf->position_ == conf->head_position_
- && in_space
- && Staff_symbol_referencer::staff_radius (me) > fabs (conf->position_) / 2
- && dy > 0.3 * staff_space)
- {
- conf->position_ += 2 * conf->dir_;
- }
+ Tie_formatting_problem problem;
+ problem.from_tie (me);
- if (!in_between
- && in_space
- && fabs (conf->position_ - conf->head_position_) <= 1)
- conf->position_ += 2*conf->dir_;
-
-
- if (in_space)
- {
- if ((fabs (conf->position_ - conf->head_position_) <= 1
- && fabs (dy) < 0.45 * staff_space)
- || fabs (dy) < 0.6 * staff_space)
- {
- /*
- vertically center in space.
- */
- conf->center_tie_vertically (details);
- }
- else
- {
- conf->delta_y_ =
- conf->dir_ * staff_space * (- 0.3);
- }
- }
- else
- {
- Real where = 0.5 * conf->dir_;
-
- Real rounding_dy = (where - middle[Y_AXIS]);
- conf->delta_y_ = rounding_dy;
-
- if (conf->dir_ * (b.curve_point (0.0)[Y_AXIS]
- + conf->position_ * staff_space * 0.5
- + conf->delta_y_) <
- conf->dir_ * conf->head_position_ * 0.5 * staff_space)
- {
- if (Staff_symbol_referencer::staff_radius (me) > fabs (conf->head_position_) / 2)
- conf->position_ += 2 * conf->dir_;
- else
- conf->position_ += conf->dir_;
- }
- }
+ if (!me->is_live ())
+ return SCM_EOL;
+ Ties_configuration conf
+ = problem.generate_optimal_configuration ();
- if (skylines)
- {
- Real half_space = 0.5 * staff_space;
- Real y = conf->position_ * half_space;
-
- conf->attachment_x_ = get_skyline_attachment (*skylines, y);
- conf->attachment_x_.widen (-gap);
- }
+ return get_control_points (me, problem.common_x_refpoint (),
+ conf[0], problem.details_);
}
-
-void
-Tie::set_default_control_points (Grob *me_grob)
+SCM
+Tie::get_control_points (Grob *me,
+ Grob *common,
+ Tie_configuration const &conf,
+ Tie_details const &details)
{
- Spanner *me = dynamic_cast<Spanner*> (me_grob);
- Grob *common = me;
- common = me->get_bound (LEFT)->common_refpoint (common, X_AXIS);
- common = me->get_bound (RIGHT)->common_refpoint (common, X_AXIS);
-
- Tie_configuration conf;
- if (!get_grob_direction (me))
- set_grob_direction (me, get_default_dir (me));
-
- int tie_position = (int) Tie::get_position (me);
- conf.position_ = tie_position;
-
- Tie_details details;
- details.init (me);
- get_configuration (me, common, &conf, 0, details);
- set_control_points (me, common, conf, details);
-}
+ Bezier b = conf.get_transformed_bezier (details);
+ b.translate (Offset (- me->relative_coordinate (common, X_AXIS), 0));
-void
-Tie::set_control_points (Grob *me,
- Grob *common,
- Tie_configuration const &conf,
- Tie_details const &details
- )
-{
- Bezier b = conf.get_bezier (details);
- b.scale (1, conf.dir_);
- b.translate (Offset (conf.attachment_x_[LEFT]
- - me->relative_coordinate (common, X_AXIS),
- 0.5 * conf.position_ * details.staff_space_
- + conf.delta_y_
- ));
-
SCM controls = SCM_EOL;
for (int i = 4; i--;)
{
if (!b.control_[i].is_sane ())
- programming_error ("Insane offset");
+ programming_error ("Insane offset");
controls = scm_cons (ly_offset2scm (b.control_[i]), controls);
}
- me->set_property ("control-points", controls);
+ return controls;
}
+MAKE_SCHEME_CALLBACK (Tie, calc_control_points, 1);
+SCM
+Tie::calc_control_points (SCM smob)
+{
+ Spanner *me = LY_ASSERT_SMOB(Spanner, smob, 1);
+
+ Grob *yparent = me->get_parent (Y_AXIS);
+ if ((has_interface<Tie_column> (yparent)
+ || has_interface<Semi_tie_column> (yparent))
+ && unsmob<Grob_array> (yparent->get_object ("ties")))
+ {
+ extract_grob_set (yparent, "ties", ties);
+ if (me->original () && ties.size () == 1
+ && !to_dir (me->get_property_data ("direction")))
+ {
+ assert (ties[0] == me);
+ set_grob_direction (me, Tie::get_default_dir (me));
+ }
+ /* trigger positioning. */
+ (void) yparent->get_property ("positioning-done");
+ }
+
+ SCM cp = me->get_property_data ("control-points");
+ if (!scm_is_pair (cp))
+ cp = get_default_control_points (me);
+ return cp;
+}
+/*
+ TODO: merge with Slur::print.
+*/
MAKE_SCHEME_CALLBACK (Tie, print, 1);
SCM
Tie::print (SCM smob)
{
- Grob *me = unsmob_grob (smob);
-
- if (CENTER == get_grob_direction (me))
- set_direction (me);
+ Grob *me = unsmob<Grob> (smob);
- if (!get_grob_direction (me))
- me->programming_error ("Tie direction not set.");
-
SCM cp = me->get_property ("control-points");
- if (!scm_is_pair (cp))
- {
- /*
- UGH. dependency tracking!
- */
- if (Tie_column::has_interface (me->get_parent (Y_AXIS)))
- {
- Tie_column::set_directions (me->get_parent (Y_AXIS));
- }
-
- cp = me->get_property ("control-points");
- }
-
- if (!scm_is_pair (cp))
- {
- set_default_control_points (me);
- cp = me->get_property ("control-points");
- }
-
- if (!scm_is_pair (cp))
- return Stencil ().smobbed_copy ();
Real staff_thick = Staff_symbol_referencer::line_thickness (me);
- Real base_thick = robust_scm2double (me->get_property ("thickness"), 1);
- Real thick = base_thick * staff_thick;
+ Real base_thick = staff_thick * robust_scm2double (me->get_property ("thickness"), 1);
+ Real line_thick = staff_thick * robust_scm2double (me->get_property ("line-thickness"), 1);
Bezier b;
int i = 0;
- for (SCM s = cp; s != SCM_EOL; s = scm_cdr (s))
+ for (SCM s = cp; scm_is_pair (s); s = scm_cdr (s))
{
b.control_[i] = ly_scm2offset (scm_car (s));
i++;
Stencil a;
- SCM p = me->get_property ("dash-period");
- SCM f = me->get_property ("dash-fraction");
- if (scm_is_number (p) && scm_is_number (f))
- a = Lookup::dashed_slur (b,
- thick,
- robust_scm2double (p, 1.0),
- robust_scm2double (f, 0));
- else
- a = Lookup::slur (b,
- get_grob_direction (me) * staff_thick,
- thick);
+ SCM dash_definition = me->get_property ("dash-definition");
+ a = Lookup::slur (b,
+ get_grob_direction (me) * base_thick,
+ line_thick,
+ dash_definition);
+
+#if DEBUG_TIE_SCORING
+ SCM annotation = me->get_property ("annotation");
+ if (scm_is_string (annotation))
+ {
+ string str;
+ SCM properties = Font_interface::text_font_alist_chain (me);
+
+ Stencil tm = *unsmob<Stencil> (Text_interface::interpret_markup
+ (me->layout ()->self_scm (), properties,
+ annotation));
+ tm.translate (Offset (b.control_[3][X_AXIS] + 0.5,
+ b.control_[0][Y_AXIS] * 2));
+ tm = tm.in_color (1, 0, 0);
+
+ /*
+ It would be nice if we could put this in a different layer,
+ but alas, this must be done with a Tie override.
+ */
+ a.add_stencil (tm);
+ }
+#endif
return a.smobbed_copy ();
}
ADD_INTERFACE (Tie,
- "tie-interface",
-
- "A tie connecting two noteheads.\n",
-
- /* properties */
- "control-points "
- "dash-fraction "
- "dash-period "
- "details "
- "direction "
- "thickness "
- "x-gap ");
+ "A tie - a horizontal curve connecting two noteheads.\n"
+ "\n"
+ "The following properties may be set in the @code{details}"
+ " list.\n"
+ "\n"
+ "@table @code\n"
+ "@item height-limit\n"
+ "The maximum height allowed for this tie.\n"
+ "@item ratio\n"
+ "Parameter for tie shape. The higher this number, the"
+ " quicker the slur attains its height-limit.\n"
+ "@item between-length-limit\n"
+ "This detail is currently unused.\n"
+ "@item wrong-direction-offset-penalty\n"
+ "Demerit for ties that are offset in the wrong"
+ " direction.\n"
+ "@item min-length\n"
+ "If the tie is shorter than this amount (in"
+ " staff-spaces) an increasingly large length penalty is"
+ " incurred.\n"
+ "@item min-length-penalty-factor\n"
+ "Demerit factor for tie lengths shorter than"
+ " @code{min-length}.\n"
+ "@item center-staff-line-clearance\n"
+ "If the center of the tie is closer to a staff line"
+ " than this amount, an increasingly large staff line"
+ " collision penalty is incurred.\n"
+ "@item tip-staff-line-clearance\n"
+ "If the tips of the tie are closer to a staff line"
+ " than this amount, an increasingly large staff line"
+ " collision penalty is incurred.\n"
+ "@item staff-line-collision-penalty\n"
+ "Demerit factor for ties whose tips or center come"
+ " close to staff lines.\n"
+ "@item dot-collision-clearance\n"
+ "If the tie comes closer to a dot than this amount, an"
+ " increasingly large dot collision penalty is incurred.\n"
+ "@item dot-collision-penalty\n"
+ "Demerit factor for ties which come close to dots.\n"
+ "@item note-head-gap\n"
+ "The distance (in staff-spaces) by which the ends of"
+ " the tie are offset horizontally from the center"
+ " line through the note head.\n"
+ "@item stem-gap\n"
+ "The distance (in staff-spaces) by which the ends of"
+ " the tie are offset horizontally from a stem which"
+ " is on the same side of the note head as the tie.\n"
+ "@item tie-column-monotonicity-penalty\n"
+ "Demerit if the y-position of this tie in the set of"
+ " ties being considered is less than the y-position"
+ " of the previous tie.\n"
+ "@item tie-tie-collision-distance\n"
+ "If this tie is closer than this amount to the previous"
+ " tie in the set being considered, an increasingly"
+ " large tie-tie collision penalty is incurred.\n"
+ "@item tie-tie-collision-penalty\n"
+ "Demerit factor for a tie in the set being considered"
+ " which is close to the previous one.\n"
+ "@item horizontal-distance-penalty-factor\n"
+ "Demerit factor for ties in the set being considered"
+ " which are horizontally distant from the note heads.\n"
+ "@item vertical-distance-penalty-factor\n"
+ "Demerit factor for ties in the set being considered"
+ " which are vertically distant from the note heads.\n"
+ "@item same-dir-as-stem-penalty\n"
+ "Demerit if tie is on the same side as a stem or on the"
+ " opposite side to the one specified.\n"
+ "@item intra-space-threshold\n"
+ "If the tie's height (in half staff-spaces) is less than"
+ " this it is positioned between two adjacent staff"
+ " lines; otherwise it is positioned to straddle a staff"
+ " line further from the note heads.\n"
+ "@item outer-tie-length-symmetry-penalty-factor\n"
+ "Demerit factor for ties horizontally positioned"
+ " unsymmetrically with respect to the two note heads.\n"
+ "@item outer-tie-vertical-distance-symmetry-penalty-factor\n"
+ "Demerit factor for ties vertically positioned"
+ " unsymmetrically with respect to the two note heads.\n"
+ "@item outer-tie-vertical-gap\n"
+ "Amount (in half staff-spaces) by which a tie is moved"
+ " away from the note heads if it is closer to either"
+ " of them than 0.25 half staff-spaces.\n"
+ "@item skyline-padding\n"
+ "Padding of the skylines around note heads in chords.\n"
+ "@item single-tie-region-size\n"
+ "The number of candidate ties to generate when only a"
+ " single tie is required. Successive candidates differ"
+ " in their initial vertical position by half a"
+ " staff-space.\n"
+ "@item multi-tie-region-size\n"
+ "The number of variations that are tried for the"
+ " extremal ties in a chord. Variations differ in their"
+ " initial vertical position by half a staff-space.\n"
+
+ "@end table\n",
+
+ /* properties */
+ "annotation "
+ "avoid-slur " // UGH.
+ "control-points "
+ "dash-definition "
+ "details "
+ "direction "
+ "head-direction "
+ "line-thickness "
+ "neutral-direction "
+ "staff-position "
+ "thickness "
+ );