LuatOS/components/hzfont/binding/luat_lib_hzfont.c

/*
@module  hzfont
@summary HzFont字体库
@version 1.0
@date    2025.10.16
@tag LUAT_USE_HZFONT
@usage
-- 使用HzFont渲染TTF字体
-- 需要准备TTF字体文件

-- 初始化字体
hzfont.init("/sd/font.ttf")

-- 获取字符串宽度
local width = hzfont.getStrWidth("Hello世界", 24)
print("字符串宽度:", width)

lcd.drawfreefontUtf8(10, 50, "Hello世界", 24, 0xFFFFFF)
*/

#include "luat_base.h"
#include "luat_hzfont.h"
#include "ttf_parser.h"
#include "luat_lcd.h"

#define LUAT_LOG_TAG "hzfont"
#include "luat_log.h"
#include "rotable2.h"

#include "luat_conf_bsp.h"

/**
初始化HzFont字体库
@api hzfont.init(ttf_path)
@string ttf_path TTF字体文件路径
@return boolean 成功返回true，失败返回false
@usage
hzfont.init("/sd/font.ttf")
*/
static int l_hzfont_init(lua_State* L) {
    size_t len = 0;
    const char* ttf_path = luaL_checklstring(L, 1, &len);
    
    if (!ttf_path || len == 0) {
        LLOGE("TTF path is empty");
        lua_pushboolean(L, 0);
        return 1;
    }
    
    int result = luat_hzfont_init(ttf_path);
    lua_pushboolean(L, result);
    return 1;
}

/**
反初始化HzFont字体库
@api hzfont.deinit()
@usage
hzfont.deinit()
*/
static int l_hzfont_deinit(lua_State* L) {
    (void)L;
    luat_hzfont_deinit();
    return 0;
}

/**
获取当前初始化状态
@api hzfont.state()
@return int 状态值：0-未初始化，1-已初始化，2-错误
@usage
local state = hzfont.state()
if state == 1 then
    print("HzFont已初始化")
end
*/
static int l_hzfont_state(lua_State* L) {
    luat_hzfont_state_t state = luat_hzfont_get_state();
    lua_pushinteger(L, (int)state);
    return 1;
}

/**
获取UTF-8字符串宽度
@api hzfont.getStrWidth(str, fontSize)
@string str UTF-8字符串
@int fontSize 字体大小（像素）
@return int 字符串宽度（像素）
@usage
local width = hzfont.getStrWidth("Hello世界", 24)
print("字符串宽度:", width)
*/
static int l_hzfont_get_str_width(lua_State* L) {
    size_t len = 0;
    const char* str = luaL_checklstring(L, 1, &len);
    int fontSize = luaL_checkinteger(L, 2);
    
    if (fontSize <= 0 || fontSize > 255) {
        LLOGE("Invalid font size: %d", fontSize);
        lua_pushinteger(L, 0);
        return 1;
    }
    
    unsigned int width = luat_hzfont_get_str_width(str, (unsigned char)fontSize);
    lua_pushinteger(L, width);
    return 1;
}

/**
绘制UTF-8字符串到LCD
@api hzfont.drawUtf8(x, y, str, fontSize, color)
@int x X坐标
@int y Y坐标（左下角为基准）
@string str UTF-8字符串
@int fontSize 字体大小（像素）
@int color 颜色值（RGB565格式）
@return boolean 成功返回true，失败返回false
@usage
-- 绘制白色文本
hzfont.drawUtf8(10, 50, "Hello世界", 24, 0xFFFF)
-- 绘制红色文本
hzfont.drawUtf8(10, 80, "红色文本", 24, 0xF800)
*/
static int l_hzfont_draw_utf8(lua_State* L) {
    int x = luaL_checkinteger(L, 1);
    int y = luaL_checkinteger(L, 2);
    size_t len = 0;
    const char* str = luaL_checklstring(L, 3, &len);
    int fontSize = luaL_checkinteger(L, 4);
    uint32_t color = luaL_checkinteger(L, 5);
    
    if (fontSize <= 0 || fontSize > 255) {
        LLOGE("Invalid font size: %d", fontSize);
        lua_pushboolean(L, 0);
        return 1;
    }
    
    int result = luat_hzfont_draw_utf8(x, y, str, (unsigned char)fontSize, color);
    lua_pushboolean(L, result == 0 ? 1 : 0);
    return 1;
}

/**
调试开关
@api hzfont.debug(enable)
@boolean enable true 开启，false 关闭
@return boolean 总是返回true
*/
static int l_hzfont_debug(lua_State* L) {
    int enable = lua_toboolean(L, 1);
    (void)ttf_set_debug(enable);
    lua_pushboolean(L, 1);
    return 1;
}

static const rotable_Reg_t reg_hzfont[] = {
    { "init",        ROREG_FUNC(l_hzfont_init)},
    { "deinit",      ROREG_FUNC(l_hzfont_deinit)},
    { "state",       ROREG_FUNC(l_hzfont_state)},
    { "getStrWidth", ROREG_FUNC(l_hzfont_get_str_width)},
    { "drawUtf8",    ROREG_FUNC(l_hzfont_draw_utf8)},
    { "debug",       ROREG_FUNC(l_hzfont_debug)},
    { NULL,          ROREG_INT(0)}
};

LUAMOD_API int luaopen_hzfont(lua_State *L) {
    luat_newlib2(L, reg_hzfont);
    return 1;
}