mirror of
https://github.com/tesseract-ocr/tesseract.git
synced 2024-11-27 20:59:36 +08:00
5c45dc15b1
git-svn-id: https://tesseract-ocr.googlecode.com/svn/trunk@165 d0cd1f9f-072b-0410-8dd7-cf729c803f20
108 lines
4.9 KiB
Plaintext
108 lines
4.9 KiB
Plaintext
Introduction
|
|
============
|
|
This package contains the Tesseract Open Source OCR Engine.
|
|
Orignally developed at Hewlett Packard Laboratories Bristol and
|
|
at Hewlett Packard Co, Greeley Colorado, all the code
|
|
in this distribution is now licensed under the Apache License:
|
|
|
|
** Licensed under the Apache License, Version 2.0 (the "License");
|
|
** you may not use this file except in compliance with the License.
|
|
** You may obtain a copy of the License at
|
|
** http://www.apache.org/licenses/LICENSE-2.0
|
|
** Unless required by applicable law or agreed to in writing, software
|
|
** distributed under the License is distributed on an "AS IS" BASIS,
|
|
** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
** See the License for the specific language governing permissions and
|
|
** limitations under the License.
|
|
|
|
|
|
Other Dependencies and Licenses:
|
|
================================
|
|
The Aspirin/MIGRAINES system is no longer required.
|
|
|
|
Tesseract can also make use of the libtiff library. (www.libtiff.org)
|
|
Without libtiff, Tesseract can only read uncompressed and G3 compressed
|
|
TIFF files.
|
|
|
|
|
|
History:
|
|
========
|
|
The engine was developed at Hewlett Packard Laboratories Bristol and
|
|
at Hewlett Packard Co, Greeley Colorado between 1985 and 1994, with some
|
|
more changes made in 1996 to port to Windows, and some C++izing in 1998.
|
|
A lot of the code was written in C, and then some more was written in C++.
|
|
Since then all the code has been converted to at least compile with a C++
|
|
compiler. Currently it builds under Linux with gcc2.95 and under Windows
|
|
with VC++6. The C++ code makes heavy use of a list system using macros.
|
|
This predates stl, was portable before stl, and is more efficent than stl
|
|
lists, but has the big negative that if you do get a segmentation violation,
|
|
it is hard to debug. Another "feature" of the C/C++ split is that the C++
|
|
data structures get converted to C data structures to call the low-level C
|
|
code. This is ugly, and the C++izing of the C code is a step towards
|
|
eliminating the conversion, but it has not happened yet.
|
|
|
|
|
|
Directory Structure (ordered by dependency):
|
|
============================================
|
|
ccmain Top-level code. The main program resides in tesseractmain.cpp.
|
|
display An "editor" to view and operate on the internal structures.
|
|
(Requires a working viewer - batteries not included.)
|
|
wordrec The word-level recognizer.
|
|
textord The module that organizes(orders) text into lines and words.
|
|
classify The low-level character classifiers.
|
|
ccstruct Classes to hold information about a page as it is being processed.
|
|
viewer The client side of a client server viewing system.
|
|
Unfortunately, at this time, the server side is not available.
|
|
image Image class and processing functions.
|
|
dict Language model code.
|
|
cutil Code for file I/O, lists, heaps etc, from the old C code.
|
|
ccutil Somewhat newer code for lists, memory allocation etc from the
|
|
old C++ code.
|
|
|
|
|
|
About the Engine
|
|
================
|
|
This code is a raw OCR engine. It has NO PAGE LAYOUT ANALYSIS, NO OUTPUT
|
|
FORMATTING, and NO UI. It can only process an image of a single column
|
|
and create text from it. It can detect fixed pitch vs proportional text.
|
|
Having said that, in 1995, this engine was in the top 3 in terms of character
|
|
accuracy, and it compiles and runs on both Linux and Windows.
|
|
As of 2.0, Tesseract is fully unicode (UTF-8) enabled, and can recognize 6
|
|
languages "out of the box." Code and documentation is provided for the brave
|
|
to train in other languages. See code.google.com/p/tesseract-ocr for more
|
|
information on training.
|
|
|
|
|
|
Using the Engine
|
|
================
|
|
Windows:
|
|
The executable must reside in the same directory as the tessdata directory
|
|
The command line is:
|
|
tesseract <image.tif> <output> [-l langid]
|
|
A windows executable (tesseract.exe) is included in the distribution, but
|
|
may not work for you unless you also have the correct mfc and crt dlls.
|
|
There is also a tessdll.dll, which you can use to run tesseract from your
|
|
own program, but you may be better off building it yourself.
|
|
|
|
Non-Windows:
|
|
You have to tell Tesseract through a standard unix mechanism where to find
|
|
its data directory. You must either:
|
|
./configure
|
|
make
|
|
make install
|
|
to move the data files to the standard place, or:
|
|
export TESSDATA_PREFIX="directory in which your tessdata resides/"
|
|
(or equivalent) in your .profile or whatever or setenv to set the environment
|
|
variable. Note that the directory must end in a /
|
|
HAVING tesseract and tessdata IN THE SAME DIRECTORY DOES NOT WORK ANY MORE.
|
|
The command line is:
|
|
tesseract <image.tif> <output> [-l langid]
|
|
|
|
All Systems:
|
|
The image file requires a .tif extension for its type to be recognized
|
|
correctly. If a file exists with the .tif extension replaced by .uzn, then it
|
|
will be interpreted as a UNLV-style zone file. (See www.isri.unlv.edu for
|
|
details of the zone files.)
|
|
langid may be one of the codes defined in ISO 639-3, and you must download
|
|
the corresponding data files into your tessdata directory.
|