Next: , Previous: Navigating the program reference, Up: The \override command



7.2.4 Layout interfaces

The HTML page that we found in the previous section, describes the layout object called Fingering (lilypond-internals) . Such an object is a symbol within the score. It has properties that store numbers (like thicknesses and directions), but also pointers to related objects. A layout object is also called grob, which is short for Graphical Object.

The page for Fingering lists the definitions for the Fingering object. For example, the page says

padding (dimension, in staff space):

0.6

which means that the number will be kept at a distance of at least 0.6 of the note head.

Each layout object may have several functions as a notational or typographical element. For example, the Fingering object has the following aspects

Each of these aspects is captured in so-called interfaces, which are listed on the Fingering (lilypond-internals) page at the bottom

This object supports the following interfaces: item-interface (lilypond-internals) , self-alignment-interface (lilypond-internals) , side-position-interface (lilypond-internals) , text-interface (lilypond-internals) , text-script-interface (lilypond-internals) , font-interface (lilypond-internals) , finger-interface (lilypond-internals) , and grob-interface (lilypond-internals) .

Clicking any of the links will take you to the page of the respective object interface. Each interface has a number of properties. Some of them are not user-serviceable (“Internal properties”), but others are.

We have been talking of the Fingering object, but actually it does not amount to much. The initialization file scm/define-grobs.scm shows the soul of the `object',

(Fingering
  . ((print-function . ,Text_interface::print)
     (padding . 0.6)
     (staff-padding . 0.6)
     (self-alignment-X . 0)
     (self-alignment-Y . 0)
     (script-priority . 100)
     (font-size . -5)
     (meta . ((interfaces . (finger-interface font-interface
                             text-script-interface text-interface
                             side-position-interface
                             self-alignment-interface
                             item-interface))))))

As you can see, the Fingering object is nothing more than a bunch of variable settings, and the webpage in the Program Reference is directly generated from this definition.

Read comments on this page, or add one.

This page is for LilyPond-2.5.11 (development-branch).

Report errors to <bug-lilypond@gnu.org>.

Other languages: English.
Using automatic language selection.