[Blindmath] infty documentation

Fri Sep 10 21:04:58 UTC 2010

Hi folks
Here's the readme file that accompanies the commandline infty. as you 
can see it describes a fully functional software program released to 
the public, and not an alpha or beta or whatever put up there to be 
tried and tested only.

text starts here
---------------------------------------------------------------------
Outline of the software and license agreement
---------------------------------------------------------------------
InftyReader Version 2.4.4e (English edition)
All Rights Reserved, Copyright : InftyProject
URL:http://www.inftyproject.org/
---------------------------------------------------------------------

1. Outline of the Software

This is a software to recognize scientific documents including
mathematical expressions, developed in Masakazu Suzuki Laboratory,
Graduate school of Mathematics, Kyushu University in collaboration
with several cooperation partners. The software is usable free of
charge by everybody except for commercial or business purpose.

The software recognizes only binary (black and white) page images
carefully scanned in either 600 DPI or 400 DPI. Image files have to be
prepared in either TIFF, GIF or PNG format. (The restriction of TIFF
format to CCITT-3/CCITT-4 is removed from the Version 2.4.3c).
The source documents have to be clearly printed.

InftyReader erases small noises, segments page images into picture areas,
table areas and text areas, and then recognizes text areas including
mathematical expressions. However, to get better recognition results,
users are recommended to erase noises, pictures and tables before the
recognition, and, in scanning, to adjust the binarization threshold of
the scanner so that, in scanned page images, the number of the touched
or broken characters is less than 1% of the total number of the characters
in each page.

2. Install and Usage

InftyReader ver.2.4.4 is a command-line application.
To use InftyReader, please add the path to the folder of InftyReader.exe
in the environment variable "PATH". The default path after the install
of Inftyreader is :

      c:\Infty\bin

You may not change the default folder structure under the folder "bin".

You can see the usage help of InftyReader typing "InftyReader" on the
command prompt.

To use this software in a GUI window similar to older versions of InftyReader
and to view/edit the recognition results, please use

    InftyEditor Ver.2.04x, or newer,
                ^^^^^^^^^^^^^^^^^^^
released from the site http://www.inftyproject.org/download/.
The English edition of InftyEditor ver.2.04x is a free software.

3. Operating Environment

InftyReader runs under Windows 2000 and XP. Note that it does not run
on Windows 98 nor Me.

In order to run InftyReader on Windows 2000, it is necessary to update
your Windows 2000 to the recent one, since InftyReader makes use of some
libraries included in the version 6 of Internet Explorer package.

4. Usage Syntax on the Command Prompt of Windows

  *SYNOPSIS
   InftyReader -help
   InftyReader folderName [fileName1] [fileName2]... [option]...

   Infty.exe recognizes images specified by `fileName1', `fileName2',...
   in the folder `folderName'.
   Please be aware that folderName cannot be omitted, and you need to input
   "Space" after the folderName (not the key "\").
   When no file names are specified, all files with the extension 
.tiff and .tif
   in the `folderName' are recognized.
   The output file is saved in the same folder as the input image files.
   The default output format is IML.
   When the number of input files is one, the output file name is the same name
   as the input file.
   When the number of input files is more than one, the output file name is the
   same name as the `foldername'.

     e.g.) InftyReader C:\Data\Images
     e.g.) InftyReader "C:\Document and Settings\user\images" image1.tif
     e.g.) InftyReader C:\Data\Images sample1.tif sample2.tif
     e.g.) InftyReader C:\Data\Images -n test -o C:\OutPut -f kml -f iml
     e.g.) InftyReader image1.tif (in case image1.tif is in the current folder)
     e.g.) InftyReader ../Images

*Options

-r (400 | 600)
   specifies the resolution of input images (default 600 dpi). Only 600/400
   dpi are acceptable. The resolution is set to 600 dpi when any other value
   is specified.

   e.g.) InftyReader C:\Data\Images -r 400

-f ( iml | kml | tex | html | mathml | hrtex )
   specifies output formats (default iml).
   One can get several result files in various formats
   by specifying several options.

   e.g.) InftyReader C:\Data\Images -f iml -f kml

-o outputFolderName
   changes the output folder name where the output file is produced.

   e.g.) InftyReader C:\Data\Images -o C:\Data\OutPut

-n outputFileName
   changes the output file name. The extension of the file is the output
   format specified by the option -f.

   e.g.) InftyReader C:\Data\Images -n test

-preamble preambleFile
   specifies the preamble file used in TeX format output.
   When no preamble file is specified, "defaultpreamble.tex" in the same
   folder as "Infty.exe" will be used. In case the preamble tex file is
   not found, the preamble will be empty in the TeX output.

   e.g.) InftyReader C:\Data\Images -f tex -preamble C:\Data\preamble.tex

5. License Agreement

The present version of InftyReader is usable free of charge only for
non-commercial and non-business purpose under the following license
agreement.

(1) You may not modify the software in any manner. You may not reverse
     engineer, decompile or disassemble the software.
(2) You may not sell the software.
     You may distribute the software only free of charge, without modifying
     the zip-package of the software.
(3) The author shall have no obligation to correct errors and inconveniences
     of the software or to answer questions about the software.
(4) The author shall not be responsible for any lost and damage caused by
     the use of the software.

6. Report

Any hearty report about the software will be welcome.

InftyProject
URL:http://www.inftyproject.org/

Masakazu Suzuki
Faculty of Mathematics
Kyushu University 36
Fukuoka 812-8581, Japan
e-mail: suzuki at math.kyushu-u.ac.jp
URL:http://www.math.kyushu-u.ac.jp/~suzuki/
text ends here

Paul