-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Helps to create more complex experimental music from a file (especially timbre).
--   
--   Uses SoX inside.
@package algorithmic-composition-complex
@version 0.2.0.0


-- | Helps to create experimental music from a file (or its part). Uses SoX
--   inside. Is more complicated than algorithmic-composition-basic and
--   uses its functionality.
module Composition.Sound.Complex

-- | Tesing variant of the <a>soundGen3G</a> with predefined three last
--   functional arguments.
testSoundGen2G :: FilePath -> Float -> String -> IO ()

-- | Generates a sequence of sounds with changing timbre. Uses several
--   functions as parameters.
soundGen3G :: FilePath -> Float -> String -> ((Float, Float) -> Float -> (Float -> OvertonesO) -> OvertonesO) -> ((Float, Float) -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Uses several
--   functions as parameters. Unlike the <a>soundGen3G</a>, the last two
--   functions as arguments for their first argument have not
--   (<a>Float</a>,<a>Float</a>), but <a>Vector</a> of them so are applied
--   to <a>OvertonesO</a>. To provide a generalized functionality, it uses
--   two additional functions <tt>freq0 :: Int -&gt; OvertonesO</tt> and
--   <tt>proj :: OvertonesO -&gt; OvertonesO</tt> to define the first
--   element to which are applied <tt>gAdds</tt> and <tt>gRems</tt> and the
--   way to obtain a internal <a>OvertonesO</a>. Besides, it lifts notes
--   into specified with the first two <a>Int</a> arguments enku (see
--   <a>liftInEnku</a>). The <a>Float</a> argument is a average duration of
--   the sounds.
soundGen3G_O :: Int -> Int -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Is a generalized
--   version of the <a>soundGen3G_O</a>, instead of predefined conversion
--   function inside, it uses a user-defined one.
--   
--   <pre>
--   soundGen3G_O = soundGen3G_O2 
--   </pre>
--   
--   with the first argument
--   
--   <pre>
--   conversionFII (f0,fA1,fR1) = map (\(j, r) -&gt; (GHC.Arr.unsafeAt notes (snd r),
--   </pre>
--   
--   <pre>
--   case fst r of
--   </pre>
--   
--   <pre>
--   0 -&gt; f0
--   </pre>
--   
--   <pre>
--   1 -&gt; fA1 j
--   </pre>
--   
--   <pre>
--   2 -&gt; fA1 j
--   </pre>
--   
--   <pre>
--   3 -&gt; fA1 j
--   </pre>
--   
--   <pre>
--   4 -&gt; fA1 j
--   </pre>
--   
--   <pre>
--   _ -&gt; fR1 j)) . zip [0..]
--   </pre>
soundGen3G_O2 :: ((Float -> OvertonesO, Int -> Float -> OvertonesO, Int -> Float -> OvertonesO) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> Int -> Int -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Is a generalized
--   version of the <a>soundGen3G_O2</a>, but for the conversion function
--   conversionFII as its tuple first argument uses not the tuple of the
--   three functions, but a tuple of three lists of functions of the
--   respective types, that allows to specify more comlex behaviour and
--   different variants inside the function itself, not its inner function
--   parts. <a>Vector</a> as a data type is used instead of more common
--   list because it has similar functionality and besides provides easier
--   and quicker access to its elements. So these are the following vectors
--   of functions: <tt>vf :: Vector (Float -&gt; OvertonesO)</tt> (no
--   changing a function for timbre generation), <tt>vfA :: Vector (Int
--   -&gt; Float -&gt; OvertonesO)</tt> (for "adding" overtones to the
--   function for timbre generation), and <tt>vfR :: Vector (Int -&gt;
--   Float -&gt; OvertonesO</tt> (for "removing" overtones from the
--   function for timbre generation).
soundGen3G_O2G :: (([Float -> OvertonesO], [Int -> Float -> OvertonesO], [Int -> Float -> OvertonesO]) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> [Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> Int -> Int -> Float -> FilePath -> Float -> String -> IO ()

-- | Tesing variant of the <a>soundGen3GMN</a> with predefined last
--   functional arguments.
testSoundGen2GMN :: Int -> Int -> FilePath -> Float -> String -> IO ()

-- | Generates a sequence of sounds with changing timbre. Uses several
--   functions as parameters. To specify how many sounds the resulting
--   files will provide, you use first two <a>Int</a> arguments, the first
--   of which is a number of dropped elements for <a>readFileDoubles</a>
--   and the second one is a number of produced sounds (and, respectively,
--   number of taken elements).
soundGen3GMN :: Int -> Int -> FilePath -> Float -> String -> ((Float, Float) -> Float -> (Float -> OvertonesO) -> OvertonesO) -> ((Float, Float) -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Uses several
--   functions as parameters. To specify how many sounds the resulting
--   files will provide, you use first two <a>Int</a> arguments, the first
--   of which is a number of dropped elements for <a>readFileDoubles</a>
--   and the second one is a number of produced sounds (and, respectively,
--   number of taken elements).
soundGen3G_OMN :: Int -> Int -> Int -> Int -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Is a generalized
--   version of the <a>soundGen3G_O2</a>. To specify how many sounds the
--   resulting files will provide, you use first two <a>Int</a> arguments,
--   the first of which is a number of dropped elements for
--   <a>readFileDoubles</a> and the second one is a number of produced
--   sounds (and, respectively, number of taken elements).
soundGen3G_O2MN :: Int -> Int -> ((Float -> OvertonesO, Int -> Float -> OvertonesO, Int -> Float -> OvertonesO) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> Int -> Int -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generates a sequence of sounds with changing timbre. Is a generalized
--   version of the <a>soundGen3G_O2G</a>. To specify how many sounds the
--   resulting files will provide, you use first two <a>Int</a> arguments,
--   the first of which is a number of dropped elements for
--   <a>readFileDoubles</a> and the second one is a number of produced
--   sounds (and, respectively, number of taken elements).
soundGen3G_O2GMN :: Int -> Int -> (([Float -> OvertonesO], [Int -> Float -> OvertonesO], [Int -> Float -> OvertonesO]) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> [Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> Int -> Int -> Float -> FilePath -> Float -> String -> IO ()

-- | For the given parameters generates a single sound with overtones or
--   pause depending on the sign of the second element in the tuple of
--   <a>Float</a>: if it is greater than zero then the sound is generated,
--   if less -- the silence (pause), if it is equal to zero then it prints
--   an informational message about a non-standard situation.
h1 :: (Float -> OvertonesO) -> (Float, Float) -> IO ()

-- | For the given parameters generates a single sound with overtones or
--   pause depending on the sign of the second element in the tuple of
--   <a>Float</a>: if it is greater than zero then the sound is generated,
--   if less -- the silence (pause), if it is equal to zero then it prints
--   an informational message about a non-standard situation. Unlike the
--   <a>h1</a> function, it lifts the frequency into the enku specified by
--   the <a>Int</a> arguments (see <a>liftInEnku</a>).
h2 :: OvertonesO -> (Float, Float) -> Int -> Int -> Float -> IO ()

-- | Generalized version of the <a>soundGen3G_O</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_OPar :: Params -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generalized version of the <a>soundGen3G_O2</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_O2Par :: ((Float -> OvertonesO, Int -> Float -> OvertonesO, Int -> Float -> OvertonesO) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> Params -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generalized version of the <a>soundGen3G_O2G</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_O2GPar :: (([Float -> OvertonesO], [Int -> Float -> OvertonesO], [Int -> Float -> OvertonesO]) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> [Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> Params -> Float -> FilePath -> Float -> String -> IO ()

-- | Generalized version of the <a>soundGen3G_OMN</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_OMNPar :: Int -> Int -> Params -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generalized version of the <a>soundGen3G_O2MN</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_O2MNPar :: Int -> Int -> ((Float -> OvertonesO, Int -> Float -> OvertonesO, Int -> Float -> OvertonesO) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> Params -> Float -> FilePath -> Float -> String -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (OvertonesO -> Float -> (Float -> OvertonesO) -> OvertonesO) -> (Int -> OvertonesO) -> (OvertonesO -> OvertonesO) -> (Float -> OvertonesO) -> IO ()

-- | Generalized version of the <a>soundGen3G_O2GMN</a> where
--   <a>liftInParams</a> is used instead of lifting with the
--   <a>liftInEnku</a>. This allows e. g. to use some tonality. For more
--   information, please, refer to <a>filterInParams</a>.
soundGen3G_O2GMNPar :: Int -> Int -> (([Float -> OvertonesO], [Int -> Float -> OvertonesO], [Int -> Float -> OvertonesO]) -> [(Int, Int)] -> [(Float, Float -> OvertonesO)]) -> [Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> [Int -> Float -> OvertonesO] -> Params -> Float -> FilePath -> Float -> String -> IO ()

-- | For the given parameters generates a single sound with overtones or
--   pause depending on the sign of the second element in a tuple of
--   <a>Float</a>: if it is greater than zero then the sound is generated,
--   if less -- the silence (pause), if it is equal to zero then it prints
--   an informational message about a non-standard situation. Unlike the
--   <a>h1</a> function, it lifts into the requency specified by the
--   <a>Params</a> argument .
h2Params :: OvertonesO -> (Float, Float) -> Params -> Float -> IO ()