lily/self-alignment-interface.cc

   1 /*
   2   This file is part of LilyPond, the GNU music typesetter.
   3
   4   Copyright (C) 2004--2014 Han-Wen Nienhuys <hanwen@xs4all.nl>
   5
   6   LilyPond is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   LilyPond is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #include "self-alignment-interface.hh"
  21
  22 #include "grob.hh"
  23 #include "note-column.hh"
  24 #include "paper-column.hh"
  25 #include "pointer-group-interface.hh"
  26 #include "warn.hh"
  27
  28 MAKE_SCHEME_CALLBACK (Self_alignment_interface, y_aligned_on_self, 1);
  29 SCM
  30 Self_alignment_interface::y_aligned_on_self (SCM element)
  31 {
  32   return aligned_on_self (unsmob_grob (element), Y_AXIS, false, 0, 0);
  33 }
  34
  35 MAKE_SCHEME_CALLBACK (Self_alignment_interface, x_aligned_on_self, 1);
  36 SCM
  37 Self_alignment_interface::x_aligned_on_self (SCM element)
  38 {
  39   return aligned_on_self (unsmob_grob (element), X_AXIS, false, 0, 0);
  40 }
  41
  42 MAKE_SCHEME_CALLBACK (Self_alignment_interface, pure_y_aligned_on_self, 3);
  43 SCM
  44 Self_alignment_interface::pure_y_aligned_on_self (SCM smob, SCM start, SCM end)
  45 {
  46   return aligned_on_self (unsmob_grob (smob), Y_AXIS, true, robust_scm2int (start, 0), robust_scm2int (end, INT_MAX));
  47 }
  48
  49 SCM
  50 Self_alignment_interface::aligned_on_self (Grob *me, Axis a, bool pure, int start, int end)
  51 {
  52   SCM sym = (a == X_AXIS) ? ly_symbol2scm ("self-alignment-X")
  53             : ly_symbol2scm ("self-alignment-Y");
  54
  55   SCM align (me->internal_get_property (sym));
  56   if (scm_is_number (align))
  57     {
  58       Interval ext (me->maybe_pure_extent (me, a, pure, start, end));
  59       // Empty extent doesn't mean an error - we simply don't align such grobs.
  60       // However, empty extent and non-empty stencil would be suspicious.
  61       if (!ext.is_empty ())
  62         return scm_from_double (- ext.linear_combination (scm_to_double (align)));
  63       else if (me->get_stencil ())
  64         warning (me->name () + " has empty extent and non-empty stencil.");
  65     }
  66   return scm_from_double (0.0);
  67 }
  68
  69 SCM
  70 Self_alignment_interface::centered_on_object (Grob *him, Axis a)
  71 {
  72   return scm_from_double (robust_relative_extent (him, him, a).center ());
  73 }
  74
  75 MAKE_SCHEME_CALLBACK (Self_alignment_interface, centered_on_x_parent, 1);
  76 SCM
  77 Self_alignment_interface::centered_on_x_parent (SCM smob)
  78 {
  79   return centered_on_object (unsmob_grob (smob)->get_parent (X_AXIS), X_AXIS);
  80 }
  81
  82 MAKE_SCHEME_CALLBACK (Self_alignment_interface, centered_on_note_columns, 1);
  83 SCM
  84 Self_alignment_interface::centered_on_note_columns (SCM smob)
  85 {
  86   Item *it = unsmob_item (smob)->get_column ();
  87   if (!it)
  88     return scm_from_double (0.0);
  89
  90   extract_grob_set (it, "elements", elts);
  91   vector<Grob *> ncs;
  92   Interval centers;
  93   for (vsize i = 0; i < elts.size (); i++)
  94     if (Note_column::has_interface (elts[i]))
  95       centers.add_point (scm_to_double (centered_on_object (elts[i], X_AXIS)));
  96
  97   if (centers.is_empty ())
  98     return scm_from_double (0.0);
  99
 100   return scm_from_double (centers.center ());
 101 }
 102
 103 MAKE_SCHEME_CALLBACK (Self_alignment_interface, centered_on_y_parent, 1);
 104 SCM
 105 Self_alignment_interface::centered_on_y_parent (SCM smob)
 106 {
 107   return centered_on_object (unsmob_grob (smob)->get_parent (Y_AXIS), Y_AXIS);
 108 }
 109
 110 MAKE_SCHEME_CALLBACK (Self_alignment_interface, x_centered_on_y_parent, 1);
 111 SCM
 112 Self_alignment_interface::x_centered_on_y_parent (SCM smob)
 113 {
 114   return centered_on_object (unsmob_grob (smob)->get_parent (Y_AXIS), X_AXIS);
 115 }
 116
 117 MAKE_SCHEME_CALLBACK (Self_alignment_interface, aligned_on_x_parent, 1);
 118 SCM
 119 Self_alignment_interface::aligned_on_x_parent (SCM smob)
 120 {
 121   return aligned_on_parent (unsmob_grob (smob), X_AXIS);
 122 }
 123
 124 MAKE_SCHEME_CALLBACK (Self_alignment_interface, aligned_on_y_parent, 1);
 125 SCM
 126 Self_alignment_interface::aligned_on_y_parent (SCM smob)
 127 {
 128   return aligned_on_parent (unsmob_grob (smob), Y_AXIS);
 129 }
 130
 131 SCM
 132 Self_alignment_interface::aligned_on_parent (Grob *me, Axis a)
 133 {
 134   Grob *him = me->get_parent (a);
 135   Interval he;
 136   if (Paper_column::has_interface (him))
 137       /*
 138         PaperColumn extents aren't reliable (they depend on size and alignment
 139         of PaperColumn's children), so we align on NoteColumn instead.
 140         This happens e.g. for lyrics without associatedVoice.
 141       */
 142     he = Paper_column::get_interface_extent
 143               (him, ly_symbol2scm ("note-column-interface"), a);
 144   else
 145     he = him->extent (him, a);
 146
 147   SCM sym = (a == X_AXIS) ? ly_symbol2scm ("self-alignment-X")
 148             : ly_symbol2scm ("self-alignment-Y");
 149   SCM align_prop (me->internal_get_property (sym));
 150
 151   if (!scm_is_number (align_prop))
 152     return scm_from_int (0);
 153
 154   Real x = 0.0;
 155   Real align = scm_to_double (align_prop);
 156
 157   Interval ext (me->extent (me, a));
 158
 159   // Empty extent doesn't mean an error - we simply don't align such grobs.
 160   // However, empty extent and non-empty stencil would be suspicious.
 161   if (!ext.is_empty ())
 162     x -= ext.linear_combination (align);
 163   else if (me->get_stencil ())
 164     warning (me->name () + " has empty extent and non-empty stencil.");
 165
 166   // See comment above.
 167   if (!he.is_empty ())
 168     x += he.linear_combination (align);
 169   else if (him->get_stencil ())
 170     warning (him->name () + " has empty extent and non-empty stencil.");
 171
 172   return scm_from_double (x);
 173 }
 174
 175 void
 176 Self_alignment_interface::set_center_parent (Grob *me, Axis a)
 177 {
 178   add_offset_callback (me,
 179                        (a == X_AXIS) ? centered_on_x_parent_proc : centered_on_y_parent_proc,
 180                        a);
 181 }
 182
 183 void
 184 Self_alignment_interface::set_align_self (Grob *me, Axis a)
 185 {
 186   add_offset_callback (me,
 187                        (a == X_AXIS) ? x_aligned_on_self_proc : y_aligned_on_self_proc,
 188                        a);
 189 }
 190
 191 ADD_INTERFACE (Self_alignment_interface,
 192                "Position this object on itself and/or on its parent.  To this"
 193                " end, the following functions are provided:\n"
 194                "\n"
 195                "@table @code\n"
 196                "@item Self_alignment_interface::[xy]_aligned_on_self\n"
 197                "Align self on reference point, using"
 198                " @code{self-alignment-X} and @code{self-alignment-Y}."
 199                "@item Self_alignment_interface::aligned_on_[xy]_parent\n"
 200                "@item Self_alignment_interface::centered_on_[xy]_parent\n"
 201                "Shift the object so its own reference point is centered on"
 202                " the extent of the parent\n"
 203                "@end table\n",
 204
 205                /* properties */
 206                "self-alignment-X "
 207                "self-alignment-Y "
 208               );