FRP.Rhine.Clock.Realtime.Audio

Documentation

data AudioClock (rate :: AudioRate) (bufferSize :: Nat)

A clock for audio analysis and synthesis. It internally processes samples in buffers of size bufferSize, (the programmer does not have to worry about this), at a sample rate of rate (of type AudioRate). Both these parameters are in the type signature, so it is not possible to compose signals with different buffer sizes or sample rates.

After processing a buffer, the clock will wait the remaining time until the next buffer must be processed, using system UTC time. The tag of the clock specifies whether the attempt to finish the last buffer in real time was successful. A value of Nothing represents success, a value of Just double represents a lag of double seconds.

Constructors

AudioClock

Instances

(MonadIO m, KnownNat bufferSize, AudioClockRate rate) => Clock m (AudioClock rate bufferSize)

Associated Types

type TimeDomainOf (AudioClock rate bufferSize) :: *

type Tag (AudioClock rate bufferSize) :: *

Methods

startClock :: AudioClock rate bufferSize -> m (MSF m () (TimeDomainOf (AudioClock rate bufferSize), Tag (AudioClock rate bufferSize)), TimeDomainOf (AudioClock rate bufferSize))

type TimeDomainOf (AudioClock rate bufferSize)

type TimeDomainOf (AudioClock rate bufferSize) = UTCTime

type Tag (AudioClock rate bufferSize)

type Tag (AudioClock rate bufferSize) = Maybe Double

data AudioRate

Rates at which audio signals are typically sampled.

Constructors

Hz44100

Hz48000

Hz96000

data PureAudioClock (rate :: AudioRate)

A side-effect free clock for audio synthesis and analysis. The sample rate is given by rate (of type AudioRate). Since this clock does not wait for the completion of buffers, the producer or the consumer of the signal has the obligation to synchronise the signal with the system clock, if realtime is desired. Otherwise, the clock is also suitable e.g. for batch processing of audio files.

Constructors

PureAudioClock

Instances

(Monad m, PureAudioClockRate rate) => Clock m (PureAudioClock rate)

Associated Types

type TimeDomainOf (PureAudioClock rate) :: *

type Tag (PureAudioClock rate) :: *

Methods

startClock :: PureAudioClock rate -> m (MSF m () (TimeDomainOf (PureAudioClock rate), Tag (PureAudioClock rate)), TimeDomainOf (PureAudioClock rate))

type TimeDomainOf (PureAudioClock rate)

type TimeDomainOf (PureAudioClock rate) = Double

type Tag (PureAudioClock rate)

type Tag (PureAudioClock rate) = ()

pureAudioClockF :: PureAudioClockF rate