OpenCV杂记（1）：绘制OSD（cv::getTextSize, cv::putText）

1. 简述

        我们使用OpenCV时，有时会在图像的某个位置绘制OSD信息，如绘制一些字符串作为指示信息。

本文将简要介绍在图像（cv::Mat）上绘制固定的字符串信息。

2. 使用的API

（1）cv::getTextSize()

CV_EXPORTS_W Size getTextSize(const String& text,

                                                          int fontFace,

                                                          double fontScale,

                                                          int thickness,

                                                          CV_OUT int* baseLine);

        一般情况下，我们可以直接指定绘制文本的原点信息（默认为左下角坐标），但为了防止出现字符串溢出的问题，还是建议首先通过该API获得在图像上的大小信息。

参数解释：

text：要绘制的文本字符串

fontFace：字体的类型参照HersheyFonts

fontScale：字体放大倍数

thicknes：用于绘制文本的线条的粗细

baseLine：相对于最底部文本的基线y坐标指向

baseLine是文本最低点对应的Y坐标，如下，蓝色线条的Y坐标即是baseLine。

（baseLine指示信息）

（2）cv::putText

CV_EXPORTS_W void putText( InputOutputArray img,

                                                    const String& text, Point org,

                                                    int fontFace,

                                                    double fontScale,

                                                    Scalar color,

                                                    int thickness = 1,

                                                    int lineType = LINE_8,

                                                    bool bottomLeftOrigin = false );

参数解释：

img: 图像；

text: 要绘制的文本字符串；

org: 所绘制文本字符串的原点（默认是左下角，由bottomLeftOrigin控制）；

fontFace: 字体的类型参照HersheyFonts；

fontScale: 乘以特定于字体的基本大小的字体比例因子(放大倍数)；

color: 字体的颜色；

thickness: 用于绘制文本的线条的粗细；

lineType: 线条的类型参照LineTypes；

bottomLeftOrigin: 如果为true，则图像数据原点位于左下角。否则，它在左上角；

fontFace的取值如下：

FONT_HERSHEY_SIMPLEX = 0    普通大小无衬线字体

FONT_HERSHEY_PLAIN = 1  小号无衬线字体

FONT_HERSHEY_DUPLEX = 2 普通大小无衬线字体

FONT_HERSHEY_COMPLEX = 3    普通大小无衬线字体比 FONT_HERSHEY_DUPLEX 更复杂

FONT_HERSHEY_TRIPLEX = 4    普通大小无衬字体，比 FONT_HERSHEY_COMPLEX 更复杂

FONT_HERSHEY_COMPLEX_SMALL = 5  小号版本的 FONT_HERSHEY_COMPLEX

FONT_HERSHEY_SCRIPT_SIMPLEX = 6 手写字体

FONT_HERSHEY_SCRIPT_COMPLEX = 7 比 FONT_HERSHEY_SCRIPT_SIMPLEX 更复杂的变体

FONT_ITALIC =16 斜体（上面的字体都可以和斜体一起使用）

3. 参考例程

#include <opencv2/opencv.hpp>  
 
#include <iostream>  
 
 
 
int main(int argc, char* argv[])
 
{
 
    /** 读取图像. */
 
    cv::Mat image = cv::imread("demo.jpg"); ///< 替换为你的图片路径  
 
    if (image.empty()) {  
 
        std::cerr << "Loading image failed!" << std::endl;  
 
        return -1;  
 
    }  
 
 
 
    /** 设置OSD文本. */
 
    std::string osdText = "OSD Info";
 
    cv::Point org(50, 50); ///< 文本开始的坐标  
 
    int fontFace = cv::FONT_HERSHEY_SIMPLEX;  
 
    double fontScale = 1.0;  
 
    int thickness = 2;  
 
 
 
    /** 获取文本尺寸. */
 
    int baseLine;  
 
    cv::Size textSize = cv::getTextSize(osdText, fontFace, fontScale, thickness, &baseLine);  
 
 
 
    /** 确保文本在图像范围内. */
 
    if (org.x + textSize.width > image.cols) {  
 
        org.x = image.cols - textSize.width - 10; ///< 留出10个像素的边距  
 
    }  
 
    if (org.y - baseLine < 0) {  
 
        org.y = baseLine + 10; ///< 留出10个像素的边距  
 
    }  
 
 
 
    /** 设置文本颜色. */
 
    cv::Scalar color(0, 0, 255); ///< 红色  
 
 
 
    /** 绘制OSD文本. */
 
    cv::putText(image, osdText, org, fontFace, fontScale, color, thickness, cv::LINE_AA);  
 
 
 
    /** 显示和保存图像. */
 
    cv::imwrite("demo_osd.jpg", image); ///< 保存图像  
 
    sleep(1);
 
 
 
    return 0;  
 
}