版权声明:本文为博主原创文章,未经博主允许不得转载。
在tesseract-ocr中会用到leptonica库,这里对leptonica简单介绍下。
Leptonica是一个开源的图像处理和图像分析库,它的license是BSD 2-clause。它主要包括的操作有:位图操作、仿射变换、形态学操作、连通区域填充、图像变换及像素掩模、融合、增强、算术运算等操作。
在使用Leptonica的时候,它依赖于开源的zlib、libjpeg、libpng、libtiff、giflib。
zlib是一个很好的压缩、解压缩库。它的license是zlib授权,类似BSD。
libjpeg是一个完全用C语言编写的库,包含了被广泛使用的JPEG解码、JPEG编码和其它的JPEG功能的实现。它的license类似BSD。
libpng是官方的PNG参考库,它支持几乎所有的PNG功能,它也是可扩展的。它使用zlib库作为压缩引擎。它的license是permissive free software license,类似BSD。
libtiff是一个用来读写TIFF文件的开源库,它依赖于libjpeg和zlib。它的license是BSD。
giflib是一个读、写GIF图像的开源库,它的license类似BSD。
下面详细介绍Leptonica的编译步骤:
1. 从http://www.zlib.net/ 下载最新的zlib-1.2.8源码,新建zlib静态库工程,将/zlib-1.2.8目录下的.h、.c文件加入到此工程中,编译生成zlib静态库;
2. 从http://www.libpng.org/pub/png/libpng.html下载最新的libpng-1.6.16,新建libpng静态库工程,将/lpng1616目录下的.h、.c文件加入到此工程中,将/lpng1616/scripts目录下的pnglibconf.h.prebuilt文件拷贝到/lpng1616目录下,并修改文件名为pnglibconf.h,将此文件也加入到此工程中,将pngstruct.h文件中zlib.h改成正确的存放路径,编译生成libpng静态库;
3. 从http://www.ijg.org/files/ 下载最新的jpeg-9a源码,新建ligjpeg静态库工程,将/jpeg-9a目录下的.h、.c文件加入到此工程中(jmemdos.c和jmemmac.c文件除外),将jconfig.vc重命名为jconfig.h,将此文件也加入到此工程中,编译生成libjpeg静态库;
4. 从ftp://ftp.remotesensing.org/pub/libtiff下载稳定版的tiff-4.0.3源码,新建libtiff静态库工程,将/tiff-4.0.3/libtiff目录下相应的.h、.c文件加入到此工程中,将tiff_config.vc.h、tiffconf.vc.h分别重命名为tiff_config.h、tiffconf.h,将此两个文件也加入到此工程中,编译生成libtiff静态库;
5. 从http://sourceforge.net/projects/giflib/下载最新的gitlib-5.1.1源码,新建giflib静态库工程,将/giflib-5.1.1目录下相应的.h、.c文件加入到此工程中,对源文件进行调整,将源文件中用到#include <stdbool.h>的地方,用以下语句替换,
- //#include <stdbool.h>
- #ifndef __cplusplus
- typedef int bool;
- #define false 0
- #define true 1
- #endif
将文件中用到的#include<unistd.h>的地方均注释掉,编译生成giflib静态库;
6. 从http://www.leptonica.org/download.html下载最新的leptonica-1.71源码,新建liblept静态库工程,将/leptonica-1.71/src目录下相应的.h、.c文件加入到此工程中,调整:(1)、将zlib、libtiff、libpng、gif_lib.h、jpeglib.h相关头文件通过工程配置(C/C++-->Additional Include Directories)加入到此工程;(2)、将environ.h文件中的#defineHAVE_LIBGIF 0改为#define HAVA_LIBGIF 1 使其支持Gif图像格式;(3)、有些文件会出现奇怪的C2275和C2146错误,解决方法,找到出错处,将所有变量的声明放在函数的开头即可;(4)、有些文件会出现奇怪的C2057错误,解决方法,注释掉类似的static const l_int32 L_BUF_SIZE = 52;新建一个redefineconstant.h文件,将此文件包含到出现此问题的文件中,redefineconstant.h文件的内容为:
- #ifndef _REDEFINE_CONSTANT_H
- #define _REDEFINE_CONSTANT_H
- #include "allheaders.h"
- #define L_BUF_SIZE 512
- #define MAX_ALLOWED_DILATION 25
- #endif // _REDEFINE_CONSTANT_H
7. 新建liblepttest控制台工程,对liblept库进行简单测试,相关文件代码如下:
stdafx.h:
- #pragma once
- #include "targetver.h"
- #include <stdio.h>
- #include "../../../ImgCore/src/zlib/zlib-1.2.8/zlib.h"
- #include "../../../ImgCore/src/libpng/lpng1616/png.h"
- #include "../../../ImgCore/src/libjpeg/jpeg-9a/jpeglib.h"
- #include "../../../ImgCore/src/libtiff/tiff-4.0.3/libtiff/tiff.h"
- #include "../../../ImgCore/src/giflib/giflib-5.1.1/lib/gif_lib.h"
- #include "../../src/leptonica-1.71/src/allheaders.h"
stdafx.cpp:
- #include "stdafx.h"
- // TODO: reference any additional headers you need in STDAFX.H
- // and not in this file
- #ifdef _DEBUG
- #pragma comment(lib, "../../../../ImgCore/lib/dbg/x86_vc10/zlib[dbg_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/dbg/x86_vc10/libpng[dbg_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/dbg/x86_vc10/libjpeg[dbg_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/dbg/x86_vc10/libtiff[dbg_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/dbg/x86_vc10/giflib[dbg_x86_vc10].lib")
- #pragma comment(lib, "../../../lib/dbg/x86_vc10/liblept[dbg_x86_vc10].lib")
- #else
- #pragma comment(lib, "../../../../ImgCore/lib/rel/x86_vc10/zlib[rel_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/rel/x86_vc10/libpng[rel_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/rel/x86_vc10/libjpeg[rel_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/rel/x86_vc10/libtiff[rel_x86_vc10].lib")
- #pragma comment(lib, "../../../../ImgCore/lib/rel/x86_vc10/giflib[rel_x86_vc10].lib")
- #pragma comment(lib, "../../../lib/rel/x86_vc10/liblept[rel_x86_vc10].lib")
- #endif
liblepttest.cpp:
- #include "stdafx.h"
- #include <iostream>
- #include <string>
- using namespace std;
- static const l_float32 ANGLE1 = 3.14159265 / 12.;
- void RotateTest()
- {
- string strSrc = "../../../testdata/weasel.png";
- string strDst = "../../../testdata/dst.gif";
- PIX* pixs = pixRead(strSrc.c_str());
- if (pixs == NULL) {
- cout<<" read image error "<<endl;
- return;
- }
- l_int32 w, h, d;
- pixGetDimensions(pixs, &w, &h, &d);
- PIX* pixd = pixRotate(pixs, ANGLE1, L_ROTATE_SHEAR, L_BRING_IN_WHITE, w, h);
- pixWrite(strDst.c_str(), pixd, IFF_GIF);
- pixDestroy(&pixs);
- pixDestroy(&pixd);
- }
- void EdgeTest()
- {
- string strSrc = "../../../testdata/marge.jpg";
- string strDst = "../../../testdata/dst.bmp";
- PIX* pixs = pixRead(strSrc.c_str());
- if (pixs == NULL) {
- cout<<" read image error "<<endl;
- return;
- }
- l_int32 w, h, d;
- pixGetDimensions(pixs, &w, &h, &d);
- if (d != 8) {
- cout<<"pixs not 8 bpp"<<endl;
- return;
- }
- PIX* pixf = pixSobelEdgeFilter(pixs, L_HORIZONTAL_EDGES);
- PIX* pixd = pixThresholdToBinary(pixf, 10);
- pixInvert(pixd, pixd);
- pixWrite(strDst.c_str(), pixd, IFF_BMP);
- pixDestroy(&pixs);
- pixDestroy(&pixf);
- pixDestroy(&pixd);
- }
- int main(int argc, char* argv[])
- {
- RotateTest();
- EdgeTest();
- cout<<"ok!"<<endl;
- return 0;
- }