Music.Lilypond

Representation

Music expressions

data Music

A Lilypond music expression.

Use the Pretty instance to convert into Lilypond syntax.

Constructors

Rest (Maybe Duration) [PostEvent]

Single rest.

Note Note (Maybe Duration) [PostEvent]

Single note.

Chord [(Note, [ChordPostEvent])] (Maybe Duration) [PostEvent]

Single chord.

Sequential [Music]

Sequential composition.

Simultaneous Bool [Music]

Parallel composition (split voices?).

Repeat Bool Int Music (Maybe (Music, Music))

Repetition (unfold?, times, music, alternative).

Tremolo Int Music

Tremolo (multiplier).

Times Rational Music

Stretch music (multiplier).

Transpose Pitch Pitch Music

Transpose music (from to).

Relative Pitch Music

Use relative octave (octave).

Clef Clef

Clef.

Key Pitch Mode

Key signature.

Time Integer Integer

Time signature.

Breathe (Maybe BreathingSign)

Breath mark (caesura)

Tempo (Maybe String) (Maybe (Duration, Integer))

Tempo mark.

New String (Maybe String) Music

New expression.

Context String (Maybe String) Music

Context expression.

Set String Value

Override String Value

Revert String

Instances

Eq Music

Show Music

IsPitch Music

Pretty Music

VectorSpace Music

AdditiveGroup Music

type Scalar Music = Duration

data Note

Constructors

NotePitch Pitch (Maybe OctaveCheck)

DrumNotePitch (Maybe Duration)

Instances

Eq Note

Show Note

IsPitch Note

Pretty Note

data Clef

Constructors

Treble

Alto

Tenor

Bass

French

Soprano

MezzoSoprano

Baritone

VarBaritone

SubBass

Percussion

Tab

Instances

Eq Clef

Show Clef

Pretty Clef

data Mode

Mode (for key signatures).

Constructors

Major

Minor

Instances

Eq Mode

Show Mode

Pretty Mode

Attributes

data Value

  Value of a \set command. These are simply wrappers for showable things.

For example use (with OverloadedStrings)

Set "Staff.instrumentName" "Violin I"
Set "Staff.instrumentName" 2

to generate

\set Staff.instrumentName = "Violin I"
\set Staff.instrumentName = 2

Instances

Eq Value

Fractional Value

Num Value

Show Value

IsString Value

Pretty Value

toValue :: Show a => a -> Value

toLiteralValue :: String -> Value

As toValue, but not quoting strings. Handy for scheme literals such as #red.

Articulation and dynamics

data PostEvent

Constructors

Articulation Direction Articulation

Dynamics Direction Dynamics

Tie

Glissando

BeginBeam

EndBeam

BeginSlur

EndSlur

BeginPhraseSlur

EndPhraseSlur

BeginCresc

BeginDim

EndCrescDim

Text Direction String

Markup Direction Markup

Instances

Eq PostEvent

Show PostEvent

Pretty PostEvent

data ChordPostEvent

Constructors

Harmonic

Instances

Eq ChordPostEvent

Show ChordPostEvent

Pretty ChordPostEvent

Text

data Articulation

Articulations. These include ornaments.

Constructors

Accent

Marcato

Staccatissimo

Espressivo

Staccato

Tenuto

Portato

Upbow

Downbow

Flageolet

Thumb

LeftHeel

RightHeel

LeftToe

RightToe

Open

Stopped

Turn

ReverseTurn

Trill

Prall

Mordent

PrallPrall

PrallMordent

UpPrall

DownPrall

UpMordent

DownMordent

PrallDown

PrallUp

LinePrall

SignumCongruentiae

ShortFermata

Fermata

LongFermata

VeryLongFermata

Segno

Coda

VarCoda

Instances

Eq Articulation

Show Articulation

Pretty Articulation

data Markup

Constructors

MarkupText String

MarkupList [Markup]

Bold Markup

Box Markup

Caps Markup

DynamicsFont Markup

FingeringFont Markup

Fontsize Double Markup

Huge Markup

Italic Markup

Large Markup

Larger Markup

Magnify Markup

Medium Markup

Roman Markup

Sans Markup

Sub Markup

Super Markup

TextFont Markup

Tiny Markup

TypewriterFont Markup

Upright Markup

Instances

Eq Markup

Show Markup

IsString Markup

Pretty Markup

HasMarkup Markup

class HasMarkup a where

Methods

markup :: a -> Markup

Instances

HasMarkup Markup

