Package org.liblouis

Class LibLouisUTDML


  • public final class LibLouisUTDML
    extends java.lang.Object
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean backTranslateFile​(java.lang.String configFileList, java.lang.String inputFileName, java.lang.String outputFileName, java.lang.String logFileName, java.lang.String settingsString, int mode)  
      boolean backTranslateString​(java.lang.String configFileList, byte[] inbuf, byte[] outbuf, int[] outlen, java.lang.String logFilename, java.lang.String settingsSrting, int mode)
      the brf characters in inbuf are translated to print characters in outbuf according to the settings in the configuration files and setingsStrring.
      boolean charToDots​(java.lang.String tableList, byte[] inbuf, byte[] outbuf, java.lang.String logFile, int mode)
      Convert the utf8 character string in inbuf to Unicode braille dot patterns and place the result as a utf8 string in outbuf.
      boolean checkTable​(java.lang.String tableList, java.lang.String logFile, int mode)
      See if the table in tableList exists and is valid.
      boolean dotsToChar​(java.lang.String tableList, byte[] inbuf, byte[] outbuf, java.lang.String logFile, int mode)
      Convert the utf8 string of dot patterns in inbuf to characters and place the result as a utf8 string in outbuf.
      boolean file2brl​(java.lang.String[] args)
      This method performs the functions of the file2brl program in a more contrrolled environment.
      void free()
      You must call free at the end of your application to free all memory used by liblouisutdml and liblouis.
      static LibLouisUTDML getInstance()  
      static void initialize​(java.lang.String dataPath, java.lang.String writeablePath, java.lang.String logFile)  
      static void loadLibrary​(java.lang.String libraryPath, java.lang.String librarySuffix)  
      void loadXMLCatalog​(java.lang.String filename)
      Load a XML catalog into LibLouisUTDML.
      void logEnd()  
      void registerLogCallback​(LogCallback cb)  
      void setDataPath​(java.lang.String path)
      Path on which liblouis tables and liblouisutdml files can be found.
      void setLogFile​(java.lang.String fileName)  
      void setLogLevel​(int level)  
      void setWriteablePath​(java.lang.String path)
      Set the path to which temporary files will be written.
      boolean translateFile​(java.lang.String configFileList, java.lang.String inputFileName, java.lang.String outputFileName, java.lang.String logFileName, java.lang.String settingsString, int mode)
      The xml document in inputFile is translated into braille and the translation is placed in outputFile.
      boolean translateString​(java.lang.String configFileList, byte[] inbuf, byte[] outbuf, int[] outlen, java.lang.String logFilename, java.lang.String settingsString, int mode)
      Make a braille translation of the UTF-8 characters in inbuf according to configuration settings to UTF-8 characters in outbuf.
      boolean translateTextFile​(java.lang.String configFileList, java.lang.String inputFileName, java.lang.String outputFileName, java.lang.String logFileName, java.lang.String settingsString, int mode)
      The plain-text file in inFile is translated to braille and the translation placed in outputFile as described for the previous method.
      java.lang.String version()
      Return a string giving the versions of both liblouisutdml and liblouis
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • initialize

        public static void initialize​(java.lang.String dataPath,
                                      java.lang.String writeablePath,
                                      java.lang.String logFile)
      • loadLibrary

        public static void loadLibrary​(java.lang.String libraryPath,
                                       java.lang.String librarySuffix)
                                throws java.lang.Exception
        Throws:
        java.lang.Exception
      • version

        public java.lang.String version()
        Return a string giving the versions of both liblouisutdml and liblouis
      • loadXMLCatalog

        public void loadXMLCatalog​(java.lang.String filename)
        Load a XML catalog into LibLouisUTDML.
      • translateString

        public boolean translateString​(java.lang.String configFileList,
                                       byte[] inbuf,
                                       byte[] outbuf,
                                       int[] outlen,
                                       java.lang.String logFilename,
                                       java.lang.String settingsString,
                                       int mode)
        Make a braille translation of the UTF-8 characters in inbuf according to configuration settings to UTF-8 characters in outbuf. The latter will be in Unicode braille. The return value is true if the translation is successful and false if not. Any errors are recorded in logFile. If this is null, they are printed on stderr. There may be errors even if the return value is true. If there are none, the log file will be empty. settingsstring may be used to pass in configuration settings.
      • backTranslateString

        public boolean backTranslateString​(java.lang.String configFileList,
                                           byte[] inbuf,
                                           byte[] outbuf,
                                           int[] outlen,
                                           java.lang.String logFilename,
                                           java.lang.String settingsSrting,
                                           int mode)
        the brf characters in inbuf are translated to print characters in outbuf according to the settings in the configuration files and setingsStrring. The translation will be in UTF-8.
      • translateFile

        public boolean translateFile​(java.lang.String configFileList,
                                     java.lang.String inputFileName,
                                     java.lang.String outputFileName,
                                     java.lang.String logFileName,
                                     java.lang.String settingsString,
                                     int mode)
        The xml document in inputFile is translated into braille and the translation is placed in outputFile. The return value and log file are as described above.
      • translateTextFile

        public boolean translateTextFile​(java.lang.String configFileList,
                                         java.lang.String inputFileName,
                                         java.lang.String outputFileName,
                                         java.lang.String logFileName,
                                         java.lang.String settingsString,
                                         int mode)
        The plain-text file in inFile is translated to braille and the translation placed in outputFile as described for the previous method. If the text contains blank lines they are treated as paragraph breaks.
      • backTranslateFile

        public boolean backTranslateFile​(java.lang.String configFileList,
                                         java.lang.String inputFileName,
                                         java.lang.String outputFileName,
                                         java.lang.String logFileName,
                                         java.lang.String settingsString,
                                         int mode)
      • charToDots

        public boolean charToDots​(java.lang.String tableList,
                                  byte[] inbuf,
                                  byte[] outbuf,
                                  java.lang.String logFile,
                                  int mode)
        Convert the utf8 character string in inbuf to Unicode braille dot patterns and place the result as a utf8 string in outbuf.
      • dotsToChar

        public boolean dotsToChar​(java.lang.String tableList,
                                  byte[] inbuf,
                                  byte[] outbuf,
                                  java.lang.String logFile,
                                  int mode)
        Convert the utf8 string of dot patterns in inbuf to characters and place the result as a utf8 string in outbuf.
      • checkTable

        public boolean checkTable​(java.lang.String tableList,
                                  java.lang.String logFile,
                                  int mode)
        See if the table in tableList exists and is valid. If no errors are found logFile will be empty.
      • setDataPath

        public void setDataPath​(java.lang.String path)
        Path on which liblouis tables and liblouisutdml files can be found.
      • file2brl

        public boolean file2brl​(java.lang.String[] args)
        This method performs the functions of the file2brl program in a more contrrolled environment.
      • setWriteablePath

        public void setWriteablePath​(java.lang.String path)
        Set the path to which temporary files will be written.
      • free

        public void free()
        You must call free at the end of your application to free all memory used by liblouisutdml and liblouis. Do NOT call it after every call to a liblouisutdml method. This will result in great inefficiency. The memory used by liblouisutdml for each document is freed wen the method completes, but some memory holding configuration settings is held. The memory used by liblouis is freed only when the free method is called.
      • setLogFile

        public void setLogFile​(java.lang.String fileName)
      • logEnd

        public void logEnd()
      • registerLogCallback

        public void registerLogCallback​(LogCallback cb)
      • setLogLevel

        public void setLogLevel​(int level)