[转]Tesseract-OCR学习系列

转载地址：http://www.jianshu.com/p/a53c732d8da3

Tesseract-OCR学习系列（三）简例

Tesseract API Basic Example using CMake Configuration

参考文档：https://github.com/tesseract-ocr/tesseract/wiki/APIExample

Tesseract提供的API可以在baseapi.h文件中找到。然而，如果没有个示例带我们飞一会儿，也是颇难搞懂到底该怎么调用tesseract的api。

我们知道，如果要调用一个第三方的库，那我们需要在工程的属性中增加：

  1. 第三方库头文件的位置。
  2. 第三方库库文件的位置。
  3. 第三方库中，需要链接的lib文件的文件名。

而且，Debug和Release需要分开来配置。手动配置真的是麻烦极了。而且，即使你配置好了，如果你第三方库的位置改变了，那对不起，请重新配置；如果你要把工程给别人来使用，而别人的第三方库所放的位置与你所放的不同，对不起，需要重新配置；如果你想要换一个操作系统进行开发，对不起，请重新配置！那有没有办法可以绕过这些麻烦事，使得只用麻烦一次，以后永远简单呢？答案是有。工具就是CMake。可参看我的另一篇文章：CMake简要教程。这里，我给大家举例介绍，如何使用CMake来添加第三方库。

首先，我们需要将第三方库Tesseract所提供的东西集中存放。比如，我在F盘的extralib中建立了一个Tesseract文件夹。文件夹中，有bin文件夹include文件夹，lib文件夹，以及tessdata文件夹。其中：

  • bin：存放.dll文件。
  • include：存放.h文件。
  • lib：存放.lib文件。
  • tessdata：存放.traineddata文件。

bin文件夹

include文件夹

其中，tesseract的.h文件比较分散。我是直接在原来的tessract中搜索所有的.h文件，然后再拷贝到这边来的。

lib文件夹

tessdata文件夹

其中，chi_sim代表简体中文，eng就不用说了，代表英文。tessdata文件夹中的内容可以在官方网站中下载到。

好了，现在有了这样一个文件夹，我们下面的目标是让CMake可以找到这些文件夹。为了达到这个目的，首先需要自己写名为TesseractConfig.cmake一个文件，放在刚刚建立的tesseract文件夹中。所以，tesseract文件夹最终看起来是这个样子的：

tesseract文件夹

如果CMake能找到TesseractConfig.cmake这个文件，就可以通过find_package函数来找到Tesseract的各个文件夹的路径了。但问题是，CMake如何找到TesseractConfig.cmake这个文件呢？在Windows操作系统的环境下，有两种方法：

  1. 将TesseractConfig.cmake这个文件所在的文件夹路径添加到系统环境变量的Path中。
  2. 在CMake的GUI界面中手动配置。

在正式介绍之前，先来看一看TesseractConfig.cmake中该怎么写：

# ===================================================================================
#  The Tesseract CMake configuration file
#
#  Usage from an external project:
#    In your CMakeLists.txt, add these lines:
#
#    FIND_PACKAGE(Tesseract REQUIRED)
#    TARGET_LINK_LIBRARIES(MY_TARGET_NAME ${Tesseract_LIBS})
#
#    This file will define the following variables:
#      - Tesseract_LIBS                     : The list of libraries to link against.
#      - Tesseract_LIB_DIR                  : The directory(es) where lib files are. Calling
#                                             LINK_DIRECTORIES with this path is NOT needed.
#      - Tesseract_INCLUDE_DIRS             : The Tesseract include directories.
#      - Tesseract_VERSION                  : The version of this Tesseract build. Example: "2.4.0"
#      - Tesseract_VERSION_MAJOR            : Major version part of Tesseract_VERSION. Example: "2"
#      - Tesseract_VERSION_MINOR            : Minor version part of Tesseract_VERSION. Example: "4"
#      - Tesseract_VERSION_PATCH            : Patch version part of Tesseract_VERSION. Example: "0"
#
#    Advanced variables:
#      - Tesseract_CONFIG_PATH
#
# ===================================================================================

