Customizing the chord grid style - Revision history

Lemzwerg at 13:17, 16 December 2025

2025-12-16T13:17:50Z

← Older revision		Revision as of 13:17, 16 December 2025
Line 1:		Line 1:
	Custom divisions of chord squares can be defined through the <code>measure-division-lines-alist</code> and <code>measure-division-chord-placement-alist</code> properties of <code>ChordSquare</code>. These are both alists. Their keys are measure divisions, namely lists which give the fraction of the measure that each chord (or rest, or skip) represents. More precisely, a measure division alist is made of positive, exact numbers adding up to 1, for example: <code>'(1/2 1/4 1/4)</code>. The exactness requirement means that, e.g., <code>1/2</code> is valid but not <code>0.5</code>.		Custom divisions of chord squares can be defined through the <code>measure-division-lines-alist</code> and <code>measure-division-chord-placement-alist</code> properties of <code>ChordSquare</code>. These are both alists. Their keys are measure divisions, namely lists which give the fraction of the measure that each chord (or rest, or skip) represents. More precisely, a measure division alist is made of positive, exact numbers adding up to 1, for example: <code>'(1/2 1/4 1/4)</code>. The exactness requirement means that, e.g., <code>1/2</code> is valid but not <code>0.5</code>.

	The values in <code>measure-division-lines-alist</code> are lists of lines, which are represented as <code>(<var>x1</var> <var>y1</var> <var>x2</var> <var>y2</var>)</code>. The line starts at the point <code>(<var>x1</var> . <var>y1</var>)</code> and ends at <code>(<var>x2</var> . <var>y2</var>)</code>. Coordinates are expressed in the [-1, 1] scale relative to the extent of the square.		The values in <code>measure-division-lines-alist</code> are lists of lines, which are represented as <code>(<var>x1</var> <var>y1</var> <var>x2</var> <var>y2</var>)</code>. The line starts at the point <code>(<var>x1</var> . <var>y1</var>)</code> and ends at <code>(<var>x2</var> . <var>y2</var>)</code>. Coordinates are expressed in the [-1, 1] scale relative to the extent of the square.

	The values in <code>measure-division-chord-placement-alist</code> are lists of <code>(<var>x</var> . <var>y</var>)</code> pairs giving the placement of the respective chords.		The values in <code>measure-division-chord-placement-alist</code> are lists of <code>(<var>x</var> . <var>y</var>)</code> pairs giving the placement of the respective chords.

	This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.		This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.

Lemzwerg: New category

2025-11-21T23:20:59Z

New category

← Older revision		Revision as of 23:20, 21 November 2025
Line 29:		Line 29:

	[[Category:Chords]]		[[Category:Chords]]
	[[Category:Included in the official documentation]][[Category:Snippet]]		[[Category:Included in the official documentation]]
			[[Category:Snippet]]

Lemzwerg at 22:51, 21 November 2025

2025-11-21T22:51:29Z

← Older revision		Revision as of 22:51, 21 November 2025
Line 29:		Line 29:

	[[Category:Chords]]		[[Category:Chords]]
	[[Category:Included in the official documentation]]		[[Category:Included in the official documentation]][[Category:Snippet]]

Lemzwerg at 05:25, 19 November 2025

2025-11-19T05:25:30Z

