Copyright	(c) Hans Hoglund 2012
License	BSD-style
Maintainer	hans@hanshoglund.se
Stability	experimental
Portability	portable
Safe Haskell	None
Language	Haskell2010

Data.Music.MusicXml.Simple

Contents

Score and parts
Top-level attributes
Backup and forward
Notes
Pitch transformations
- Glissando
- Slides
Time transformations
- Accelerando and ritardando
- Fermatas and breaks
Articulation
Dynamics
Text
Folds and maps

Description

Provides smart constructors for the MusicXML representation.

Synopsis

Documentation

module Data.Music.MusicXml

Score and parts

Basic constructors

fromPart :: String -> String -> String -> [Music] -> Score Source

Create a single-part score.

fromPart title composer partName measures

Example:

 fromPart "Suite" "Bach" "Cello solo" []

fromParts :: String -> String -> PartList -> [[Music]] -> Score Source

Create a multi-part score.

fromParts title composer partList parts

Example:

 fromParts "4'33" "Cage" (partList ["Violin", "Viola", "Cello"]) [[]]

Part lists

partList :: [String] -> PartList Source

Create a part list from instrument names.

partListDisplay :: [(String, String)] -> PartList Source

Create a part list from instrument names and displayed names (some applications need the name to be something specific, so use displayed name to override).

partListAbbr :: [(String, String)] -> PartList Source

Create a part list from instrument names and abbreviations.

bracket :: PartList -> PartList Source

Enclose the given parts in a bracket.

brace :: PartList -> PartList Source

Enclose the given parts in a brace.

Measures

measure :: [Music] -> Music Source

Convenient synonym for mconcat, allowing us to write things like

measure [
   beam [ 
       note c  (1/8), 
       note d  (1/8),
       note e  (1/8),
       note f  (1/8) 
   ],
   tuplet 3 2 [ 
       note g  (1/4),
       note a  (1/4),
       note b  (1/4) 
   ]
]

bar :: [Music] -> Music Source

Convenient synonym for mconcat.

Top-level attributes

Pitch

trebleClef :: Music Source

altoClef :: Music Source

bassClef :: Music Source

defaultClef :: Music Source

clef :: ClefSign -> Line -> Music Source

Create a clef.

defaultKey :: Music Source

key :: Fifths -> Mode -> Music Source

Create a key signature.

Time

defaultDivisions :: Music Source

Set the tick division to the default value.

divisions :: Divs -> Music Source

Define the number of ticks per quarter note.

commonTime :: Music Source

cutTime :: Music Source

time :: Beat -> BeatType -> Music Source

Create a time signature.

staves :: Int -> Music Source

Tempo

metronome :: NoteVal -> Tempo -> Music Source

Create a metronome mark.

metronome' :: NoteVal -> Bool -> Tempo -> Music Source

Create a metronome mark.

Backup and forward

backup :: Duration -> Music Source

forward :: Duration -> Music Source

Notes

Basic constructors

rest :: NoteVal -> Music Source

Create a rest.

rest (1/4)
rest (3/8)
rest quarter
rest (dotted eight)

note :: Pitch -> NoteVal -> Music Source

Create a single note.

note c   (1/4)
note fs_ (3/8)
note c   quarter
note (c + pure fifth) (dotted eight)

chord :: [Pitch] -> NoteVal -> Music Source

Create a chord.

chord [c,eb,fs_] (3/8)
chord [c,d,e] quarter
chord [c,d,e] (dotted eight)

Voice

setVoice :: Int -> Music -> Music Source

Duration

dot :: Music -> Music Source

tuplet :: Int -> Int -> Music -> Music Source

setNoteVal :: NoteVal -> Music -> Music Source

separateDots :: NoteVal -> (NoteVal, Int) Source

Beams

beam :: Music -> Music Source

beginBeam :: Music -> Music Source

continueBeam :: Music -> Music Source

endBeam :: Music -> Music Source

Ties

beginTie :: Music -> Music Source

endTie :: Music -> Music Source

Note heads

setNoteHead :: NoteHead -> Music -> Music Source

Notations

addNotation :: Notation -> Music -> Music Source

Pitch transformations

Glissando

beginGliss :: Music -> Music Source

endGliss :: Music -> Music Source

Slides

beginSlide :: Music -> Music Source

endSlide :: Music -> Music Source

Time transformations

Accelerando and ritardando

Fermatas and breaks

fermata :: FermataSign -> Music -> Music Source

breathMark :: Music -> Music Source

caesura :: Music -> Music Source

Articulation

addTechnical :: Technical -> Music -> Music Source

addArticulation :: Articulation -> Music -> Music Source

Technical

upbow :: Music -> Music Source

downbow :: Music -> Music Source

harmonic :: Music -> Music Source

openString :: Music -> Music Source

Slurs

slur :: Music -> Music Source

beginSlur :: Music -> Music Source

endSlur :: Music -> Music Source

Staccato and tenuto

staccato :: Music -> Music Source

tenuto :: Music -> Music Source

spiccato :: Music -> Music Source

staccatissimo :: Music -> Music Source

Accents

accent :: Music -> Music Source

strongAccent :: Music -> Music Source

Miscellaneous

scoop :: Music -> Music Source

plop :: Music -> Music Source

doit :: Music -> Music Source

falloff :: Music -> Music Source

stress :: Music -> Music Source

unstress :: Music -> Music Source

Ornaments

trill :: Music -> Music Source

turn :: Bool -> Bool -> Music -> Music Source

shake :: Music -> Music Source

mordent :: Bool -> Music -> Music Source

tremolo :: Int -> Music -> Music Source

Dynamics

Crescendo and diminuendo

cresc :: Music -> Music Source

dim :: Music -> Music Source

beginCresc :: Music Source

endCresc :: Music Source

beginDim :: Music Source

endDim :: Music Source

Dynamic levels

dynamic :: Dynamics -> Music Source

Both

crescFrom :: Dynamics -> Music -> Music Source

crescTo :: Dynamics -> Music -> Music Source

crescFromTo :: Dynamics -> Dynamics -> Music -> Music Source

dimFrom :: Dynamics -> Music -> Music Source

dimTo :: Dynamics -> Music -> Music Source

dimFromTo :: Dynamics -> Dynamics -> Music -> Music Source

Text

text :: String -> Music Source

rehearsal :: String -> Music Source

segno :: Music Source

coda :: Music Source

Folds and maps

mapMusic :: (Attributes -> Attributes) -> (Note -> Note) -> (Direction -> Direction) -> Music -> Music Source

foldMusic :: Monoid m => (Attributes -> r) -> (Note -> r) -> (Direction -> r) -> (r -> m) -> Music -> m Source