1 @c -*- coding: utf-8; mode: texinfo; -*-
4 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
12 @node Notation manual tables
13 @appendix Notation manual tables
15 @c Please do not delete the following @ignore block.
17 Note for editors and translators: In the following menu, two entries
18 are needed to link to a pair of automatically generated sections.
19 Please keep them and, if using emacs, do not run
20 texinfo-all-menus-update without manually restoring them back. These
23 * Text markup commands::
24 * Text markup list commands::
26 and they should go just after
30 * List of articulations::
35 * Common chord modifiers::
36 * Predefined fretboard diagrams::
41 * Text markup commands::
42 * Text markup list commands::
43 * List of articulations::
45 * Technical glossary::
46 * All context properties::
54 @node Chord name chart
55 @appendixsec Chord name chart
57 The following charts shows two standard systems for printing chord
58 names, along with the pitches they represent.
60 @lilypondfile{chord-names-jazz.ly}
62 @node Common chord modifiers
63 @appendixsec Common chord modifiers
65 The following table shows chord modifiers that can be used in
66 @code{\chordmode} to generate standard chord structures.
68 @multitable @columnfractions .2 .3 .2 .2
83 Major third, perfect fifth
87 @lilypond[line-width=3\cm,noragged-right, notime]
96 Minor third, perfect fifth
100 @lilypond[line-width=3\cm,noragged-right, notime]
109 Major third, augmented fifth
113 @lilypond[line-width=3\cm,noragged-right, notime]
122 Minor third, diminished fifth
126 @lilypond[line-width=3\cm,noragged-right, notime]
135 Major triad, minor seventh
139 @lilypond[line-width=3\cm,noragged-right, notime]
148 Major triad, major seventh
150 @code{maj7} or @code{maj}
152 @lilypond[line-width=3\cm,noragged-right, notime]
161 Minor triad, minor seventh
165 @lilypond[line-width=3\cm,noragged-right, notime]
174 Diminished triad, diminished seventh
178 @lilypond[line-width=3\cm,noragged-right, notime]
187 Augmented triad, minor seventh
191 @lilypond[line-width=3\cm,noragged-right, notime]
198 Half-diminished seventh
200 Diminished triad, minor seventh
204 @lilypond[line-width=3\cm,noragged-right, notime]
213 Minor triad, major seventh
217 @lilypond[line-width=3\cm,noragged-right, notime]
230 @lilypond[line-width=3\cm,noragged-right, notime]
243 @lilypond[line-width=3\cm,noragged-right, notime]
252 Dominant seventh, major ninth
256 @lilypond[line-width=3\cm,noragged-right, notime]
265 Major seventh, major ninth
269 @lilypond[line-width=3\cm,noragged-right, notime]
278 Minor seventh, major ninth
282 @lilypond[line-width=3\cm,noragged-right, notime]
291 Dominant ninth, perfect eleventh
295 @lilypond[line-width=3\cm,noragged-right, notime]
304 Major ninth, perfect eleventh
308 @lilypond[line-width=3\cm,noragged-right, notime]
317 Minor ninth, perfect eleventh
321 @lilypond[line-width=3\cm,noragged-right, notime]
330 Dominant ninth, major thirteenth
334 @lilypond[line-width=3\cm,noragged-right, notime]
343 Dominant eleventh, major thirteenth
347 @lilypond[line-width=3\cm,noragged-right, notime]
356 Major eleventh, major thirteenth
360 @lilypond[line-width=3\cm,noragged-right, notime]
369 Minor eleventh, major thirteenth
373 @lilypond[line-width=3\cm,noragged-right, notime]
382 Major second, perfect fifth
386 @lilypond[line-width=3\cm,noragged-right, notime]
395 Perfect fourth, perfect fifth
399 @lilypond[line-width=3\cm,noragged-right, notime]
408 @node Predefined fretboard diagrams
409 @appendixsec Predefined fretboard diagrams
411 The chart below shows the predefined fretboard diagrams.
413 @lilypondfile{display-predefined-fretboards.ly}
415 @node MIDI instruments
416 @appendixsec MIDI instruments
418 The following is a list of names that can be used for the
419 @code{midiInstrument} property.
422 acoustic grand contrabass lead 7 (fifths)
423 bright acoustic tremolo strings lead 8 (bass+lead)
424 electric grand pizzicato strings pad 1 (new age)
425 honky-tonk orchestral harp pad 2 (warm)
426 electric piano 1 timpani pad 3 (polysynth)
427 electric piano 2 string ensemble 1 pad 4 (choir)
428 harpsichord string ensemble 2 pad 5 (bowed)
429 clav synthstrings 1 pad 6 (metallic)
430 celesta synthstrings 2 pad 7 (halo)
431 glockenspiel choir aahs pad 8 (sweep)
432 music box voice oohs fx 1 (rain)
433 vibraphone synth voice fx 2 (soundtrack)
434 marimba orchestra hit fx 3 (crystal)
435 xylophone trumpet fx 4 (atmosphere)
436 tubular bells trombone fx 5 (brightness)
437 dulcimer tuba fx 6 (goblins)
438 drawbar organ muted trumpet fx 7 (echoes)
439 percussive organ french horn fx 8 (sci-fi)
440 rock organ brass section sitar
441 church organ synthbrass 1 banjo
442 reed organ synthbrass 2 shamisen
443 accordion soprano sax koto
444 harmonica alto sax kalimba
445 concertina tenor sax bagpipe
446 acoustic guitar (nylon) baritone sax fiddle
447 acoustic guitar (steel) oboe shanai
448 electric guitar (jazz) english horn tinkle bell
449 electric guitar (clean) bassoon agogo
450 electric guitar (muted) clarinet steel drums
451 overdriven guitar piccolo woodblock
452 distorted guitar flute taiko drum
453 guitar harmonics recorder melodic tom
454 acoustic bass pan flute synth drum
455 electric bass (finger) blown bottle reverse cymbal
456 electric bass (pick) shakuhachi guitar fret noise
457 fretless bass whistle breath noise
458 slap bass 1 ocarina seashore
459 slap bass 2 lead 1 (square) bird tweet
460 synth bass 1 lead 2 (sawtooth) telephone ring
461 synth bass 2 lead 3 (calliope) helicopter
462 violin lead 4 (chiff) applause
463 viola lead 5 (charang) gunshot
469 @appendixsec List of colors
471 @subsubheading Normal colors
473 Usage syntax is detailed in @ref{Coloring objects}.
475 @cindex List of colors
476 @cindex Colors, list of
479 black white red green
480 blue cyan magenta yellow
481 grey darkred darkgreen darkblue
482 darkcyan darkmagenta darkyellow
486 @subsubheading X color names
488 X color names come several variants:
490 Any name that is spelled as a single word with capitalization
491 (e.g. @q{LightSlateBlue}) can also be spelled as space separated
492 words without capitalization (e.g. @q{light slate blue}).
494 The word @q{grey} can always be spelled @q{gray} (e.g. @q{DarkSlateGray}).
496 Some names can take a numerical suffix (e.g. @q{LightSalmon4}).
499 @subsubheading Color Names without a numerical suffix:
502 snow GhostWhite WhiteSmoke gainsboro FloralWhite
503 OldLace linen AntiqueWhite PapayaWhip BlanchedAlmond
504 bisque PeachPuff NavajoWhite moccasin cornsilk
505 ivory LemonChiffon seashell honeydew MintCream
506 azure AliceBlue lavender LavenderBlush MistyRose
507 white black DarkSlateGrey DimGrey SlateGrey
508 LightSlateGrey grey LightGrey MidnightBlue navy
509 NavyBlue CornflowerBlue DarkSlateBlue SlateBlue MediumSlateBlue
510 LightSlateBlue MediumBlue RoyalBlue blue DodgerBlue
511 DeepSkyBlue SkyBlue LightSkyBlue SteelBlue LightSteelBlue
512 LightBlue PowderBlue PaleTurquoise DarkTurquoise MediumTurquoise
513 turquoise cyan LightCyan CadetBlue MediumAquamarine
514 aquamarine DarkGreen DarkOliveGreen DarkSeaGreen SeaGreen
515 MediumSeaGreen LightSeaGreen PaleGreen SpringGreen LawnGreen
516 green chartreuse MediumSpringGreen GreenYellow LimeGreen
517 YellowGreen ForestGreen OliveDrab DarkKhaki khaki
518 PaleGoldenrod LightGoldenrodYellow LightYellow yellow gold
519 LightGoldenrod goldenrod DarkGoldenrod RosyBrown IndianRed
520 SaddleBrown sienna peru burlywood beige
521 wheat SandyBrown tan chocolate firebrick
522 brown DarkSalmon salmon LightSalmon orange
523 DarkOrange coral LightCoral tomato OrangeRed
524 red HotPink DeepPink pink LightPink
525 PaleVioletRed maroon MediumVioletRed VioletRed magenta
526 violet plum orchid MediumOrchid DarkOrchid
527 DarkViolet BlueViolet purple MediumPurple thistle
528 DarkGrey DarkBlue DarkCyan DarkMagenta DarkRed
533 @subsubheading Color names with a numerical suffix
535 In the following names the suffix N can be a number in the range 1-4:
538 snowN seashellN AntiqueWhiteN bisqueN PeachPuffN
539 NavajoWhiteN LemonChiffonN cornsilkN ivoryN honeydewN
540 LavenderBlushN MistyRoseN azureN SlateBlueN RoyalBlueN
541 blueN DodgerBlueN SteelBlueN DeepSkyBlueN SkyBlueN
542 LightSkyBlueN LightSteelBlueN LightBlueN LightCyanN PaleTurquoiseN
543 CadetBlueN turquoiseN cyanN aquamarineN DarkSeaGreenN
544 SeaGreenN PaleGreenN SpringGreenN greenN chartreuseN
545 OliveDrabN DarkOliveGreenN khakiN LightGoldenrodN LightYellowN
546 yellowN goldN goldenrodN DarkGoldenrodN RosyBrownN
547 IndianRedN siennaN burlywoodN wheatN tanN
548 chocolateN firebrickN brownN salmonN LightSalmonN
549 orangeN DarkOrangeN coralN tomatoN OrangeRedN
550 redN DeepPinkN HotPinkN pinkN LightPinkN
551 PaleVioletRedN maroonN VioletRedN magentaN orchidN
552 plumN MediumOrchidN DarkOrchidN purpleN MediumPurpleN
557 @subsubheading Grey Scale
559 A grey scale can be obtained using:
566 Where N is in the range 0-100.
570 @appendixsec The Feta font
575 The following symbols are available in the Emmentaler font and may be
576 accessed directly using text markup such as @code{g^\markup @{
577 \musicglyph #"scripts.segno" @}}, see @ref{Formatting text}.
582 * Time Signature glyphs::
584 * Accidental glyphs::
585 * Default Notehead glyphs::
586 * Special Notehead glyphs::
587 * Shape-note Notehead glyphs::
594 * Bracket-tip glyphs::
601 * Neomensural glyphs::
608 @unnumberedsubsec Clef glyphs
611 \include "font-table.ly"
612 \markuplines \override-lines #'(word-space . 4)
617 @node Time Signature glyphs
618 @unnumberedsubsec Time Signature glyphs
621 \include "font-table.ly"
622 \markuplines \override-lines #'(word-space . 4)
628 @unnumberedsubsec Number glyphs
631 \include "font-table.ly"
632 \markuplines \override-lines #'(word-space . 4)
637 @node Accidental glyphs
638 @unnumberedsubsec Accidental glyphs
641 \include "font-table.ly"
642 \markuplines \override-lines #'(word-space . 4)
643 \doc-chars #accidentals
647 @node Default Notehead glyphs
648 @unnumberedsubsec Default Notehead glyphs
651 \include "font-table.ly"
652 \markuplines \override-lines #'(word-space . 4)
653 \doc-chars #default-noteheads
657 @node Special Notehead glyphs
658 @unnumberedsubsec Special Notehead glyphs
661 \include "font-table.ly"
662 \markuplines \override-lines #'(word-space . 4)
663 \doc-chars #special-noteheads
667 @node Shape-note Notehead glyphs
668 @unnumberedsubsec Shape-note Notehead glyphs
671 \include "font-table.ly"
672 \markuplines \override-lines #'(word-space . 4)
673 \doc-chars #shape-note-noteheads
678 @unnumberedsubsec Rest glyphs
681 \include "font-table.ly"
682 \markuplines \override-lines #'(word-space . 4)
688 @unnumberedsubsec Flag glyphs
691 \include "font-table.ly"
692 \markuplines \override-lines #'(word-space . 4)
698 @unnumberedsubsec Dot glyphs
701 \include "font-table.ly"
702 \markuplines \override-lines #'(word-space . 4)
708 @unnumberedsubsec Dynamic glyphs
711 \include "font-table.ly"
712 \markuplines \override-lines #'(word-space . 4)
718 @unnumberedsubsec Script glyphs
721 \include "font-table.ly"
722 \markuplines \override-lines #'(word-space . 4)
727 @node Arrowhead glyphs
728 @unnumberedsubsec Arrowhead glyphs
731 \include "font-table.ly"
732 \markuplines \override-lines #'(word-space . 4)
733 \doc-chars #arrowheads
737 @node Bracket-tip glyphs
738 @unnumberedsubsec Bracket-tip glyphs
741 \include "font-table.ly"
742 \markuplines \override-lines #'(word-space . 4)
743 \doc-chars #brackettips
748 @unnumberedsubsec Pedal glyphs
751 \include "font-table.ly"
752 \markuplines \override-lines #'(word-space . 4)
757 @node Accordion glyphs
758 @unnumberedsubsec Accordion glyphs
761 \include "font-table.ly"
762 \markuplines \override-lines #'(word-space . 4)
763 \doc-chars #accordion
767 @node Vaticana glyphs
768 @unnumberedsubsec Vaticana glyphs
771 \include "font-table.ly"
772 \markuplines \override-lines #'(word-space . 4)
777 @node Medicaea glyphs
778 @unnumberedsubsec Medicaea glyphs
781 \include "font-table.ly"
782 \markuplines \override-lines #'(word-space . 4)
787 @node Hufnagel glyphs
788 @unnumberedsubsec Hufnagel glyphs
791 \include "font-table.ly"
792 \markuplines \override-lines #'(word-space . 4)
797 @node Mensural glyphs
798 @unnumberedsubsec Mensural glyphs
801 \include "font-table.ly"
802 \markuplines \override-lines #'(word-space . 4)
807 @node Neomensural glyphs
808 @unnumberedsubsec Neomensural glyphs
811 \include "font-table.ly"
812 \markuplines \override-lines #'(word-space . 4)
813 \doc-chars #neomensural
817 @node Petrucci glyphs
818 @unnumberedsubsec Petrucci glyphs
821 \include "font-table.ly"
822 \markuplines \override-lines #'(word-space . 4)
827 @node Solesmes glyphs
828 @unnumberedsubsec Solesmes glyphs
831 \include "font-table.ly"
832 \markuplines \override-lines #'(word-space . 4)
837 @node Note head styles
838 @appendixsec Note head styles
840 @cindex note head styles
841 The following styles may be used for note heads.
843 @lilypondfile[noindent]{note-head-style.ly}
845 @include markup-commands.tely
847 @include markup-list-commands.tely
849 @node List of articulations
850 @appendixsec List of articulations
854 @cindex staccatissimo
864 @cindex organ pedal marks
877 @cindex thumb marking
883 @lilypondfile[quote,texidoc]{script-chart.ly}
886 @node Percussion notes
887 @appendixsec Percussion notes
889 @lilypondfile[quote]{percussion-chart.ly}
892 @node Technical glossary
893 @appendixsec Technical glossary
895 A glossary of the technical terms and concepts used internally.
913 @unnumberedsubsec callback
917 A @strong{callback} is a routine, function or method whose reference is
918 passed as an argument in a call to another routine, so allowing
919 the called routine to invoke it. The technique enables a lower-
920 level software layer to call a function defined in a higher
921 layer. Callbacks are used extensively in LilyPond to permit
922 user-level Scheme code to define how many low-level actions are
926 @unnumberedsubsec glyph
932 A @strong{glyph} is a particular graphical representation of a typographic
933 character, or a combination of two characters formating a ligature.
934 A set of glyphs with a single style and shape comprise a font, and
935 a set of fonts covering several styles and sizes comprise a typeface.
943 @unnumberedsubsec grob
946 @cindex layout objects
947 @cindex graphical objects
949 LilyPond objects which represent items of notation in the printed
950 output such as note heads, stems, slurs, ties, fingering, clefs,
951 etc are called @q{Layout objects}, often known as @q{GRaphical
952 OBjects}, or @strong{grobs} for short.
956 @rlearning{Objects and interfaces},
957 @rlearning{Naming conventions of objects and properties},
958 @rlearning{Properties of layout objects}.
961 @rinternals{All layout objects}.
964 @unnumberedsubsec interface
967 @cindex grob-interface
968 @cindex graphical object interfaces
970 Actions and properties which are common to a number of grobs are
971 grouped together in an object called a @code{grob-interface}, or
972 just @q{interface} for short.
976 @rlearning{Objects and interfaces},
977 @rlearning{Naming conventions of objects and properties},
978 @rlearning{Properties found in interfaces}.
981 @ref{Layout interfaces}.
984 @rinternals{Graphical Object Interfaces}.
987 @unnumberedsubsec lexer
991 A @strong{lexer} is a program which converts a sequence of
992 characters into a sequence of tokens, a process called lexical
993 analysis. The LilyPond lexer converts an input @code{.ly} file
994 into a tokenized file more suited to the next stage of processing,
995 parsing, see @ref{parser}.
998 @unnumberedsubsec output-def
1002 An instance of the @code{Output-def} class contains the methods and
1003 data structures associated with an output block. Instances are
1004 created for midi, layout and paper blocks.
1007 @unnumberedsubsec parser
1011 A @strong{parser} analyzes the sequence of tokens produced by
1012 a lexer to determine its grammatical structure as defined by the
1013 rules governing the format of an input file.
1015 @node parser variable
1016 @unnumberedsubsec parser variable
1018 These are variables defined directly in Scheme. Their direct
1019 use by users is strongly discouraged, because their scoping
1020 semantics can be confusing.
1022 When the value of such a variable is changed in a @code{.ly} file,
1023 the change is global, and unless explicitly reverted, the new value
1024 will persist to the end of the file, affecting subsequent
1025 @code{\score} blocks as well as external files added with the
1026 @code{\include} command. This can lead to unintended consequences
1027 and in complex typesetting projects the consequent errors can be
1028 difficult to track down.
1030 LilyPond uses the following parser variables:
1033 @item afterGraceFraction
1038 @item parseStringResult
1039 @item partCombineListener
1041 @item toplevel-bookparts
1042 @item toplevel-scores
1043 @item showLastLength
1044 @item showFirstLength
1048 @unnumberedsubsec prob
1051 @node simple-closure
1052 @unnumberedsubsec simple-closure
1056 @unnumberedsubsec smob
1060 @unnumberedsubsec stencil
1064 @node All context properties
1065 @appendixsec All context properties
1067 @include context-properties.tely
1070 @node Layout properties
1071 @appendixsec Layout properties
1073 @include layout-properties.tely
1077 @appendixsec Identifiers
1079 @include identifiers.tely
1082 @node Scheme functions
1083 @appendixsec Scheme functions
1085 @include scheme-functions.tely