Ghostty C 库 Mode 工具实战打包/解包 ANSI 与 DEC 模式标识符编码 DECRPM 响应序列【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty本文以 Ghostty 官方示例 c-vt-modes 为主体完整讲解ghostty-vtC 库中终端模式Mode工具的用法如何使用 16 位紧凑结构打包与解包 ANSI/DEC private 模式标识符以及如何将 DECRPMDEC Private Mode Report响应序列编码到调用方提供的缓冲区中。读完本文你可以基于同一套 API 在自己的 C 程序中实现模式识别、模式查询应答等终端底层功能。示例要解决的问题example/c-vt-modes/README.md 说明了本示例的定位演示如何使用ghostty-vt的 mode 工具集完成两类操作打包/解包模式标识符——将一个“模式号 是否 ANSI 模式”的二元信息编码进一个 16 位整数并提供反向解包编码 DECRPM 响应——把“某模式当前是 set/reset/不识别”这一状态编码为标准的转义序列如ESC[?25;1$y。文档同时指出一个关键工程事实本示例虽然使用build.zig和 Zig 来构建 C 程序以便复用 Ghostty 的构建逻辑、直接依赖源码树但 Ghostty 输出的是一个标准 C 库可以用任何 C 工具链来使用并不绑定 Zig。构建与运行示例目录结构为build.zig——Zig 构建脚本build.zig.zon——包清单声明对 Ghostty 的依赖src/main.c——C 示例程序。构建脚本的核心逻辑见 build.zig通过b.createModule创建模块并用addCSourceFiles直接编译src/main.c无需任何 CMake 或 Makefile通过b.lazyDependency(ghostty, .{})以懒加载方式引入 Ghostty 依赖——只有真正构建时才解析它调用exe_mod.linkLibrary(dep.artifact(ghostty-vt))链接 Ghostty 导出的ghostty-vt库产物注册run步骤支持透传命令行参数。关于依赖声明见 build.zig.zon有两点值得注意本仓库的示例使用路径依赖指向仓库根目录保证示例始终对着随附的同一份源码测试文件中注释给了 URL 依赖的写法示例指向某一 commit 的源码 tar 包并带哈希校验生产嵌入场景中通常采用这种形式把 Ghostty 锁定到确定版本。build.zig中还有一个性能相关的注释将 lazy 依赖的.simd设为false可以得到一个纯静态构建甚至不需要 libc但存在显著的性能损失如果你的宿主程序本来就需要 libc应保持 simd 启用。运行方式与原文档一致在示例目录下执行zig build run头文件 API16 位打包布局所有 API 定义在 include/ghostty/vt/modes.h 中。文件头部的注释给出了最核心的设计一个 mode 是终端模式标识符的紧凑 16 位表示同时编码了数字模式值最多 15 位以及该模式是 ANSI 模式还是 DEC private 模式?前缀。打包布局从最低有效位开始位段含义Bits 0–14模式数值u15取值 0–32767Bit 15ANSI 标志0 DEC private 模式1 ANSI 模式类型定义为typedef uint16_t GhosttyMode;配套三个static inline函数构造与检查均只需一次位运算对应 modes.h 中 L118–L144函数作用实现ghostty_mode_new(uint16_t value, bool ansi)由模式数值与 ANSI 标志构造打包模式(value 0x7FFF) \| (ansi 15)ghostty_mode_value(GhosttyMode mode)提取模式数值0–32767mode 0x7FFFghostty_mode_ansi(GhosttyMode mode)判断是否为 ANSI 模式(mode 15) ! 0文档还特别提醒应使用这些内联辅助函数来构造和检查模式而不要直接手工操作位。常用模式常量速查头文件以宏的形式提供了 ANSI 与 DEC private 两组常用模式modes.h 中 L45–L98每个宏都是ghostty_mode_new的常量调用。摘录常用项ANSI 模式宏模式号说明GHOSTTY_MODE_KAM2Keyboard action禁用键盘GHOSTTY_MODE_INSERT4Insert 插入模式GHOSTTY_MODE_SRM12Send/receive modeGHOSTTY_MODE_LINEFEED20Linefeed/new line modeDEC private 模式节选宏模式号说明GHOSTTY_MODE_DECCKM1光标键模式GHOSTTY_MODE_REVERSE_COLORS5反色显示GHOSTTY_MODE_ORIGIN6原点模式GHOSTTY_MODE_WRAPAROUND7自动回绕GHOSTTY_MODE_CURSOR_BLINKING12光标闪烁GHOSTTY_MODE_CURSOR_VISIBLE25光标可见DECTCEMGHOSTTY_MODE_KEYPAD_KEYS66应用模式小键盘GHOSTTY_MODE_BACKARROW_KEY_MODE67Backarrow 键模式DECBKMGHOSTTY_MODE_NORMAL_MOUSE1000普通鼠标追踪GHOSTTY_MODE_SGR_MOUSE1006SGR 格式鼠标事件GHOSTTY_MODE_ALT_SCROLL1007备选滚动模式GHOSTTY_MODE_ALT_SCREEN1047备选屏幕GHOSTTY_MODE_SAVE_CURSOR1048保存光标DECSCGHOSTTY_MODE_ALT_SCREEN_SAVE1049备选屏幕 保存光标 清屏GHOSTTY_MODE_BRACKETED_PASTE2004括号粘贴GHOSTTY_MODE_SYNC_OUTPUT2026同步输出GHOSTTY_MODE_PASTE_EVENTS5522Kitty 剪贴板协议粘贴事件示例源码逐段解析完整示例见 example/c-vt-modes/src/main.c只包含#include stdio.h和#include ghostty/vt.h两个头文件。1. 打包与解包modes_example对应源码 main.c 中 L4–L20void modes_example() { // Create a mode for DEC mode 25 (cursor visible) GhosttyMode tag ghostty_mode_new(25, false); printf(value%u ansi%d packed0x%04x\n, ghostty_mode_value(tag), ghostty_mode_ansi(tag), tag); // Create a mode for ANSI mode 4 (insert mode) GhosttyMode ansi_tag ghostty_mode_new(4, true); printf(value%u ansi%d packed0x%04x\n, ghostty_mode_value(ansi_tag), ghostty_mode_ansi(ansi_tag), ansi_tag); }按打包布局推演两个例子DEC mode 25value 25ansi 0打包结果 25 | (0 15)0x0019ANSI mode 4value 4ansi 1打包结果 4 | (1 15)0x8004。可以看到同一个数值如 mode 4在 ANSI 与 DEC 两套编号空间里完全靠第 15 位区分这正是“模式号 前缀”二元组被压缩进 16 位的意义可作为哈希键、数组下标或 C 库跨边界传递的紧凑标识。2. 编码 DECRPM 响应decrpm_example对应源码 main.c 中 L22–L39void decrpm_example() { char buf[32]; size_t written 0; // Encode a report that DEC mode 25 (cursor visible) is set GhosttyResult result ghostty_mode_report_encode( GHOSTTY_MODE_CURSOR_VISIBLE, GHOSTTY_MODE_REPORT_SET, buf, sizeof(buf), written); if (result GHOSTTY_SUCCESS) { printf(Encoded %zu bytes: , written); fwrite(buf, 1, written, stdout); printf(\n); // prints: ESC[?25;1$y } }ghostty_mode_report_encode的声明见 modes.h 中 L187–L192GHOSTTY_API GhosttyResult ghostty_mode_report_encode( GhosttyMode mode, GhosttyModeReportState state, char* buf, size_t buf_len, size_t* out_written);参数与语义mode要报告的模式打包的GhosttyModestate报告状态见下表buf/buf_len输出缓冲区可以为 NULL用于探测所需长度out_written成功时写入实际字节数返回GHOSTTY_OUT_OF_SPACE时写入所需的缓冲区大小调用方可据此扩容后重试。生成的序列格式DEC private 与 ANSI 的区别仅在于有无?前缀模式类型序列格式DEC private 模式CSI ? Ps1 ; Ps2 $ yANSI 模式CSI Ps1 ; Ps2 $ y报告状态枚举GhosttyModeReportStatemodes.h 中 L152–L164对应 DECRPM 响应中的Ps2参数枚举值数值含义GHOSTTY_MODE_REPORT_NOT_RECOGNIZED0模式不被识别GHOSTTY_MODE_REPORT_SET1模式已设置启用GHOSTTY_MODE_REPORT_RESET2模式已复位禁用GHOSTTY_MODE_REPORT_PERMANENTLY_SET3模式永久设置GHOSTTY_MODE_REPORT_PERMANENTLY_RESET4模式永久复位因此示例编码 DEC mode 25 的 set 状态输出即 8 字节的ESC[?25;1$y。底层实现与测试佐证C 层的导出函数最终落到 src/terminal/c/modes.zig 的report_encodeL18–L43从源码实现可以看出三个细节类型转换GhosttyMode被bitCast回内部的modes.ModeTag报告状态则经std.enums.fromInt转为内部modes.Report.State状态值非法时直接返回.invalid_value不会写入任何数据缓冲区不足的两段式协议先用定长 writerstd.Io.Writer.fixed写入若发生WriteFailed就用Discardingwriter 重新编码一遍只统计字节数再把该数写入out_written并返回.out_of_space——这保证了“探测长度”路径buf NULL与“缓冲区不足”路径返回一致的长度与头文件契约一致GHOSTTY_SUCCESS/GHOSTTY_OUT_OF_SPACE/ 无效值三类结果与 modes.h 的 Doxygen 注释一一对应。同文件内的单元测试modes.zig 中 L45–L104覆盖了这些行为可作为期望输出参考测试输入断言结果encode DEC mode setDEC 模式 1state1输出\x1B[?1;1$yencode DEC mode resetDEC 模式 1state2输出\x1B[?1;2$yencode ANSI modeANSI 模式 4state1输出\x1B[4;1$y无?前缀encode not recognizedDEC 模式 9999state0输出\x1B[?9999;0$yencode with insufficient buffer1 字节缓冲返回.out_of_space且written 1encode with invalid statestate99返回.invalid_valueencode with null bufferbuf NULL返回.out_of_space且written 0小结c-vt-modes 示例虽然只有百余行 C 代码但覆盖了嵌入ghostty-vt时处理终端模式的完整闭环用 modes.h 的 16 位打包布局在 ANSI/DEC 两套模式编号空间之间无歧义地传递标识符用ghostty_mode_report_encode以“缓冲不足即可探测长度”的两段式协议输出 DECRPM 序列并用 build.zig build.zig.zon 的最小配置完成 C 源码与ghostty-vt库产物的链接。由于 Ghostty 输出的是标准 C 库这套 API 同样适用于任何 C 工具链的嵌入场景行为细节则以 src/terminal/c/modes.zig 的实现与测试为准。【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Ghostty C 库 Mode 工具实战：打包/解包 ANSI 与 DEC 模式标识符，编码 DECRPM 响应序列
Ghostty C 库 Mode 工具实战打包/解包 ANSI 与 DEC 模式标识符编码 DECRPM 响应序列【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty本文以 Ghostty 官方示例 c-vt-modes 为主体完整讲解ghostty-vtC 库中终端模式Mode工具的用法如何使用 16 位紧凑结构打包与解包 ANSI/DEC private 模式标识符以及如何将 DECRPMDEC Private Mode Report响应序列编码到调用方提供的缓冲区中。读完本文你可以基于同一套 API 在自己的 C 程序中实现模式识别、模式查询应答等终端底层功能。示例要解决的问题example/c-vt-modes/README.md 说明了本示例的定位演示如何使用ghostty-vt的 mode 工具集完成两类操作打包/解包模式标识符——将一个“模式号 是否 ANSI 模式”的二元信息编码进一个 16 位整数并提供反向解包编码 DECRPM 响应——把“某模式当前是 set/reset/不识别”这一状态编码为标准的转义序列如ESC[?25;1$y。文档同时指出一个关键工程事实本示例虽然使用build.zig和 Zig 来构建 C 程序以便复用 Ghostty 的构建逻辑、直接依赖源码树但 Ghostty 输出的是一个标准 C 库可以用任何 C 工具链来使用并不绑定 Zig。构建与运行示例目录结构为build.zig——Zig 构建脚本build.zig.zon——包清单声明对 Ghostty 的依赖src/main.c——C 示例程序。构建脚本的核心逻辑见 build.zig通过b.createModule创建模块并用addCSourceFiles直接编译src/main.c无需任何 CMake 或 Makefile通过b.lazyDependency(ghostty, .{})以懒加载方式引入 Ghostty 依赖——只有真正构建时才解析它调用exe_mod.linkLibrary(dep.artifact(ghostty-vt))链接 Ghostty 导出的ghostty-vt库产物注册run步骤支持透传命令行参数。关于依赖声明见 build.zig.zon有两点值得注意本仓库的示例使用路径依赖指向仓库根目录保证示例始终对着随附的同一份源码测试文件中注释给了 URL 依赖的写法示例指向某一 commit 的源码 tar 包并带哈希校验生产嵌入场景中通常采用这种形式把 Ghostty 锁定到确定版本。build.zig中还有一个性能相关的注释将 lazy 依赖的.simd设为false可以得到一个纯静态构建甚至不需要 libc但存在显著的性能损失如果你的宿主程序本来就需要 libc应保持 simd 启用。运行方式与原文档一致在示例目录下执行zig build run头文件 API16 位打包布局所有 API 定义在 include/ghostty/vt/modes.h 中。文件头部的注释给出了最核心的设计一个 mode 是终端模式标识符的紧凑 16 位表示同时编码了数字模式值最多 15 位以及该模式是 ANSI 模式还是 DEC private 模式?前缀。打包布局从最低有效位开始位段含义Bits 0–14模式数值u15取值 0–32767Bit 15ANSI 标志0 DEC private 模式1 ANSI 模式类型定义为typedef uint16_t GhosttyMode;配套三个static inline函数构造与检查均只需一次位运算对应 modes.h 中 L118–L144函数作用实现ghostty_mode_new(uint16_t value, bool ansi)由模式数值与 ANSI 标志构造打包模式(value 0x7FFF) \| (ansi 15)ghostty_mode_value(GhosttyMode mode)提取模式数值0–32767mode 0x7FFFghostty_mode_ansi(GhosttyMode mode)判断是否为 ANSI 模式(mode 15) ! 0文档还特别提醒应使用这些内联辅助函数来构造和检查模式而不要直接手工操作位。常用模式常量速查头文件以宏的形式提供了 ANSI 与 DEC private 两组常用模式modes.h 中 L45–L98每个宏都是ghostty_mode_new的常量调用。摘录常用项ANSI 模式宏模式号说明GHOSTTY_MODE_KAM2Keyboard action禁用键盘GHOSTTY_MODE_INSERT4Insert 插入模式GHOSTTY_MODE_SRM12Send/receive modeGHOSTTY_MODE_LINEFEED20Linefeed/new line modeDEC private 模式节选宏模式号说明GHOSTTY_MODE_DECCKM1光标键模式GHOSTTY_MODE_REVERSE_COLORS5反色显示GHOSTTY_MODE_ORIGIN6原点模式GHOSTTY_MODE_WRAPAROUND7自动回绕GHOSTTY_MODE_CURSOR_BLINKING12光标闪烁GHOSTTY_MODE_CURSOR_VISIBLE25光标可见DECTCEMGHOSTTY_MODE_KEYPAD_KEYS66应用模式小键盘GHOSTTY_MODE_BACKARROW_KEY_MODE67Backarrow 键模式DECBKMGHOSTTY_MODE_NORMAL_MOUSE1000普通鼠标追踪GHOSTTY_MODE_SGR_MOUSE1006SGR 格式鼠标事件GHOSTTY_MODE_ALT_SCROLL1007备选滚动模式GHOSTTY_MODE_ALT_SCREEN1047备选屏幕GHOSTTY_MODE_SAVE_CURSOR1048保存光标DECSCGHOSTTY_MODE_ALT_SCREEN_SAVE1049备选屏幕 保存光标 清屏GHOSTTY_MODE_BRACKETED_PASTE2004括号粘贴GHOSTTY_MODE_SYNC_OUTPUT2026同步输出GHOSTTY_MODE_PASTE_EVENTS5522Kitty 剪贴板协议粘贴事件示例源码逐段解析完整示例见 example/c-vt-modes/src/main.c只包含#include stdio.h和#include ghostty/vt.h两个头文件。1. 打包与解包modes_example对应源码 main.c 中 L4–L20void modes_example() { // Create a mode for DEC mode 25 (cursor visible) GhosttyMode tag ghostty_mode_new(25, false); printf(value%u ansi%d packed0x%04x\n, ghostty_mode_value(tag), ghostty_mode_ansi(tag), tag); // Create a mode for ANSI mode 4 (insert mode) GhosttyMode ansi_tag ghostty_mode_new(4, true); printf(value%u ansi%d packed0x%04x\n, ghostty_mode_value(ansi_tag), ghostty_mode_ansi(ansi_tag), ansi_tag); }按打包布局推演两个例子DEC mode 25value 25ansi 0打包结果 25 | (0 15)0x0019ANSI mode 4value 4ansi 1打包结果 4 | (1 15)0x8004。可以看到同一个数值如 mode 4在 ANSI 与 DEC 两套编号空间里完全靠第 15 位区分这正是“模式号 前缀”二元组被压缩进 16 位的意义可作为哈希键、数组下标或 C 库跨边界传递的紧凑标识。2. 编码 DECRPM 响应decrpm_example对应源码 main.c 中 L22–L39void decrpm_example() { char buf[32]; size_t written 0; // Encode a report that DEC mode 25 (cursor visible) is set GhosttyResult result ghostty_mode_report_encode( GHOSTTY_MODE_CURSOR_VISIBLE, GHOSTTY_MODE_REPORT_SET, buf, sizeof(buf), written); if (result GHOSTTY_SUCCESS) { printf(Encoded %zu bytes: , written); fwrite(buf, 1, written, stdout); printf(\n); // prints: ESC[?25;1$y } }ghostty_mode_report_encode的声明见 modes.h 中 L187–L192GHOSTTY_API GhosttyResult ghostty_mode_report_encode( GhosttyMode mode, GhosttyModeReportState state, char* buf, size_t buf_len, size_t* out_written);参数与语义mode要报告的模式打包的GhosttyModestate报告状态见下表buf/buf_len输出缓冲区可以为 NULL用于探测所需长度out_written成功时写入实际字节数返回GHOSTTY_OUT_OF_SPACE时写入所需的缓冲区大小调用方可据此扩容后重试。生成的序列格式DEC private 与 ANSI 的区别仅在于有无?前缀模式类型序列格式DEC private 模式CSI ? Ps1 ; Ps2 $ yANSI 模式CSI Ps1 ; Ps2 $ y报告状态枚举GhosttyModeReportStatemodes.h 中 L152–L164对应 DECRPM 响应中的Ps2参数枚举值数值含义GHOSTTY_MODE_REPORT_NOT_RECOGNIZED0模式不被识别GHOSTTY_MODE_REPORT_SET1模式已设置启用GHOSTTY_MODE_REPORT_RESET2模式已复位禁用GHOSTTY_MODE_REPORT_PERMANENTLY_SET3模式永久设置GHOSTTY_MODE_REPORT_PERMANENTLY_RESET4模式永久复位因此示例编码 DEC mode 25 的 set 状态输出即 8 字节的ESC[?25;1$y。底层实现与测试佐证C 层的导出函数最终落到 src/terminal/c/modes.zig 的report_encodeL18–L43从源码实现可以看出三个细节类型转换GhosttyMode被bitCast回内部的modes.ModeTag报告状态则经std.enums.fromInt转为内部modes.Report.State状态值非法时直接返回.invalid_value不会写入任何数据缓冲区不足的两段式协议先用定长 writerstd.Io.Writer.fixed写入若发生WriteFailed就用Discardingwriter 重新编码一遍只统计字节数再把该数写入out_written并返回.out_of_space——这保证了“探测长度”路径buf NULL与“缓冲区不足”路径返回一致的长度与头文件契约一致GHOSTTY_SUCCESS/GHOSTTY_OUT_OF_SPACE/ 无效值三类结果与 modes.h 的 Doxygen 注释一一对应。同文件内的单元测试modes.zig 中 L45–L104覆盖了这些行为可作为期望输出参考测试输入断言结果encode DEC mode setDEC 模式 1state1输出\x1B[?1;1$yencode DEC mode resetDEC 模式 1state2输出\x1B[?1;2$yencode ANSI modeANSI 模式 4state1输出\x1B[4;1$y无?前缀encode not recognizedDEC 模式 9999state0输出\x1B[?9999;0$yencode with insufficient buffer1 字节缓冲返回.out_of_space且written 1encode with invalid statestate99返回.invalid_valueencode with null bufferbuf NULL返回.out_of_space且written 0小结c-vt-modes 示例虽然只有百余行 C 代码但覆盖了嵌入ghostty-vt时处理终端模式的完整闭环用 modes.h 的 16 位打包布局在 ANSI/DEC 两套模式编号空间之间无歧义地传递标识符用ghostty_mode_report_encode以“缓冲不足即可探测长度”的两段式协议输出 DECRPM 序列并用 build.zig build.zig.zon 的最小配置完成 C 源码与ghostty-vt库产物的链接。由于 Ghostty 输出的是标准 C 库这套 API 同样适用于任何 C 工具链的嵌入场景行为细节则以 src/terminal/c/modes.zig 的实现与测试为准。【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考