← Older revision		Revision as of 05:25, 19 November 2025
Line 1:		Line 1:
	Custom divisions of chord squares can be defined through the <code>measure-division-lines-alist</code> and <code>measure-division-chord-placement-alist</code> properties of <code>ChordSquare</code>. These are both alists. Their keys are measure divisions, namely lists which give the fraction of the measure that each chord (or rest, or skip) represents. More precisely, a measure division alist is made of positive, exact numbers adding up to 1, for example: <code>'(1/2 1/4 1/4)</code>. The exactness requirement means that, e.g., <code>1/2</code> is valid but not <code>0.5</code>.		Custom divisions of chord squares can be defined through the <code>measure-division-lines-alist</code> and <code>measure-division-chord-placement-alist</code> properties of <code>ChordSquare</code>. These are both alists. Their keys are measure divisions, namely lists which give the fraction of the measure that each chord (or rest, or skip) represents. More precisely, a measure division alist is made of positive, exact numbers adding up to 1, for example: <code>'(1/2 1/4 1/4)</code>. The exactness requirement means that, e.g., <code>1/2</code> is valid but not <code>0.5</code>.

	The values in <code>measure-division-lines-alist</code> are lists of lines, which are represented as <code>(<~~/code><code~~>x1</~~code><code> </code~~><~~code~~>y1</~~code><code> </code~~><~~code~~>x2</~~code><code> </code~~><~~code~~>y2</~~code><code~~>)</code>. The line starts at the point <code>(<~~/code><code~~>x1</~~code><code~~> . <~~/code><code~~>y1</~~code><code~~>)</code> and ends at <code>(<~~/code><code~~>x2</~~code><code~~> . <~~/code><code~~>y2</~~code><code~~>)</code>. Coordinates are expressed in the [-1, 1] scale relative to the extent of the square.		The values in <code>measure-division-lines-alist</code> are lists of lines, which are represented as <code>(<var>x1</var> <var>y1</var> <var>x2</var> <var>y2</var>)</code>. The line starts at the point <code>(<var>x1</var> . <var>y1</var>)</code> and ends at <code>(<var>x2</var> . <var>y2</var>)</code>. Coordinates are expressed in the [-1, 1] scale relative to the extent of the square.

	The values in <code>measure-division-chord-placement-alist</code> are lists of <code>(<~~/code><code~~>x</~~code><code~~> . <~~/code><code~~>y</~~code><code~~>)</code> pairs giving the placement of the respective chords.		The values in <code>measure-division-chord-placement-alist</code> are lists of <code>(<var>x</var> . <var>y</var>)</code> pairs giving the placement of the respective chords.

	This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.		This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.

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:47:33Z

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:47, 16 November 2025
Line 7:		Line 7:
	This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.		This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.

	<lilypond version="2.24.0">		<lilypond version="2.24">
	\paper {		\paper {
	line-width = 10\cm		line-width = 10\cm

Jean Abou Samra: Import snippet from LSR

2025-10-26T22:51:35Z

Import snippet from LSR

New page

Custom divisions of chord squares can be defined through the <code>measure-division-lines-alist</code> and <code>measure-division-chord-placement-alist</code> properties of <code>ChordSquare</code>. These are both alists. Their keys are measure divisions, namely lists which give the fraction of the measure that each chord (or rest, or skip) represents. More precisely, a measure division alist is made of positive, exact numbers adding up to 1, for example: <code>'(1/2 1/4 1/4)</code>. The exactness requirement means that, e.g., <code>1/2</code> is valid but not <code>0.5</code>.

The values in <code>measure-division-lines-alist</code> are lists of lines, which are represented as <code>(</code><code>x1</code><code> </code><code>y1</code><code> </code><code>x2</code><code> </code><code>y2</code><code>)</code>. The line starts at the point <code>(</code><code>x1</code><code> . </code><code>y1</code><code>)</code> and ends at <code>(</code><code>x2</code><code> . </code><code>y2</code><code>)</code>. Coordinates are expressed in the [-1, 1] scale relative to the extent of the square.

The values in <code>measure-division-chord-placement-alist</code> are lists of <code>(</code><code>x</code><code> . </code><code>y</code><code>)</code> pairs giving the placement of the respective chords.

This example defines a peculiar chord grid style that has a rule for measures divided in three equal parts.

<lilypond version="2.24.0">
\paper {
line-width = 10\cm
ragged-right = ##f
}

\new ChordGrid \with {
\override ChordSquare.measure-division-lines-alist =
#'(((1) . ())
((1/3 1/3 1/3) . ((-1 -0.4 0 1) (0 -1 1 0.4))))
\override ChordSquare.measure-division-chord-placement-alist =
#'(((1) . ((0 . 0)))
((1/3 1/3 1/3) . ((-0.7 . 0.5) (0 . 0) (0.7 . -0.5))))
}
\chordmode {
\time 3/4
c2.
c4 c4 c4
}
</lilypond>

[[Category:Chords]]
[[Category:Included in the official documentation]]