Temporal.Music.Volume

This module defines the notion of volume.

Types

data Diap

Diapason defines minimum and maximum bound for Volume level. Field diapLim specifies volume limit. Value diapLim is rendered to highest amplitude and -diapLim is rendered to the lowest amplitude. All values that go beyond the limit are clipped.

Constructors

Diap

Fields

diapRange :: (Double, Double)

diapLim :: Int

Instances

Eq Diap

Show Diap

Default Diap

data Volume

Volume denotes amplitude. It's not a Double for ease of performing some musical transformations, such as making notes louder or using accents. Volume can be converted to Double with function amp.

Constructors

Volume

Fields

volumeDiap :: Diap

volumeAccent :: Accent

volumeLevel :: Level

Instances

Eq Volume

Show Volume

Default Volume

VolumeLike Volume

type Level = Int

Volume levels.

type Accent = Double

Accent defines values between volumeLevel values on logarithmic scale. 1 Accent == 1 volumeLevel 's step.

VolumeLike

class VolumeLike a where

Volume can be used alongside with many other parameters (they can define timbre or pitch). Class VolumeLike provides getters and setters for data types that contain value of type Volume. In Temporal.Music.Score module you can find many functions that are defined in terms of this class. Once you have chosen some note representation you can make an instance for it and use all volume-modifiers.

Methods

setVolume :: Volume -> a -> a

getVolume :: a -> Volume

Instances

VolumeLike Volume

VolumeLike (Drum a)

VolumeLike (Note a)

mapVolume :: VolumeLike a => (Volume -> Volume) -> a -> a

Volume modifier.

Rendering

absVolume :: VolumeLike a => a -> Double

Calculates amplitude for a Volume -like value.

volumeAsDouble :: Volume -> Double

Calculates value of type Volume as coordinate within specidfied diapason. 1 corresponds to maximum bound and 0 corresponds to minimum bound.

diapAt :: Diap -> Double -> Double

Mapps decibels to amplitudes within specified amplitude diapason, 0 turns to lower diapason value and 1 turns to higher diapason value.