A program and a library to create experimental music from
a mono audio and a Ukrainian text. It can also create a timbre
for the notes.
***** Usage *****
-----------------
You can use it as a library or an executable.
Please, check before executing whether there is no "x.wav", "test*.wav",
"result*.wav" and "end.wav" files in the current directory, because they
can be overwritten. The same can be said about "nx*.wav" files in the directory.
For the executable you enter in the terminal:
dobutokO2 { 0 | 1 | 2 | 3 | 4 | 5 | 6 } {fileName} {Ukrainian text}
where filename is:
the full name of the file to be recorded in the current directory or
the full absolute path to the sound .wav file (or other one format
that is supported by your SoX installation) to obtain sound information from.
If the first command line argument equals to one of the numbers below, then
the program behaves as follows:
"1", or "3", or "5" -> then the executable uses the oberTones functions,
so for the given parameters the obertones are the same for every call.
"2", or "4", or "6" -> then the program uses uniqOberTones functions.
"3", or "4", or "5", or "6" -> the program uses additional String to define
signs for the harmonics coefficients for obertones.
In more detail:
"0" -> the program just converts multiline Ukrainian text from stdin
into a String and prints it to stdout. No other arguments are used.
"1" -> basic functionality without the possibility to define individual obertones.
"2" -> basic functionality with the possibility to define individual obertones.
In such a case, another text gives the other obertones.
"3" -> adittionally to basic functionality gives an opportunity
to specify the signs for the harmonics coefficients for obertones
by additional String.
"4" -> similarly to "2" gives an opportunity to specify the signs
for the harmonics coefficients for obertones by additional String.
"5" -> additionally to that one functionality provided by "3" gives
an opportunity to specify in how many times the amplitude for
the second lower note (if any) is greater, than the amplitude
for the main note and specify the intervals to be used
for every note.
_ -> the program behaves like for the "5" option, but generates
obertones using additional String and allows maximum control over
the parameters.
If you have prepared multiline Ukrainian textual input than to use it you
can deal with O2help executable. It is simple converter of the multiline text
into a String.
After the program executing (it takes some time) there is a file "end.wav" in the directory.
This is the resulting melody generated.
The program now lifts the frequencies to the octave with the number, which you
can specify during its execution.
You can specify some control parameters during the program execution. This
leads to different sounding.
You can use the default values (backward compatible with the 0.2.0.0 version)
by simply pressing 'Enter' while being prompted and the informational message
contains the line about the default value.
** Note:
- Better to execute in the RAM. Need rather a lot of space on the disk for
the resulting file "end.wav" and auxiliary files (MBs) for a short sound
in the second command line arguments.