Sound.Conductive.Generator

This is a module for creating and manipulating mutable generators. Generators contain a source finite list and a counter. Items are retrieved from the list one at a time, and the list loops when the last item has been given.

Documentation

newGenerator :: [a] -> IO (Generator a)

creates a new Generator from the given source list.

swapGenerator :: Generator a -> [a] -> IO [a]

swaps the source of a Generator

newCounter :: IO (IORef Int)

getCount :: Generator a -> IO Int

returns the current value of a counter in a Generator

getGeneratorSource :: Generator a -> IO [a]

returns the source of a Generator

resetCounter :: Generator a -> IO ()

resets the counter of a Generator

next :: Generator a -> IO a

returns the next item from a Generator

nextWithOffset :: Int -> Generator a -> IO a

adds the first argument to the counter value of a Generator and returns the corresponding item from the source

nexts :: [Generator b] -> IO [b]

given a list of Generators, returns a list containing the next item from all of them

withNext :: Generator a -> (a -> b) -> IO b

runs a pure function on the next item from a Generator

newGeneratorStore :: Ord t => (t, [a]) -> IO (Map t (Generator a))

creates a Map for storing Generators in

defaultGeneratorStore :: IO (Map [Char] (Generator Double))

the defaultGeneratorStore used by the defaultMusicalEnvironment