Using the whiteout property - Revision history

Lemzwerg at 14:09, 12 December 2025

2025-12-12T14:09:05Z

← Older revision		Revision as of 14:09, 12 December 2025
Line 14:		Line 14:
	</lilypond>		</lilypond>

			[[Category:Editorial annotations]]
	[[Category:Expressive marks]]		[[Category:Expressive marks]]
	~~[[Category:Editorial annotations]]~~
	[[Category:Included in the official documentation]]		[[Category:Included in the official documentation]]
	[[Category:Snippet]]		[[Category:Snippet]]

Lemzwerg at 15:06, 3 December 2025

2025-12-03T15:06:49Z

← Older revision		Revision as of 15:06, 3 December 2025
Line 1:		Line 1:
	Any graphical object can be printed over a white background to mask parts of objects that lie beneath. This can be useful to improve the appearance of collisions in complex situations when repositioning objects is impractical. It is necessary to explicitly set the <code>layer</code> property to control which objects are masked by the white background.		Any graphical object can be printed over a white background to mask parts of objects that lie beneath. This can be useful to improve the appearance of collisions in complex situations when repositioning objects is impractical. It is necessary to explicitly set the <code>layer</code> property to control which objects are masked by the white background.

	In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default ~~layer 1~~, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.		In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default layer 1, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.

	<lilypond version="2.24">		<lilypond version="2.24">

Lemzwerg: New category

2025-11-21T23:31:20Z

New category

← Older revision		Revision as of 23:31, 21 November 2025
Line 16:		Line 16:
	[[Category:Expressive marks]]		[[Category:Expressive marks]]
	[[Category:Editorial annotations]]		[[Category:Editorial annotations]]
	[[Category:Included in the official documentation]][[Category:Snippet]]		[[Category:Included in the official documentation]]
			[[Category:Snippet]]

Lemzwerg at 23:02, 21 November 2025

2025-11-21T23:02:46Z

← Older revision		Revision as of 23:02, 21 November 2025
Line 16:		Line 16:
	[[Category:Expressive marks]]		[[Category:Expressive marks]]
	[[Category:Editorial annotations]]		[[Category:Editorial annotations]]
	[[Category:Included in the official documentation]]		[[Category:Included in the official documentation]][[Category:Snippet]]

Jean Abou Samra: Replace version="2.24.0" with version="2.24" now that the LilyWiki extension supports auto-selecting the latest release in a stable series

2025-11-16T18:54:31Z

Replace version="2.24.0" with version="2.24" now that the LilyWiki extension supports auto-selecting the latest release in a stable series

← Older revision		Revision as of 18:54, 16 November 2025
Line 3:		Line 3:
	In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default layer 1, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.		In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default layer 1, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.

	<lilypond version="2.24.0">		<lilypond version="2.24">
	{		{
	\override Score.StaffSymbol.layer = 4		\override Score.StaffSymbol.layer = 4

Jean Abou Samra: Import snippet from LSR

2025-10-26T22:48:37Z

Import snippet from LSR

New page

Any graphical object can be printed over a white background to mask parts of objects that lie beneath. This can be useful to improve the appearance of collisions in complex situations when repositioning objects is impractical. It is necessary to explicitly set the <code>layer</code> property to control which objects are masked by the white background.

In this example the collision of the tie with the time signature is improved by masking out the part of the tie that crosses the time signature, setting the <code>whiteout</code> property of <code>TimeSignature</code>. To do this, <code>TimeSignature</code> is moved to a layer above <code>Tie</code>, which is left in the default layer 1, and <code>StaffSymbol</code> is moved to a layer above <code>TimeSignature</code> so it is not masked.

<lilypond version="2.24.0">
{
\override Score.StaffSymbol.layer = 4
\override Staff.TimeSignature.layer = 3
b'2 b'~
\once \override Staff.TimeSignature.whiteout = ##t
\time 3/4
b' r4
}
</lilypond>

[[Category:Expressive marks]]
[[Category:Editorial annotations]]
[[Category:Included in the official documentation]]