set(Tesseract_VERSION_MAJOR 3)
set(Tesseract_VERSION_MINOR 4)
set(Tesseract_VERSION_PATCH 1)
set(Tesseract_VERSION ${Tesseract_VERSION_MAJOR}.${Tesseract_VERSION_MINOR}.${Tesseract_VERSION_PATCH})

get_filename_component(Tesseract_CONFIG_PATH "${CMAKE_CURRENT_LIST_FILE}" PATH CACHE)
set(Tesseract_LIB_DIR "${Tesseract_CONFIG_PATH}/lib")
set(Tesseract_INCLUDE_DIRS "${Tesseract_CONFIG_PATH}/include")

set(Tesseract_LIBS_DBG "liblept171d.lib" "libtesseract304d.lib")
set(Tesseract_LIBS_OPT "liblept171.lib" "libtesseract304.lib")
foreach(__tesslib ${Tesseract_LIBS_DBG})
  list(APPEND Tesseract_LIBS debug "${Tesseract_LIB_DIR}/${__tesslib}")
endforeach()
foreach(__tesslib ${Tesseract_LIBS_OPT})
  list(APPEND Tesseract_LIBS optimized "${Tesseract_LIB_DIR}/${__tesslib}")
endforeach()

set(Tesseract_FOUND TRUE CACHE BOOL "" FORCE)

好了，准备工作到此为之，接下来我们可以开始正式地构建示例程序Basic-example了。首先新建文件夹samples。然后在samples文件夹中新建文件夹Basic-example，新建文件CMakeLists.txt。

samples文件夹

这里的CMakeLists.txt可以很简单（当然也可以很复杂，但作为示例，理当简单一点）。

cmake_minimum_required(VERSION 3.0)
project(tesseract-api-examples)
add_subdirectory(Basic-example)

第一句话表示，cmake的版本号最小为3.0（低于cmake 3.0则无法构建）。第二句话表示构建一个解决方案，名字叫做tesseract-api-examples。第三句表示添加子目录Basic-example。添加子目录的意思，其实是开始执行子目录中的CMakeLists.txt。所以，如果想通过add_subdirectory添加子目录，那就必须保证这个子目录中有CMakeLists.txt这个文件。

现在，我们进入Basic-example文件夹中，新建两个文件：Basic-example.cpp以及CMakeLists.txt

在Basic-example.cpp中，我们将官网上提供的代码粘上来：

#include <tesseract/baseapi.h>
#include <leptonica/allheaders.h>

int main()
{
    char *outText;

    tesseract::TessBaseAPI *api = new tesseract::TessBaseAPI();
    // Initialize tesseract-ocr with English, without specifying tessdata path
    if (api->Init(NULL, "eng")){
        fprintf(stderr, "Could not initialize tesseract.\n");
        exit(1);
    }

    // Open input image with leptonica library
    Pix *image = pixRead("D:\\open_source\\tesseract-3.04.01\\tesseract\\testing\\phototest.tif");
    api->SetImage(image);
    // Get OCR result
    outText = api->GetUTF8Text();
    printf("OCR output:\n%s", outText);

    // Destroy used object and release memory
    api->End();
    delete [] outText;
    pixDestroy(&image);

    return 0;
}

而在CMakeLists.txt中，可以用6句话来完成：

set(the_target "Basic-example")
find_package(Tesseract REQUIRED)
aux_source_directory(. SRC_LIST)
include_directories(${Tesseract_INCLUDE_DIRS})
add_executable(${the_target} ${SRC_LIST})
target_link_libraries(${the_target} ${Tesseract_LIBS})

其中，

  • 第一行设定the_target名为"Basic-example"。
  • 第二行寻找Tesseract第三方库。
  • 第三行寻找当前文件夹下的所有.c文件和.cpp文件，并把文件名放在SRC_LIST中。
  • 第四行添加第三方库目录Tesseract_INCLUDE_DIRS。
  • 第五行设定项目Basic-example的生成目标是一个可执行文件。
  • 第六行添加依赖的第三方库。

好了，一切准备就绪，就差构建了！打开CMake-GUI软件。

设定cmake的源路径和目标路径。如果对这两个路径不是很清楚的，还是请移步CMake简要教程。

