Linux使用freetype解决Opencv中文字体显示问题

FreeType 库是一个完全免费（开源）的、高质量的、可移植的字体引擎，它提供统一的接口来访问多种字体格式文件。

FreeType 库下载与安装：

FreeType源码下载： Index of /releases/freetype/

编译：

./configure
make
make install

头文件在include， 库文件在objs/.libs

使用例子：

//Cv310Text.h

#ifndef CV310TEXT_H
#define CV310TEXT_H

#include <ctype.h>
#include <locale.h>
#include <wchar.h>
#include <ft2build.h>
#include FT_FREETYPE_H
#include <opencv2/core/core.hpp>
#include <opencv2/imgproc/imgproc.hpp>
#include <opencv2/highgui/highgui.hpp>

class Cv310Text
{


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

public:

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

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

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

    /**
    * 获取字体。目前有些参数尚不支持。
    *
    * \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(cv::Mat &frame, const char    *text, CvPoint pos);

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

    int putText(cv::Mat &frame, const wchar_t *text, CvPoint pos);

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

    int putText(cv::Mat &frame, const char    *text, CvPoint pos, CvScalar color);

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

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

private:

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

    void putWChar(cv::Mat &frame, 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 // CV310TEXT_H

Cv310Text.cpp

#include "Cv310Text.h"
#include <wchar.h>
#include <assert.h>
#include <locale.h>
#include <ctype.h>


Cv310Text::Cv310Text(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资源

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

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

void Cv310Text::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 Cv310Text::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 Cv310Text::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 Cv310Text::putText(cv::Mat &frame, const char    *text, CvPoint pos)
{
    return putText(frame, text, pos, CV_RGB(255, 255, 255));
}
int Cv310Text::putText(cv::Mat &frame, const wchar_t *text, CvPoint pos)
{
    return putText(frame, text, pos, CV_RGB(255, 255, 255));
}

//

int Cv310Text::putText(cv::Mat &frame, const char    *text, CvPoint pos, CvScalar color)
{
    if (frame.empty()) 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(frame, wc, pos, color);
    }
    return i;
}
int Cv310Text::putText(cv::Mat &frame, const wchar_t *text, CvPoint pos, CvScalar color)
{

    if (frame.empty()) return -1;
    if (text == NULL) return -1;

    //

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

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

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

void Cv310Text::putWChar(cv::Mat &frame, wchar_t wc, CvPoint &pos, CvScalar color)
{
    // 根据unicode生成字体的二值位图
    IplImage timg;
    IplImage* img=&timg;
    timg = ((IplImage)frame);



    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);
}

main.cpp



#include <opencv2/core/core.hpp>
#include <opencv2/imgproc/imgproc.hpp>
#include <opencv2/opencv.hpp>

#include <vector>
#include <cstdio>
#include <QDebug>
#include "Cv310Text.h"

using namespace std;



int ToWchar(const char* src, wchar_t* &dest, const char *locale = "zh_CN.utf8")
{
  if (src == NULL) {
    dest = NULL;
    return 0;
  }

  // 根据环境变量设置locale
  setlocale(LC_CTYPE, locale);

  // 得到转化为需要的宽字符大小
  int w_size = mbstowcs(NULL, src, 0) + 1;

  // w_size = 0 说明mbstowcs返回值为-1。即在运行过程中遇到了非法字符(很有可能使locale
  // 没有设置正确)
  if (w_size == 0) {
    dest = NULL;
    return -1;
  }


  dest = new wchar_t[w_size];
  if (!dest) {
      return -1;
  }

  int ret = mbstowcs(dest, src, strlen(src)+1);
  if (ret <= 0) {
    return -1;
  }
  return 0;
}


int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    cv::Mat srcImage,dstImage1, dstImage2;
    srcImage = cv::imread("./myface.jpg");
    cv::imwrite("原图.jpg", srcImage);

///
    dstImage1 = srcImage.clone();
    cv::putText(dstImage1, "123abc中文", cvPoint(30,30), cv::FONT_HERSHEY_PLAIN, 1.2, cv::Scalar(0, 0, 255));
    cv::imwrite("乱码.jpg", dstImage1);

///
    dstImage2 = srcImage.clone();
    char *text = "simfang.ttf";    //中文库可以在win上拷贝过来
    Cv310Text cvtext(text);

    wchar_t *w_str = (wchar_t*)malloc(sizeof(wchar_t) * 2048);
    memset(w_str, 0, sizeof(wchar_t) * 2048);
    ToWchar(text,w_str);
    cvtext.putText(newface, w_str, cvPoint(20, 40), CV_RGB(0, 0, 255)); //BGR
    free(w_str);


    return a.exec();
}