DobutokO.Sound.Keyboard

Maintainer : [e-mail]

Helps to create experimental music from a file (or its part) and a Ukrainian text. It can also generate a timbre for the notes. Uses SoX inside.

Working with input and files

qwerty2dvorak :: ByteString -> ByteString

Converts a string of lowercase ASCII letters being typed on the QWERTY keyboard layout into corresponding Dvorak keyboard layout.

dvorak2qwerty :: ByteString -> ByteString

Vice versa to qwerty2dvorak.

input2BL :: IO ByteString

Get contents into lazy ByteString with filtering of all characters that are not a lower case ascii letters.

input2BLN :: Int64 -> IO ByteString

Like input2BL, but takes only first n symbols specified with the first Int64 argument.

input2BLMN :: Int64 -> Int64 -> IO ByteString

Like input2BL, but takes only first n symbols specified with the second Int64 argument dropping before this the first m symbols specified with the first Int64 argument.

readFile2BL :: FilePath -> IO ByteString

Usual way the function readFile2BLGen is used. The text in a file being read is treated as a properly typed (entered) one. So there is no keyboard layout conversion at all.

readFile2BLN :: Int64 -> FilePath -> IO ByteString

Like readFile2BL, but reads only first n symbols specified with the first Int64 argument.

readFile2BLMN :: Int64 -> Int64 -> FilePath -> IO ByteString

Like readFile2BL, but reads only first n symbols specified with the second Int64 argument dropping before this the first m symbols specified with the first Int64 argument.

readFile2BLGen :: String -> FilePath -> IO ByteString

Reads a given file into a lazy ByteString with filtering of all characters that are not a lower case ascii letters. It has additional first command line argument to control the way of treating letters: as being typed (entered) properly (null String), or needed to be converted from qwerty to dvorak layout ("q" String), or vice versa (otherwise).

readFile2BLGenN :: Int64 -> String -> FilePath -> IO ByteString

Like readFile2BLGen, but reads only first n symbols specified with the first Int64 argument.

readFile2BLGenMN :: Int64 -> Int64 -> String -> FilePath -> IO ByteString

Like readFile2BLGen, but reads only first n symbols specified with the second Int64 argument dropping before this the first m symbols specified with the first Int64 argument.

Conversions

readFileDoubles :: FilePath -> IO (Vector Int)

Usual way the function readFileDoublesGen is used. The text in a file being read is treated as a properly typed (entered) one. So there is no keyboard layout conversion at all.

readFileDoublesN :: Int64 -> FilePath -> IO (Vector Int)

Like readFileDoubles, but returns only first n elements of the Vector specified with the first Int64 argument.

readFileDoublesMN :: Int64 -> Int64 -> FilePath -> IO (Vector Int)

Like readFileDoubles, but returns only first n elements of the Vector specified with the second Int64 argument dropping before this the first m elements specified with the first Int64 argument.

readFileDoublesGen :: String -> FilePath -> IO (Vector Int)

After reading a file into a filtered lazy ByteString (see, readFile2BLGen) converts the resulting ByteString into a Vector of Int. The arguments have the same meaning as for readFile2BLGen.

readFileDoublesGenN :: Int64 -> String -> FilePath -> IO (Vector Int)

Like readFileDoublesGen, but returns only first n elements of the Vector specified with the first Int64 argument.

readFileDoublesGenMN :: Int64 -> Int64 -> String -> FilePath -> IO (Vector Int)

Like readFileDoublesGen, but returns only first n symbols specified with the second Int64 argument dropping before this the first m symbols specified with the first Int64 argument.

takeDoubles :: ByteString -> Vector Int

Converts a lazy ByteString into a Vector of Int using hashStr2.

hashStr2 :: Char -> Char -> Int

Hashes two lower case ascii characters. Is used for controlling frequencies and operators.

convH :: String -> (ByteString -> ByteString) -> ByteString -> ByteString

Auxiliary function to define how is a ByteString treated, see readFile2BLGen.