Agent Skills › espressif/esp-claw › bdf_font_converter

bdf_font_converter

GitHub

将可写存储中的Unicode BDF位图字体转换为显示模块使用的DFN1格式。支持水平BDF 2.1/2.2，限制字形尺寸及编码数量，失败时直接报告解析错误。

components/lua_modules/lua_module_display/skills/bdf_font_converter/SKILL.md espressif/esp-claw

触发场景

需要将BDF字体转换为DFN1格式创建用于显示的字体文件

安装

npx skills add espressif/esp-claw --skill bdf_font_converter -g -y

更多选项

非标准路径

npx skills add https://github.com/espressif/esp-claw/tree/master/components/lua_modules/lua_module_display/skills/bdf_font_converter -g -y

不安装直接使用

npx skills use espressif/esp-claw@bdf_font_converter

指定 Agent (Claude Code)

npx skills add espressif/esp-claw --skill bdf_font_converter -a claude-code -g -y

安装 repo 全部 skill

npx skills add espressif/esp-claw --all -g -y

预览 repo 内 skill

npx skills add espressif/esp-claw --list

SKILL.md

Frontmatter

{
    "name": "bdf_font_converter",
    "metadata": {
        "cap_groups": [
            "cap_lua"
        ],
        "peripherals": [
            "display"
        ]
    },
    "description": "Convert a Unicode BDF bitmap font in writable storage to the DFN1 format used by the display module."
}

BDF Font Converter

Use this skill when the user wants to create a display font from BDF source. The input and output paths are relative to the writable DATA root.

Run {CUR_SKILL_DIR}/scripts/bdf_to_dfn.lua once with lua_run_script:

{
  "path": "{CUR_SKILL_DIR}/scripts/bdf_to_dfn.lua",
  "args": {
    "input": "fonts/generated.bdf",
    "output": "fonts/generated.dfn",
    "overwrite": false
  }
}

The converter supports horizontal Unicode BDF 2.1/2.2 fonts with FONT_ASCENT, FONT_DESCENT, ENCODING, DWIDTH, BBX, and 1bpp BITMAP data. Keep glyph dimensions and line height at or below 64 pixels. Unencoded glyphs are skipped. Vertical metrics, legacy encoded character sets, and more than 4096 encoded glyphs are rejected.

Generate BDF with Unicode scalar values in ENCODING. Include a DEFAULT_CHAR property or a glyph encoded as 63 when missing glyph fallback is wanted. If conversion fails, report the exact parser error without retrying with changed paths.

版本历史

36b377f 当前 2026-11-02 21:37

元信息

文件数: 0
版本: 36b377f
Hash: 2d61c269
收录时间: 2026-11-02 21:37

bdf_font_converter