Author: Michael Curran
Latest version: 0.3
Audiobraille console is a small program that allows you to read braille files by listening to the sound of each braille cell. This program was origionally written to test the audiobraille library, and to give people a taste as to what the library can do.
The audiobraille library strives to produce each braille cell so the sound represents the tactile cell as close as possible. The vertical axis is represented by pitch, and the horizontal axis is represented by the left and right of the stereo spectrum.
./configure
make
make install
If all goes well you should have audiobraille installed.
If you are compiling on cygwin to make native windows binaries, you can use make_win32_bin.sh in the tools directory to make a nice zip archive with all binaries and needed libraries.
No real installation yet, for now abconsole.exe can be run from the bin directory.
if you run abconsole with no options, it will read in braille from STDIN, and output the audio to your sound card.
To read braille in from a file, use the option -i or --input-file plus a file name.
example:
abconsole -i test.brf
To choose whether to use 6 or 8 dot braille, use -d or --num-dots plus the number 6 or 8.
example:
abconsole -d 6
note: 8 dot braille is needed to properly identify all ascii characters, though most of the time 6 dot is probably what you want.
To set the speed of the cells, (how many cells you hear per second) use -s or --cell-speed with a number.
example:
abconsole -s 2
To set the lowest frequency audiobraille will use (the frequency dots 7 and 8 are on) use -b or --base-frequency and a number.
example:
abconsole -s 440
note: even if you choose to use 6 dot braille as aposed to 8 dot braille, dots 3 and 6 will still be on the second frequency up.
To set the gap between the frequencies use -m or --frequency-multiplyer plus a number
example:
abconsole -m 1.5
This will produce frequencies a "perfect 5th" apart, 2 would produce them an octave apart.
You can also enable stereo expantion. This feature may help a little in clearly identifying cells that have dots using the same frequency on the left and right. To enable or disable stereo expantion use -e or --stereo-expand plus 0 or 1
example:
abconsole -e 1
This would turn on stereo expantion.
Audiobraille Console is Copyright (C) 2006 Michael Curran and covered by the GNU General Public License
Please send bugs and suggestions to: Michael Curran <mick@kulgan.net>
Copyright © 2006 Michael Curran