点击config

出现一个选框，选择你所使用的C++编译器。我使用的是VS2012。点击Finish。

在一段时间的等待之后，出现如下的界面：

注意Tesseract_DIR那一行。我这边自动找到了。那是因为这个我已经把这个路径放置到环境变量的Path中了。你可以选择将你的路径放置到环境变量中，也可以在这里手动选择这个目录。如果是通过手动选择的方式，那么这个目录会保存在Cache中，下次配置也不需要再次选择了。

再次点击Configure。

红色条带消失，消息栏显示Configuring done。此时，点击Generate。

生成成功！接下来，就可以打开build文件夹下面的tesseract-api-examples.sln这一工程文件了。

将Basic-example设为启动项。生成，成功！

运行！啊哦！

唉，不好意思，太激动了，脑残了一把！我们现在还需要将Tesseract的bin文件夹放到环境变量的Path中，这样，程序才能找到dll文件。

现在可以开始调试程序了。

phototest.tif

OK。运行程序。

成功执行~

我们再回过头来看一看这个示例程序。看看它做了一些什么事。

#include <tesseract/baseapi.h>
#include <leptonica/allheaders.h>

int main()
{
    char *outText;

    tesseract::TessBaseAPI *api = new tesseract::TessBaseAPI();
    // Initialize tesseract-ocr with English, without specifying tessdata path
    if (api->Init(NULL, "eng")){
        fprintf(stderr, "Could not initialize tesseract.\n");
        exit(1);
    }

    // Open input image with leptonica library
    Pix *image = pixRead("D:\\open_source\\tesseract-3.04.01\\tesseract\\testing\\phototest.tif");
    api->SetImage(image);
    // Get OCR result
    outText = api->GetUTF8Text();
    printf("OCR output:\n%s", outText);

    // Destroy used object and release memory
    api->End();
    delete [] outText;
    pixDestroy(&image);

    return 0;
}

首先包含了两个头文件：

#include <tesseract/baseapi.h>
#include <leptonica/allheaders.h>

这其实说明了，这个示例程序用到了两个库。一个是tesseract，一个是leptonica。tesseract用来做OCR。leptonica可以处理基本的图像处理的需求。

接下来，在main函数中，定义了一个对象：

tesseract::TessBaseAPI *api = new tesseract::TessBaseAPI();

其中，tesseract是命名空间。TessBaseAPI是一个类名。这个类的注释是这么写的：

/**
* Base class for all tesseract APIs.
* Specific classes can add ability to work on different inputs or produce
* different outputs.
* This class is mostly an interface layer on top of the Tesseract instance
* class to hide the data types so that users of this class don‘t have to
* include any other Tesseract headers.
*/

也就是说：

所有的tesseract的API都在这个类中。

所以，如果我们把这个类搞明白了，也就知道Tesseract的API的所有调用方法了。好事啊~这个类一会儿再回过来看。先把代码读完。

    // Initialize tesseract-ocr with English, without specifying tessdata path
    if (api->Init(NULL, "eng")){
        fprintf(stderr, "Could not initialize tesseract.\n");
        exit(1);
    }

来看一看Init的注释~

/**
   * Instances are now mostly thread-safe and totally independent,
   * but some global parameters remain. Basically it is safe to use multiple
   * TessBaseAPIs in different threads in parallel, UNLESS:
   * you use SetVariable on some of the Params in classify and textord.
   * If you do, then the effect will be to change it for all your instances.
   *
   * Start tesseract. Returns zero on success and -1 on failure.
   * NOTE that the only members that may be called before Init are those
   * listed above here in the class definition.
   *
   * The datapath must be the name of the parent directory of tessdata and
   * must end in / . Any name after the last / will be stripped.
   * The language is (usually) an ISO 639-3 string or NULL will default to eng.
   * It is entirely safe (and eventually will be efficient too) to call
   * Init multiple times on the same instance to change language, or just
   * to reset the classifier.
   * The language may be a string of the form [~]<lang>[+[~]<lang>]* indicating
   * that multiple languages are to be loaded. Eg hin+eng will load Hindi and
   * English. Languages may specify internally that they want to be loaded
   * with one or more other languages, so the ~ sign is available to override
   * that. Eg if hin were set to load eng by default, then hin+~eng would force
   * loading only hin. The number of loaded languages is limited only by
   * memory, with the caveat that loading additional languages will impact
   * both speed and accuracy, as there is more work to do to decide on the
   * applicable language, and there is more chance of hallucinating incorrect
   * words.
   * WARNING: On changing languages, all Tesseract parameters are reset
   * back to their default values. (Which may vary between languages.)
   * If you have a rare need to set a Variable that controls
   * initialization for a second call to Init you should explicitly
   * call End() and then use SetVariable before Init. This is only a very
   * rare use case, since there are very few uses that require any parameters
   * to be set before Init.
   *
   * If set_only_non_debug_params is true, only params that do not contain
   * "debug" in the name will be set.
   */

