Audiobraille Library

Author: Michael Curran

Latest version: 0.0

Introduction

Audiobraille library is a c shared library that allows applications to convey braille to the user by playing the cells as audio frequencies.

Audiobraille represents each braille cell exactly the same as it would be represented tactily, but in audio dimentions. This means the user can hopefully still cognativly process the braille cells the same way they always would, rather than hearing words from a speech synthesizer that only describe the ascii characters that braille cells are mapped to in grade 0.

Supported platforms

Audiobraille library in theory should work on any system with the posix thread library and any system with sys/ioctl.h and sys/soundcard.h. This should mean any varient of Linux, and also cygwin. Also it is possible to write native windows applications with the library, though it will still depend on cygwin.

The library has been tested so far on cygwin/windows.

If you have success with other platforms, please share your experience.

Installation from source (unix)

./configure
make
make install

If all goes well you should have the audiobraille library installed.

Download

audiobraille library 0.0 source

Library usage

The audiobraille library provides an interface as a c shared library. To use it in programs, include audiobraille.h in your source, and make sure to link with audiobraille when you compile.

There is currently no API documentation yet, but take a look at audiobraille.h and it should be quite self-explanitory. There is also a small hello world example in the examples directory which shows how to write the most simplist program with the audiobraille library.

Other more complex examples can be found on the audiobraille project main page

note for developers using cygwin: It is possible to compile native windows programs that use audiobraille library, though audiobraille library does at the moment depend on sys/ioctl.h and sys/soundcard.h for audio output, thus in windows it must link itself with cygwin1.dll. Currently it is quite impossible to compile it in windows with out the aide of cygwin, though this will change once a static library, that is small enough, and that can provide a generic platform independent way of accessing sound devices, can be found.

License and Copyright

Audiobraille library is Copyright (C) 2006 Michael Curran and covered by the GNU General Public License

Bugs and suggestions

Please send bugs and suggestions to: Michael Curran <mick@kulgan.net>

Copyright © 2006 Michael Curran