Update README

This commit is contained in:
Eric Teunis de Boone 2023-08-10 13:47:09 +02:00
parent a627bafd2a
commit 3b3844d7cb
1 changed files with 14 additions and 50 deletions

View File

@ -1,19 +1,25 @@
# Lilydrum (pipeband-drumming notation)
Somehow, the drums part in lilypond does not cover a notation with only right and left hands
(also known as Swiss style drum notation).
That is, right is above the line and left is below it.
In the same manner as the bagpipe.ly file included with lilypond, flams and drags are defined as a shortcut.
[Lilypond](http://lilypond.org) does not cover drum notation for pipebands out of the box.
That is, right is above the line and left is below it. \
In the same manner as the bagpipe.ly file included with Lilypond, this library allows to easily use this notation with opt-in elements.
See the [cheatsheet](./cheatsheet.pdf) ([ly](./cheatsheet.ly), [pdf](./cheatsheet.pdf)) for a handful of definitions.
There has been such a lilypond include file earlier, made by Simon Froger
(which includes all of the above).
This repository builds on work.
The original file can still be found at [http://lsr.di.unimi.it/LSR/Snippet?id=970](http://lsr.di.unimi.it/LSR/Snippet?id=970).
![preview of the score](./example.preview.png) \
*(see [./example.ly](./example.ly) for fully annotated code and its [score](./example.pdf))*
There has been such a Lilypond include file earlier, made by Simon Froger. This repository builds on his work.
The ~~original~~ (updated) file can be found at [http://lsr.di.unimi.it/LSR/Snippet?id=970](http://lsr.di.unimi.it/LSR/Snippet?id=970).
[His website (French) can be found here](https://simonfroger.wordpress.com/lilypond/caisse-claire-ecossaise/)
This repository has also been converted into a [lyp](https://github.com/noteflakes/lyp) package: [lyp/lilydrum](https://github.com/lyp-packages/lilydrum).
*shameless plug:* \
An example of scores typeset with this library can be found in
[kastdeur/pipeband-music](https://github.com/kastdeur/pipeband-music)
or
[on my website (pdf)](https://deboone.nl/scores/pipeband).
## How to use
Add the following line to include the definitions for use in your document:
@ -53,48 +59,6 @@ To make a pipeband drumstaff (a `DrumStaff` with a few specific changes) you can
*You do not need to use PipeBandDrumStaff to use the music definitions.*
## Example piece
*(see [./example.ly](./example.ly) for fully annotated code and its [score](./example.pdf))*
![preview of the score](./example.preview.png)
This was generated by the following code.
```lilypond
\include "lilydrum.ly"
\header { title = "Standards 6/8" }
\score {
\new PipeBandDrumStaff {
\drummode {
\time 6/8
\repeat volta 2 {
\partial 8 d8:32( |
g8.)[ g16 \drag d8] d8.[ d16 \drag g8] |
g8.[ \drag d16 d8] d8.[ d16 \drag g8] |
\tutti {
\flam d8. d16 g8 d4.:32( |
d8.) g16 d8 \flam g4
}
d8:32( |
g8.)[ g16 \drag d8] d8.[ d16 \drag g8] |
g8.[ \drag d16 d8] d8.[ d16 \drag g8] |
\tutti{
\flam d8. d16:64( d8) \flam d8. d16 \flam g8 |
d8.:32( d16) \flam g8 \flam d4
}
}
}
}
}
```
### Embellishments (Side Drum)
Flams and Drags can be added using `\flam` and `\drag`.
They can determine whether to be left or right by themselves for simple expressions.