freetype+opencv+vs2010图片/视频显示汉字

参考了很多别的大牛们写的博客，在此整理一下：

• opencv+vs配置
• freeType+vs:编译与配置
• 工程demo中须添加的代码和资源等
• 测试
• 参考网址
• 遇到的问题

---

1.opencv+vs配置

熟悉opencv也有一段时间了，最重要的是版本匹配问题！！！

vs2010以前的下载opencv2.x就好了，更高版本的vs可以体验opencv3.x，自己cmake一下也是可以跨版本使用的，然而何必那么麻烦呢==

当你需要显示汉字的时候，opencv一定用的很6啦，所以这个配置就不详细说了==
（1）配置系统变量
（2）添加包含目录、库目录
（3）添加附加依赖项(.lib）
几乎所有的第三方库都是这个流程。

另外，可以只对当前工程配置，也可以在属性管理器配置（会被以后建立的工程继承）或者添加属性表（一表写好，有必要就添加）。

2.freeType库的编译

下载

http://download.savannah.gnu.org/releases/freetype/

编译

1. 进入\freetype-2.x\builds\win32\vc2010，打开工程并编译（编译选项可选）；
2. 在\freetype-2.x\objs\win32\vc2010里可看到生成的lib文件；
3. 添加包含目录路径：\freetype-2.x\include
   添加库目录路径：\freetype-2.x\objs\win32\vc2010
   添加附加依赖项：(eg.)freetype2410_D.lib
   (便于管理，也可以把\include和\objs\win32\vc2010放在一个单独的文件夹中，分别名为include和lib)；

3.工程demo中须添加的代码和资源等

添加头文件

CvxText.h:

//====================================================================
//====================================================================
//
// 文件: CvxText.h
//
// 说明: OpenCV汉字输出
//
// 时间: 
//
// 作者: chaishushan#gmail.com
//
//====================================================================
//====================================================================

#ifndef OPENCV_CVX_TEXT_2007_08_31_H
#define OPENCV_CVX_TEXT_2007_08_31_H

/**
* \file CvxText.h
* \brief OpenCV汉字输出接口
*
* 实现了汉字输出功能。
*/

#include 
#include FT_FREETYPE_H

#include

/**
* \class CvxText
* \brief OpenCV中输出汉字
*
* OpenCV中输出汉字。字库提取采用了开源的FreeFype库。由于FreeFype是
* GPL版权发布的库，和OpenCV版权并不一致，因此目前还没有合并到OpenCV
* 扩展库中。
*
* 显示汉字的时候需要一个汉字字库文件，字库文件系统一般都自带了。
* 这里采用的是一个开源的字库：“文泉驿正黑体”。
*
* 关于"OpenCV扩展库"的细节请访问
* http://code.google.com/p/opencv-extension-library/
*
* 关于FreeType的细节请访问
* http://www.freetype.org/
*/


class CvxText  
{
   // 禁止copy

   CvxText& operator=(const CvxText&);

   //================================================================
   //================================================================

public:

   /**
    * 装载字库文件
    */

   CvxText(const char *freeType);
   virtual ~CvxText();

   //================================================================
   //================================================================

   /**
    * 获取字体。目前有些参数尚不支持。
    *
    * \param font        字体类型, 目前不支持
    * \param size        字体大小/空白比例/间隔比例/旋转角度
    * \param underline   下画线
    * \param diaphaneity 透明度
    *
    * \sa setFont, restoreFont
    */

   void getFont(int *type,
      CvScalar *size=NULL, bool *underline=NULL, float *diaphaneity=NULL);

   /**
    * 设置字体。目前有些参数尚不支持。
    *
    * \param font        字体类型, 目前不支持
    * \param size        字体大小/空白比例/间隔比例/旋转角度
    * \param underline   下画线
    * \param diaphaneity 透明度
    *
    * \sa getFont, restoreFont
    */

   void setFont(int *type,
      CvScalar *size=NULL, bool *underline=NULL, float *diaphaneity=NULL);

   /**
    * 恢复原始的字体设置。
    *
    * \sa getFont, setFont
    */

   void restoreFont();

   //================================================================
   //================================================================

   /**
    * 输出汉字(颜色默认为黑色)。遇到不能输出的字符将停止。
    *
    * \param img  输出的影象
    * \param text 文本内容
    * \param pos  文本位置
    *
    * \return 返回成功输出的字符长度，失败返回-1。
    */

   int putText(IplImage *img, const char    *text, CvPoint pos);

   /**
    * 输出汉字(颜色默认为黑色)。遇到不能输出的字符将停止。
    *
    * \param img  输出的影象
    * \param text 文本内容
    * \param pos  文本位置
    *
    * \return 返回成功输出的字符长度，失败返回-1。
    */

   int putText(IplImage *img, const wchar_t *text, CvPoint pos);

   /**
    * 输出汉字。遇到不能输出的字符将停止。
    *
    * \param img   输出的影象
    * \param text  文本内容
    * \param pos   文本位置
    * \param color 文本颜色
    *
    * \return 返回成功输出的字符长度，失败返回-1。
    */

   int putText(IplImage *img, const char    *text, CvPoint pos, CvScalar color);

   /**
    * 输出汉字。遇到不能输出的字符将停止。
    *
    * \param img   输出的影象
    * \param text  文本内容
    * \param pos   文本位置
    * \param color 文本颜色
    *
    * \return 返回成功输出的字符长度，失败返回-1。
    */
   int putText(IplImage *img, const wchar_t *text, CvPoint pos, CvScalar color);

   //================================================================
   //================================================================

private:

   // 输出当前字符, 更新m_pos位置

   void putWChar(IplImage *img, wchar_t wc, CvPoint &pos, CvScalar color);

   //================================================================
   //================================================================

private:

   FT_Library   m_library;   // 字库
   FT_Face      m_face;      // 字体

   //================================================================
   //================================================================

   // 默认的字体输出参数

   int         m_fontType;
   CvScalar   m_fontSize;
   bool      m_fontUnderline;
   float      m_fontDiaphaneity;

   //================================================================
   //================================================================
};

#endif // OPENCV_CVX_TEXT_2007_08_31_H

添加源文件

#include 
#include 
#include 
#include 

#include "CvxText.h"

//====================================================================
//====================================================================

// 打开字库

CvxText::CvxText(const char *freeType)
{
    assert(freeType != NULL);

    // 打开字库文件, 创建一个字体

    if(FT_Init_FreeType(&m_library)) throw;
    if(FT_New_Face(m_library, freeType, 0, &m_face)) throw;

    // 设置字体输出参数

    restoreFont();

    // 设置C语言的字符集环境

    setlocale(LC_ALL, "");
}

// 释放FreeType资源

CvxText::~CvxText()
{
    FT_Done_Face    (m_face);
    FT_Done_FreeType(m_library);
}

// 设置字体参数:
//
// font         - 字体类型, 目前不支持
// size         - 字体大小/空白比例/间隔比例/旋转角度
// underline   - 下画线
// diaphaneity   - 透明度

void CvxText::getFont(int *type, CvScalar *size, bool *underline, float *diaphaneity)
{
    if(type) *type = m_fontType;
    if(size) *size = m_fontSize;
    if(underline) *underline = m_fontUnderline;
    if(diaphaneity) *diaphaneity = m_fontDiaphaneity;
}

void CvxText::setFont(int *type, CvScalar *size, bool *underline, float *diaphaneity)
{
    // 参数合法性检查

    if(type)
    {
        if(type >= 0) m_fontType = *type;
    }
    if(size)
    {
        m_fontSize.val[0] = fabs(size->val[0]);
        m_fontSize.val[1] = fabs(size->val[1]);
        m_fontSize.val[2] = fabs(size->val[2]);
        m_fontSize.val[3] = fabs(size->val[3]);
    }
    if(underline)
    {
        m_fontUnderline   = *underline;
    }
    if(diaphaneity)
    {
        m_fontDiaphaneity = *diaphaneity;
    }
    //FT_Set_Pixel_Sizes(m_face, (int)m_fontSize.val[0], 0);
}

// 恢复原始的字体设置

void CvxText::restoreFont()
{
    m_fontType = 0;            // 字体类型(不支持)

    m_fontSize.val[0] = 20;      // 字体大小
    m_fontSize.val[1] = 0.5;   // 空白字符大小比例
    m_fontSize.val[2] = 0.1;   // 间隔大小比例
    m_fontSize.val[3] = 0;      // 旋转角度(不支持)

    m_fontUnderline   = false;   // 下画线(不支持)

    m_fontDiaphaneity = 1.0;   // 色彩比例(可产生透明效果)

    // 设置字符大小

    FT_Set_Pixel_Sizes(m_face, (int)m_fontSize.val[0], 0);
}

// 输出函数(颜色默认为黑色)

int CvxText::putText(IplImage *img, const char    *text, CvPoint pos)
{
    return putText(img, text, pos, CV_RGB(255,255,255));
}
int CvxText::putText(IplImage *img, const wchar_t *text, CvPoint pos)
{
    return putText(img, text, pos, CV_RGB(255,255,255));
}

//

int CvxText::putText(IplImage *img, const char    *text, CvPoint pos, CvScalar color)
{
    if(img == NULL) return -1;
    if(text == NULL) return -1;

    //

    int i;
    for(i = 0; text[i] != '\0'; ++i)
    {
        wchar_t wc = text[i];

        // 解析双字节符号

        if(!isascii(wc)) mbtowc(&wc, &text[i++], 2);

        // 输出当前的字符

        putWChar(img, wc, pos, color);
    }
    return i;
}
int CvxText::putText(IplImage *img, const wchar_t *text, CvPoint pos, CvScalar color)
{
    if(img == NULL) return -1;
    if(text == NULL) return -1;

    //

    int i;
    for(i = 0; text[i] != '\0'; ++i)
    {
        // 输出当前的字符

        putWChar(img, text[i], pos, color);
    }
    return i;
}

// 输出当前字符, 更新m_pos位置

void CvxText::putWChar(IplImage *img, wchar_t wc, CvPoint &pos, CvScalar color)
{
    // 根据unicode生成字体的二值位图

    FT_UInt glyph_index = FT_Get_Char_Index(m_face, wc);
    FT_Load_Glyph(m_face, glyph_index, FT_LOAD_DEFAULT);
    FT_Render_Glyph(m_face->glyph, FT_RENDER_MODE_MONO);

    //

    FT_GlyphSlot slot = m_face->glyph;

    // 行列数

    int rows = slot->bitmap.rows;
    int cols = slot->bitmap.width;

    //

    for(int i = 0; i < rows; ++i)
    {
        for(int j = 0; j < cols; ++j)
        {
            int off  = ((img->origin==0)? i: (rows-1-i))
                * slot->bitmap.pitch + j/8;

            if(slot->bitmap.buffer[off] & (0xC0 >> (j%8)))
            {
                int r = (img->origin==0)? pos.y - (rows-1-i): pos.y + i;;
                int c = pos.x + j;

                if(r >= 0 && r < img->height
                    && c >= 0 && c < img->width)
                {
                    CvScalar scalar = cvGet2D(img, r, c);

                    // 进行色彩融合

                    float p = m_fontDiaphaneity;
                    for(int k = 0; k < 4; ++k)
                    {
                        scalar.val[k] = scalar.val[k]*(1-p) + color.val[k]*p;
                    }

                    cvSet2D(img, r, c, scalar);
                }
            }
        } // end for
    } // end for

    // 修改下一个字的输出位置

    double space = m_fontSize.val[0]*m_fontSize.val[1];
    double sep   = m_fontSize.val[0]*m_fontSize.val[2];

    pos.x += (int)((cols? cols: space) + sep);
}

添加字体

从C:\Windows\Fonts复制一个中文字体(.ttf)到工程目录下。

4.测试

test

#include "CvxText.h"

using namespace cv;

int main(int argc, char *argv[]) 
{ 
    IplImage *img=cvLoadImage("test.jpg");
    CvxText text("msyh.ttf"); 
    const char *msg = "hi,你好";
    float p = 0.5; 
    text.setFont(NULL, NULL, NULL, &p);   
    text.putText(img, msg, cvPoint(150, 200), CV_RGB(0,0,255)); 

    cvShowImage("test",img);
    waitKey();
    return 0; 
} 

5.参考网址

• http://www.opencv.org.cn/forum.php?mod=viewthread&tid=2083&extra=&page=1
• http://blog.csdn.net/ubunfans/article/details/45719009
• http://blog.csdn.net/huixingshao/article/details/43563853

6.遇到的问题

在编译test工程时，遇到了LNK2005的问题，错误提示：

“msvcrt.lib(MSVCRT.dll) : error LNK2005: _memmove already defined in libcmtd.lib(memmove.obj)”
“……”

我的解决方法是在“属性->链接器->输入->忽略特定默认库”里加上了LIBCMTD.lib，如果遇到了其他的errors则需要进行对应的分析。