Liblouis User's and Programmer's Manual
7.8 lou_backTranslateString ¶
int lou_backTranslateString( const char *tableList, const widechar *inbuf, int *inlen, widechar *outbuf, int *outlen, formtype *typeform, char *spacing, int mode);
This is exactly the opposite of lou_translateString
.
inbuf
is a string of Unicode characters representing
braille. outbuf
will contain a string of Unicode
characters. typeform
will indicate any emphasis found in the
input string, while spacing
will indicate any differences in
spacing between the input and output strings. The typeform
and
spacing
parameters may be NULL
if this information is
not needed. mode
specifies how the back-translation
should be done.
By default, if a dot pattern in the input is undefined
then its dot numbers will be included in the output (as \ddd/).
This does not occur if the noUndefined
mode is set;
an undefined dot pattern simply produces no output.
The partialTrans
mode specifies that the input should be
treated as an incomplete word. That is, rules that apply only for
complete words or at the end of a word will not take effect. This is
intended to be used when translating input typed on a braille keyboard
to provide a rough idea to the user of the characters they are typing
before the word is complete.