渲染一个字

以下程序的功能是渲染一个红色的“字”并将它保存至 PNG 文件中，使用的字体为宋体。

  1. #include <LCUI_Build.h>
  2. #include <LCUI/LCUI.h>
  3. #include <LCUI/graph.h>
  4. #include <LCUI/font.h>
  6. int main( void )
  7. {
  8.         int ret, fid;
  9.         LCUI_Graph img;
  10.         LCUI_FontBitmap bmp;
  11.         LCUI_Pos pos = {25, 25};
  13.         /* 初始化字体处理功能 */
  14.         LCUI_InitFont();
  16.         /* 创建一个图像，并使用灰色填充 */
  17.         Graph_Init( &img );
  18.         Graph_Create( &img, 100, 100 );
  19.         Graph_FillRect( &img, RGB( 240, 240, 240 ), NULL, FALSE );
  21.         /* 载入字体文件 */
  22.         ret = LCUIFont_LoadFile( "C:/Windows/fonts/simsun.ttc" );
  23.         while( ret == 0 ) {
  24.                 /* 获取字体ID */
  25.                 fid = LCUIFont_GetId( "SimSun", NULL );
  26.                 if( fid < 0 ) {
  27.                         break;
  28.                 }
  29.                 /* 载入对应的文字位图，大小为 48 像素 */
  30.                 ret = FontBitmap_Load( &bmp, L'字', fid, 48 );
  31.                 if( ret != 0 ) {
  32.                         break;
  33.                 }
  34.                 /* 绘制红色文字到图像上 */
  35.                 FontBitmap_Mix( &img, pos, &bmp, RGB( 255, 0, 0 ) );
  36.                 Graph_WritePNG( "test_char_render.png", &img );
  37.                 /* 释放内存资源 */
  38.                 FontBitmap_Free( &bmp );
  39.                 Graph_Free( &img );
  40.                 break;
  41.         }
  43.         /* 退出字体处理功能 */
  44.         LCUI_ExitFont();
  45.         return ret;
  46. }

编译运行后，可以在程序所在工作目录下找到 test_char_render.png 文件，打开它可看到如下图所示的内容：

绘制出来的文字

在绘制文字时都需要指定字体的 ID，这个 ID 标识了字体的字族和风格，如果要使用默认的字体，可以使用 -1 作为 ID。字体位图数据是 LCUI_FontBitmap 类型，可以用 FontBitmap_Mix() 函数将该字体位图绘制到指定的图像上，该函数支持自定义字体颜色。

原文: https://docs.lcui.lc-soft.io/zh-cn/font_and_text/render_char.html