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.