Am So., 5. Okt. 2025 um 18:31 Uhr schrieb Werner LEMBERG <w...@gnu.org>:
>
>
> > After reading line-spanner.cc again and again I may have found the
> > culprit.  See attached files.  Previous attempts are still in there,
> > but commented.  This may be of some use for others.
>
> Very nice, LGTM!  Do you think the comments in `line-spanner.cc`
> should be improved and/or extended?  If so, do you have suggestions
> for that?
>
>
>     Werner

Regarding `line-spanner.cc`:
I don't entirely understand the ASCII-graphic, line 260 ff.
The text of the comments in `Line_spanner::calc_bound_info` is ok,
though, I'm not a native speaker. Thus it lasted some time until I got
it.
Ofcourse my lack of cc made it more difficult. (In scheme I would look
at comments _and_ code.)
Thus, maybe the graphic could be made clearer, otherwise all's ok, imho.

Meanwhile I continued coding and stumbled across:

a) `padding`
Usually padding is applied at X- or Y-axis.
Though, for Glissando (and other non-horizontal line-spanners) the
padding is the length of the (usually sloped) line which is _not
_printed, i.e. the value of `padding` is the hypotenuse of a triangle,
_not_ the value in X- (or Y-) axis direction.
If you already know that, then the description (line 716 ff) is
obvious. Alas, the other way round, if you don't know that, but you
want to learn about it, it is much harder.
Maybe something like this makes it clearer:
@item padding
Controls the space between the specified start/end point of the
printed line and the
actual start/end of the grob.  Meaning the value is neither measured
in X- nor in Y-axis
direction, but is the hypotenuse of both.
Without padding, a glissando would start and end in the
center of each note head.

b) `gap`
I've no clue at all what gap in Glissando,gap is about and should do.
We have examples in the docs:
Documentation/en/learning/tweaks.itely
Documentation/ly-examples/tab-example.ly
Compiling them with different gap-values makes no differences, afaict.
Would be great, if someone could come up with an example with
noticeble differences for different gap-values, otherwise I'd vote for
deleting it from the grob-definition of Glissando and probably other
line-spanners.
Afaict, it only makes sense for some special Beams.

Cheers,
  Harm

Reply via email to