HasMarkup a => HasMarkup [a]

Miscellaneous types

data Direction

Constructors

Above

Default

Below

Instances

Eq Direction

Ord Direction

Show Direction

Default Direction

Pretty Direction

data OctaveCheck

Constructors

OctaveCheck

Instances

Eq OctaveCheck

Show OctaveCheck

data BreathingSign

Constructors

RightVarComma

StraightCaesura

CurvedCaesura

Instances

Eq BreathingSign

Show BreathingSign

Time

newtype Duration

Notated time in fractions, in [2^^i | i <- [-10..3]].

Constructors

Duration

Fields

getDuration :: Rational

Instances

Enum Duration

Eq Duration

Fractional Duration

Num Duration

Ord Duration

Real Duration

RealFrac Duration

Show Duration

Pretty Duration

Pitch

newtype Pitch

Constructors

Pitch

Fields

getPitch :: (PitchName, Accidental, Octaves)

Instances

Eq Pitch

Ord Pitch

Show Pitch

IsPitch Pitch

Pretty Pitch

data PitchName

Constructors

C

D

E

F

G

A

B

Instances

Enum PitchName

Eq PitchName

Ord PitchName

Show PitchName

type Accidental = Int

For double flat -2, flat -1, natural 0, sharp 1 and double sharp 2.

type Octaves = Int

Number of octaves raised (positive) or flattened (negative).

Constructing Lilypond expresions

Notes and rests

rest :: Music

Construct a rest of default duration 1/4.

Use the VectorSpace methods to change duration.

note :: Note -> Music

Construct a note of default duration 1/4.

Use the VectorSpace methods to change duration.

chord :: [Note] -> Music

Construct a chord of default duration 1/4.

Use the VectorSpace methods to change duration.

chordHarm :: [(Note, Bool)] -> Music

chordWithPost :: [(Note, [ChordPostEvent])] -> Music

Composition

sequential :: Music -> Music -> Music

simultaneous :: Music -> Music -> Music

Post events

addPost :: PostEvent -> Music -> Music

addText :: String -> Music -> Music

addMarkup :: HasMarkup a => a -> Music -> Music

addDynamics :: Dynamics -> Music -> Music

addArticulation :: Articulation -> Music -> Music

addText' :: Direction -> String -> Music -> Music

addMarkup' :: HasMarkup a => Direction -> a -> Music -> Music

addDynamics' :: Direction -> Dynamics -> Music -> Music

addArticulation' :: Direction -> Articulation -> Music -> Music

Curves and lines

beginTie :: Music -> Music

beginGlissando :: Music -> Music

beginBeam :: Music -> Music

endBeam :: Music -> Music

beginSlur :: Music -> Music

endSlur :: Music -> Music

beginPhraseSlur :: Music -> Music

endPhraseSlur :: Music -> Music

beginCresc :: Music -> Music

endCresc :: Music -> Music

beginDim :: Music -> Music

endDim :: Music -> Music

Marks

addAccent :: Music -> Music

addMarcato :: Music -> Music

addStaccatissimo :: Music -> Music

addEspressivo :: Music -> Music

addStaccato :: Music -> Music

addTenuto :: Music -> Music

addPortato :: Music -> Music

addUpbow :: Music -> Music

addDownbow :: Music -> Music

addFlageolet :: Music -> Music

addThumb :: Music -> Music

addLeftHeel :: Music -> Music

addRightHeel :: Music -> Music

addLeftToe :: Music -> Music

addRightToe :: Music -> Music

addOpen :: Music -> Music

addStopped :: Music -> Music

addTurn :: Music -> Music

addReverseTurn :: Music -> Music

addTrill :: Music -> Music

addPrall :: Music -> Music

addMordent :: Music -> Music

addPrallPrall :: Music -> Music

addPrallMordent :: Music -> Music

addUpPrall :: Music -> Music

addDownPrall :: Music -> Music

addUpMordent :: Music -> Music

addDownMordent :: Music -> Music

addPrallDown :: Music -> Music

addPrallUp :: Music -> Music

addLinePrall :: Music -> Music

addSignumCongruentiae :: Music -> Music

addShortFermata :: Music -> Music

addFermata :: Music -> Music

addLongFermata :: Music -> Music

addVeryLongFermata :: Music -> Music

addSegno :: Music -> Music

addCoda :: Music -> Music

addVarCoda :: Music -> Music

Utility

foldMusic :: (Music -> Music) -> Music -> Music

removeSingleChords :: Music -> Music