看着这么长的英文估计还挺累，不如我来翻译一下：

实例大多数情况下是线程安全的，并且是完全独立的。但是仍然保留了一些全局参量。基本上在不同的线程中并行地使用多个TessBaseAPIs是安全的，除非：你使用了SetVariable改变了某些参数的值。如果你这么做了，那么你所有的实例的效果都会为之发生改变。

启动tesseract。如果成功返回0，如果失败返回-1。注意能在Init方法前面调用的成员函数是那些在类定义中列在Init之前的那些函数。

datapath必须为tessdata的父目录，并且必须以/终止。最后一个/后面所出现的字符将被全部删除。language参数通常是一个ISO639-3的字符串，如果是NULL将被默认设置为eng。在单个实例中，多次调用Init方法来改变语言或重置分类器是没有问题的，（并且会逐渐变地更快速）。

language参数可以写成[~]<lang>[+[~]<lang>]*的形式，即表明可以加载多种语言。例如hin+eng会加载北印度语和英语。Languages可以在内部被设置为一种或多种语言，因此~符号可以用来覆盖。例如，如果hin被设置为默认加载eng，则hin+~eng会强制只加载hin。可以被加载的语言的数量仅仅由内存限制，但是加载多种语言会同时影响速度和准确率。因为这需要更多的工作来决定它是哪种语言，并且更有可能产生错误。

警告：一旦改变语言，所有的Tesseract参数被重置为默认值。（每种语言可能不一样。）

再接着看代码：

    // Open input image with leptonica library
    Pix *image = pixRead("D:\\open_source\\tesseract-3.04.01\\tesseract\\testing\\phototest.tif");

pixRead是Leptonica的函数，它读取一张图片，并将图片的结果保存在Pix结构体中。

    api->SetImage(image);

SetImage函数为Tesseract提供去识别的图片。

    // Get OCR result
    outText = api->GetUTF8Text();

GetUTF8Text函数识别图片中的文字，并返回char*数组。

    // Destroy used object and release memory
    api->End();
    delete [] outText;
    pixDestroy(&image);

最后一部分是释放和销毁。

关于End方法，代码中的注释是这么写的

  /**
   * Close down tesseract and free up all memory. End() is equivalent to
   * destructing and reconstructing your TessBaseAPI.
   * Once End() has been used, none of the other API functions may be used
   * other than Init and anything declared above it in the class definition.
   */
  void End();

最后释放数组和图像。合情合理，没有什么好说的。

如果需要完整的示例文件及CMakeLists.txt，可以点击此处下载。

时间： 2024-10-26 14:53:43

[转]Tesseract-OCR学习系列的相关文章

Android学习系列(17)--App列表之圆角ListView(续)

http://www.cnblogs.com/qianxudetianxia/archive/2011/09/19/2068760.html 本来这篇文章想并到上篇Android学习系列(16)--App列表之圆角ListView中的,但是若是如此就让大家错过一篇新的好的文章,着实可惜.上篇中我们使用shape,corners,gradient实现了一个渐变的圆角效果,但是在完文之后的实践中,我发现有时效果不甚满意,选中和放手的事件监听没有去正确的判断,然后渐变效果也比较单一,性能也觉得不是很快

ASP.NET MVC学习系列(二)-WebAPI请求

