C++ 不使用第三方库在 RGB 图像上叠加文字

先看效果

直接上代码

// *********************************************
// FileName: text_overlay.hpp
// Brief:
//
// Date: 8 Aug. 2025
// Author: ...
// *********************************************
#ifndef TEXT_OVERLAY_HPP
#define TEXT_OVERLAY_HPP
#include <cstdint>
#include <algorithm>
#include <cstdio>
#include <cstring>

namespace OVERLAY {
enum class PixFmt { YUV_NV12, RGB24 };

/* ---------- 1. 8×8 字模表（ASCII） ---------- */
// https://github.com/dhepper/font8x8
const uint8_t font8x8_ib8x8u[224][8] = {
    // --------------------------- 0-127 ---------------------------
    {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}, // 0000 (uni0000.dup1)
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }, 
    {, , , , , , , }  
};

{
     idx = <>(c);
     font8x8_ib8x8u[idx];
}

;
;


{
     (fmt == PixFmt::RGB24) {
        * p = <*>(data) + (y * w + x) * ;
        p[] = r; p[] = g; p[] = b;
    }   (fmt == PixFmt::YUV_NV12) {
        * Y_plane = <*>(data);
        * U_plane = Y_plane + w * h;
        * V_plane = U_plane + (w / ) * (h / );
        * UV_plane = Y_plane + w * h;
        Y_plane[y * w + x] = Y;
         x2 = x / , y2 = y / ;
        UV_plane[y2 * w + x] = U;
        UV_plane[y2 * w + x + ] = V;
    }
}

{
     * bm = (c);
     ( row = ; row < ; ++row) {
         bits = bm[row];
         ( col = ; col < ; ++col) {
             (!(bits & ( << ( - col)))) ;
             ( dy = ; dy < scale; ++dy)
                 ( dx = ; dx < scale; ++dx) {
                     px = x0 + col * scale + dx;
                     py = y0 + row * scale + dy;
                     (px <  || px >= w || py <  || py >= h) ;
                    (data, w, h, fmt, px, py, r, g, b, Y, U, V);
                }
        }
    }
}

{
     (; *text; ++text) {
        (data, imgW, imgH, imgFmt, x, y, *text, scale, r, g, b, Y, U, V);
        x += space * scale;
    }
}

{
     space = ;
     (; *text; ++text) {
        (data, imgW, imgH, PixFmt::RGB24, x, y, *text, fontSize, r, g, b);
        x += space * fontSize;
    }
}

{
    FILE* fp = (filename, );
     (!fp)  ;
    (fp, , w, h);
    (rgb, , w * h * , fp);
    (fp);
     ;
}
}

{
     imgW = ;
     imgH = ;
     rgb[imgW * imgH * ];
    
    std::(rgb, , imgW * imgH * );
    
    
    OVERLAY::(rgb, imgW, imgH, , , , , );
    OVERLAY::(rgb, imgW, imgH, , , , , , , );
    OVERLAY::(rgb, imgW, imgH, , , , , , , );
    OVERLAY::(rgb, imgW, imgH, , , , , , , );
    OVERLAY::(, rgb, imgW, imgH);
     ;
}