Copyright	(c) OleksandrZhabenko 2025
License	MIT
Maintainer	oleksandr.zhabenko@yahoo.com
Stability	Experimental
Safe Haskell	None
Language	Haskell2010

DobutokO.Sound.Aftovolio.Ukrainian.Filter

Contents

Library and executable functions

Description

Provides an easy way to create some rhythmic patterns from a Ukrainian text. Uses aftovolioUkr executable inside from the aftovolio package.

Synopsis

quantizeDurationsBasedOnUkrainianText :: FilePath -> Int -> [Double] -> String -> [String] -> [String] -> IO [Double]

Library and executable functions

quantizeDurationsBasedOnUkrainianText Source #

Arguments

:: FilePath	A `FilePath` to a file containing syllable durations. If empty, a default set of durations is selected based on `k` (the `Int` argument here).
-> Int	An `Int` used to select the specific group of durations from the file (if available) or determine which default list to use.
-> [Double]	A list of `Double` values representing quantization parameters. The resulting list will contain just the values from this list.
-> String	A `String` containing the Ukrainian text to be processed. This text is split into words and passed to the external executable `aftovolioUkr`.
-> [String]	A list of additional command-line arguments ([`String`]) to be forwarded to the `aftovolioUkr` executable.
-> [String]	A list of `String` values representing selected line numbers or indices to influence the processing of the Ukrainian text. If empty then the whole output is used without selection. If specified in the modes without tests and file single line output changes the output so that just the lines with the specified Int numbers are displayed in the order of the specified numbers. To specify some range, use just dash as here: "34-250" meaning that lines with numbers between 34 and 250 inclusively will be displayed. The output preserves music mode additional information as well here.
-> IO [Double]

quantizeDurationsBasedOnUkrainianText processes and quantizes syllable durations derived from a Ukrainian text that can be further used by DobutokO modules for creating music and sound patterns or timbre.

This function performs several steps to produce a list of quantized durations.

It reads syllable durations, invoke aftovolioUkr executable with argements, processes and parses output and makes quantization of the result.

In the event that the external process does not exit successfully, the function writes the error message to stderr and returns an empty list.