继续接着上文 ASP.NET MVC学习系列(一)-WebAPI初探 来看看对于一般前台页面发起的get和post请求,我们在Web API中要如何来处理. 这里我使用Jquery 来发起异步请求实现数据调用. 继续使用上一文章中的示例,添加一个index.html页面,添加对jquery的引用. 一.无参数Get请求 一般的get请求我们可以使用jquery提供的$.get() 或者$.ajax({type:"get"}) 来实现: 请求的后台Action方法仍为上篇文章中的GetU

Caffe学习系列——工具篇：神经网络模型结构可视化

Caffe学习系列--工具篇:神经网络模型结构可视化 在Caffe中,目前有两种可视化prototxt格式网络结构的方法: 使用Netscope在线可视化 使用Caffe提供的draw_net.py 本文将就这两种方法加以介绍 1. Netscope:支持Caffe的神经网络结构在线可视化工具 Netscope是个支持prototxt格式描述的神经网络结构的在线可视工具,网址:  http://ethereon.github.io/netscope/quickstart.html  它可以用来可

Intelli IDEA学习系列之快捷键篇

Intelli IDEA学习系列之快捷键篇 IDEA简介: IDEA 全称IntelliJ IDEA,是java语言开发的集成环境,IntelliJ在业界被公认为最好的java开发工具之一,尤其在智能代码助手.代码自动提示.重构.J2EE支持.Ant.JUnit.CVS整合.代码审查. 创新的GUI设计等方面的功能可以说是超常的.IDEA是JetBrains公司的产品,这家公司总部位于捷克共和国的首都布拉格,开发人员以严谨著称的东欧程序员为主. 在学习过程中会慢慢补充..... [1.查找] 1

Java Web学习系列——Maven Web项目中集成使用Spring、MyBatis实现对MySQL的数据访问

本篇内容还是建立在上一篇Java Web学习系列——Maven Web项目中集成使用Spring基础之上,对之前的Maven Web项目进行升级改造,实现对MySQL的数据访问. 添加依赖Jar包 这部分内容需要以下Jar包支持 mysql-connector:MySQL数据库连接驱动,架起服务端与数据库沟通的桥梁: MyBatis:一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架: log4j:Apache的开源项目,一个功能强大的日志组件,提供方便的日志记录: 修改后的pom.xm

Oracle学习系列4

Oracle学习系列4 ************************************************************************************ 数据库更新操作: 分类: 查询操作:select 更新操作:insert ,update , delete 为了保存原始的emp表的信息,在进行增删改之前备份词表: create table emp_bak as select * from emp ; //将表emp结构和数据完整的复制出来 添加数据:

Oracle学习系列3

Oracle学习系列3 ************************************************************************************ 多表查询: 1,SQL1999语法对多表查询的支持 2,分组统计及统计函数的使用 3,子查询,并结合多表查询,分组统计做复杂查询 4,数据库的更新操作 5,事务处理和数据库死锁 ****************************************************************

Unity-Animator学习系列总索引

花了不少时间完成了这篇Unity Animator学习系列文章,其中API部分很多都是亲测.希望能对路过的博友有所帮助 相关参考文档 Unity Animator官方组件文档 Unity Animator官方脚本文档 圣典的部分汉化文档 Animator学习系列总目录 1.Unity-Animator学习系列---API 2.Unity-Animator学习系列---控制IK 3.Unity-Animator学习系列---剪辑播放后位置预判(Animator.Target) 4.Unity-An

Python学习系列（八）( 面向对象基础）

 Python学习系列(八)( 面向对象基础) Python学习系列(七)( 数据库编程) 一,面向对象 1,域:属于一个对象或类的变量.有两种类型,即实例变量—属于每个实例/类的对象:类变量—属于类本身. 2,类的方法:对象也可以使用属于类的函数来具有功能,这样的函数称之为类的方法.域和方法合称为类的属性.类使用class关键字创建,类的属性被列在一个缩进块中. 3,self:类的方法与普通的函数只有一个特别的区别----他们必须有一个额外的第一个参数名称,但是在调用的时候不能为其赋值,Pyt