Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(400)

Side by Side Diff: Documentation/notation/staff.itely

Issue 553760043: Add dynamic-interface to keepAliveInterfaces
Patch Set: Add dynamic-interface to keepAliveInterfaces Created 4 years ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | ly/engraver-init.ly » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 @c -*- coding: utf-8; mode: texinfo; -*- 1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore 2 @ignore
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH 3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4 4
5 When revising a translation, copy the HEAD committish of the 5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors' 6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes.. 7 Guide, node Updating translation committishes..
8 @end ignore 8 @end ignore
9 9
10 @c \version "2.19.21" 10 @c \version "2.19.21"
(...skipping 754 matching lines...) Expand 10 before | Expand all | Expand 10 after
765 \relative { a''8 f e16 d c b a2 } 765 \relative { a''8 f e16 d c b a2 }
766 @end lilypond 766 @end lilypond
767 767
768 768
769 Empty staves can be hidden (for a so-called @q{Frenched Score}) 769 Empty staves can be hidden (for a so-called @q{Frenched Score})
770 by applying the @code{\RemoveEmptyStaves} command on a context, which 770 by applying the @code{\RemoveEmptyStaves} command on a context, which
771 can be done globally (in a @code{\layout} block) as well as for 771 can be done globally (in a @code{\layout} block) as well as for
772 specific staves only (in a @code{\with} block). This command removes 772 specific staves only (in a @code{\with} block). This command removes
773 all empty staves in a score except for those in the first system. If 773 all empty staves in a score except for those in the first system. If
774 you want those in the first system to be hidden also, use 774 you want those in the first system to be hidden also, use
775 @code{\RemoveAllEmptyStaves}. Supported contexts are @code{Staff}, 775 @code{\RemoveAllEmptyStaves}.
776 @code{RhythmicStaff} and @code{VaticanaStaff}.
777 776
778 @warning{A staff is considered empty when it contains only
779 multi-measure rests, rests, skips, spacer rests, or a combination of these
780 elements.}
781 777
782 @lilypond[verbatim,quote,ragged-right] 778 @lilypond[verbatim,quote,ragged-right]
783 \layout { 779 \layout {
784 \context { 780 \context {
785 \Staff 781 \Staff
786 \RemoveEmptyStaves 782 \RemoveEmptyStaves
787 } 783 }
788 } 784 }
789 785
790 \relative << 786 \relative <<
791 \new Staff { 787 \new Staff {
792 e'4 f g a \break 788 e'4 f g a \break
793 b1 \break 789 b1 \break
794 a4 b c2 790 a4 b c2
795 } 791 }
796 \new Staff { 792 \new Staff {
797 c,4 d e f \break 793 c,4 d e f \break
798 R1 \break 794 R1 \break
799 f4 g c,2 795 f4 g c,2
800 } 796 }
801 >> 797 >>
802 @end lilypond 798 @end lilypond
803 799
800 A staff is considered empty when it contains only multi-measure rests,
801 rests, skips, or a combination of these elements. This behavior can be
lemzwerg 2020/03/26 12:50:11 Please use two spaces after a full stop.
802 changed through the @code{keepAliveInterfaces} property. A staff will be
803 removed if none of the graphical objects it contains supports one of the
804 interfaces listed in @code{keepAliveInterfaces}. Thus, keeping staves with
805 rests or multi-measure rests visible can be achieved through adding the
806 @code{rest-interface} to @code{keepAliveInterfaces} -- only staves containing
807 solely skips will then be removed.
lemzwerg 2020/03/26 12:50:10 Maybe s/solely skips/skips only/
808
809 @lilypond[verbatim,quote,ragged-right]
810 keepRests =
811 \applyContext
812 #(lambda (context)
813 (ly:context-set-property! context 'keepAliveInterfaces
814 (append (ly:context-property context 'keepAliveInterfaces)
815 '(rest-interface))))
816
817 \layout {
818 \context {
819 \Score
820 \RemoveAllEmptyStaves
821 \keepRests
822 }
823 }
824
825 <<
826 { c'1 c'1 c'1 }
827 { R1 \break s1 \break R1 }
828 >>
829 @end lilypond
830
804 @cindex ossia 831 @cindex ossia
805 832
806 @noindent 833 @noindent
807 @code{\RemoveAllEmptyStaves} can also be used to create ossia 834 @code{\RemoveAllEmptyStaves} can also be used to create ossia
808 sections for a staff. For details, see @ref{Ossia staves}. 835 sections for a staff. For details, see @ref{Ossia staves}.
809 836
810 837
811 @predefined 838 @predefined
812 @code{\RemoveEmptyStaves}, 839 @code{\RemoveEmptyStaves},
813 @code{\RemoveAllEmptyStaves}. 840 @code{\RemoveAllEmptyStaves}.
(...skipping 16 matching lines...) Expand all
830 857
831 Snippets: 858 Snippets:
832 @rlsr{Staff notation}. 859 @rlsr{Staff notation}.
833 860
834 Internals Reference: 861 Internals Reference:
835 @rinternals{ChordNames}, 862 @rinternals{ChordNames},
836 @rinternals{FiguredBass}, 863 @rinternals{FiguredBass},
837 @rinternals{Lyrics}, 864 @rinternals{Lyrics},
838 @rinternals{Staff}, 865 @rinternals{Staff},
839 @rinternals{VerticalAxisGroup}, 866 @rinternals{VerticalAxisGroup},
840 @rinternals{Staff_symbol_engraver}. 867 @rinternals{Staff_symbol_engraver},
868 @rinternals{Axis_group_engraver}.
841 869
842 @knownissues 870 @knownissues
843 Removing @code{Staff_symbol_engraver} also hides bar lines. If 871 Removing @code{Staff_symbol_engraver} also hides bar lines. If
844 bar line visibility is forced, formatting errors may occur. In 872 bar line visibility is forced, formatting errors may occur. In
845 this case, use the following overrides instead of removing the 873 this case, use the following overrides instead of removing the
846 engraver: 874 engraver:
847 875
848 @example 876 @example
849 \omit StaffSymbol 877 \omit StaffSymbol
850 \override NoteHead.no-ledgers = ##t 878 \override NoteHead.no-ledgers = ##t
(...skipping 778 matching lines...) Expand 10 before | Expand all | Expand 10 after
1629 Notation Reference: 1657 Notation Reference:
1630 @ref{Using break-visibility}, 1658 @ref{Using break-visibility},
1631 @ref{Full measure rests}, 1659 @ref{Full measure rests},
1632 @ref{The set command}. 1660 @ref{The set command}.
1633 1661
1634 Internals Reference: 1662 Internals Reference:
1635 @rinternals{MultiMeasureRest}, 1663 @rinternals{MultiMeasureRest},
1636 @rinternals{MultiMeasureRestNumber}, 1664 @rinternals{MultiMeasureRestNumber},
1637 @rinternals{MultiMeasureRestScript}, 1665 @rinternals{MultiMeasureRestScript},
1638 @rinternals{MultiMeasureRestText}. 1666 @rinternals{MultiMeasureRestText}.
OLDNEW
« no previous file with comments | « no previous file | ly/engraver-init.ly » ('j') | no next file with comments »

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b