G-API 绘图和合成功能

图内绘图函数。 更多…

主题
	绘图基元
	绘图操作和函数

详细描述

图内绘图函数。

注意

这是一个正在开发中的功能，API 可能会在将来的版本中更改。

G-API 可以使用通用操作和一组渲染基元进行一些图内绘图。与传统的 OpenCV 不同，在 G-API 中，用户需要形成一个用于绘图的基元渲染列表。此列表可以手动构建或在图中生成。此列表将传递给特殊操作或函数，在其中解释所有基元并将其应用于图像。

例如，在一个复杂的流水线中，检测到的对象列表可以在图内转换为cv::gapi::wip::draw::Rect基元列表，以使用边界框突出显示这些对象，或者检测到的面部列表可以在图内转换为cv::gapi::wip::draw::Mosaic基元列表，以隐藏敏感内容或保护隐私。

与任何其他操作一样，G-API 中的渲染也可以由不同的后端重新实现。目前仅提供基于 OpenCV 的后端。

除了图级操作外，还提供了常规的（直接的）类似 OpenCV 的函数 – 请参见cv::gapi::wip::draw::render()。这些函数只是常规 G-API 的包装器，并动态构建渲染图，因此将编译参数作为参数。

目前，此 API 更面向机器，而不是面向人类。其主要目的是将一组特定于领域的物体转换为要绘制的基元列表。例如，要生成这样的图片

需要如下生成渲染列表

#include <opencv2/imgproc.hpp> // cv::FONT*, cv::LINE*, cv::FILLED
#include <opencv2/highgui.hpp> // imwrite
 
#include <opencv2/gapi.hpp>
#include <opencv2/gapi/render.hpp>
 
int main(int argc, char *argv[])
{
    if (argc < 2) {
std::cerr << "需要文件名" << std::endl;
        return 1;
    }
 
    const auto font = cv::FONT_HERSHEY_DUPLEX;
    const auto blue = cv::Scalar{ 255, 0, 0}; // B/G/R
    const auto green = cv::Scalar{ 0, 255, 0};
    const auto coral = cv::Scalar{0x81,0x81,0xF1};
    const auto white = cv::Scalar{ 255, 255, 255};
    cv::Mat test(cv::Size(480, 160), CV_8UC3, white);
 
    namespace draw = cv::gapi::wip::draw;
std::vector<draw::Prim> prims;
prims.emplace_back(draw::Circle{ // CIRCLE 基元
{400,72}, // 位置 (cv::Point)
32, // 半径
coral, // 颜色
            cv::FILLED, // 厚度/填充类型
            cv::LINE_8, // 线类型
0 // 位移
        });
prims.emplace_back(draw::Text{ // TEXT 基元
            "来自 G-API 的问候!", // 文本
{64,96}, // 位置 (cv::Point)
font, // 字体
1.0, // 比例 (大小)
blue, // 颜色
2, // 厚度
            cv::LINE_8, // 线类型
            false // 左下角原点标志
        });
prims.emplace_back(draw::Rect{ // RECTANGLE 基元
{16,48,400,72}, // 几何形状 (cv::Rect)
green, // 颜色
2, // 厚度
            cv::LINE_8, // 线类型
0 // 位移
        });
prims.emplace_back(draw::Mosaic{ // MOSAIC 基元
{320,96,128,32}, // 几何形状 (cv::Rect)
16, // 单元格大小
0 // 抽取
        });
draw::render(test, prims);
    cv::imwrite(argv[1], test);
    return 0;
}