Re: white text on black background

[Mats Bengtsson]

Quoting Marius Amado Alves <address@hidden>:

> ...
> All that the manual (version 2.6.6) says about \filled-box is:
>
> \filled-box xext (pair of numbers) yext (pair of numbers) blot (number)
>   Draw a box with rounded corners of dimensions xext and yext.
>
> I suggest completing this as follows.
>
> \filled-box xext (pair of numbers) yext (pair of numbers) blot (number)
>   Draw a box with possibly rounded corners of dimensions xext and yext,
>    where the first number of xext is
>     the horizontal offset of the left side of the box,
>    the second number of xext is
>     the horizontal offset of the right side,
>    the first number of yext is
>     the vertical offset of the bottom side,
>    and the second number of yext is
>     the vertical offset of the top side.
>   All offsets are in staff spaces
>    and relative to the current position.
>   Positive offsets are rightwards and upwards,
>    negative offsets are leftwards and downwards.
>   The blot is the roundness of the box corners,
>    namely the diameter in staff spaces of the circle
>    corresponding to the curve made by each corner,
>    and should not exceed half the size of the
>    width or height of the box, which one is smaller.
>    Naturally a value of zero represents sharp corners.
>    Example:
>     \filled-box #'(-.3 . 1.8) #'(-.3 . 1.8) #0

I'd rather propose to say something like:

\filled-box xext (pair of numbers) yext (pair of numbers) blot (number)
 Draw a box with rounded corners of dimensions xext and yext, where
 blot is the roundness of the box corners.
 Example:
   \filled-box #'(-.3 . 1.8) #'(-.3 . 1.8) #0
 which gives a box extending horizontally from -0.3 to 1.8 and
 vertically from -0.3 up to 1.8, with sharp corners.

Which is shorter and, at least in my opinion, just as informative.

Every single distance related parameter in LilyPond is specified
in units of staff spaces, so that information cannot be repeated
everywhere!

   /Mats