Music.Score.Meta.Title

Provides various forms of title, subtitle etc. and related meta-data.

Title type

data Title

A title is a sequence of String values, representing the name of a work or part of a work. An arbitrary depth of title sections can be used.

Title is an instance of IsString and can be used with the OverloadedStrings extension as follows:

title  "Le Nozze di Figaro"

subtitle "Atto primo"
subsubtitle "Scena I"
subsubtitle "Scena II"
...

subtitle "Atto secundo"
...

Instances

Show Title

IsString Title

Monoid Title

Semigroup Title

Typeable * Title

Creating and modifying

denoteTitle :: Title -> Title

Denote a title to a lower level, i.e title becomes subtitle, subtitle becomes subsubtitle etc.

getTitle :: Title -> [String]

Extract the title as a descending list of title levels (i.e. title, subtitle, subsubtitle...).

getTitleAt :: Title -> Int -> Maybe String

Extract the title of the given level. Semantic function.

Adding titles to scores

title :: (HasMeta a, HasPosition a) => Title -> a -> a

Set title of the given score.

titleDuring :: HasMeta a => Span -> Title -> a -> a

Set title of the given part of a score.

subtitle :: (HasMeta a, HasPosition a) => Title -> a -> a

Set subtitle of the given score.

subtitleDuring :: HasMeta a => Span -> Title -> a -> a

Set subtitle of the given part of a score.

subsubtitle :: (HasMeta a, HasPosition a) => Title -> a -> a

Set subsubtitle of the given score.

subsubtitleDuring :: HasMeta a => Span -> Title -> a -> a

Set subsubtitle of the given part of a score.

Extracting titles

withTitle :: (Title -> Score a -> Score a) -> Score a -> Score a

Extract the title in from the given score.