Size Preset Profiles

本页把当前提供的几档 size 模板整理成可直接复用的起始配置，目标不是给出唯一答案，而是帮助用户快速选一个合理起点。

建议和以下文档一起看：

  • size_selection_guide.md

  • canvas_feature_size_report.md

  • widget_feature_size_report.md

  • hq_size_report.md

  • size_preset_validation.md

对应模板文件位于：

  • example/HelloSizeAnalysis/ConfigProfiles/tiny_rom/app_egui_config.h

  • example/HelloSizeAnalysis/ConfigProfiles/basic_ui/app_egui_config.h

  • example/HelloSizeAnalysis/ConfigProfiles/dashboard/app_egui_config.h

  • example/HelloSizeAnalysis/ConfigProfiles/full_feature/app_egui_config.h

1. 使用原则

这些模板只负责“全局配置起点”，不负责替你决定业务代码里是否真的引用某个 widget 或绘制路径。

因此需要区分两层：

  • 第一层：EGUI_CONFIG_* 这类全局开关，由模板直接给出。

  • 第二层：具体 widget、canvas path、HQ path 是否被引用，由应用代码自己决定。

也就是说：

  • 有全局总开关的能力，优先用模板做裁剪。

  • 没有全局总开关的能力，优先通过“不引用对应 API 或 widget”让编译器和链接器回收代码。

2. 四档模板总览

Profile

目标

核心特点

tiny_rom

极限 ROM 裁剪

关闭 mask、codec、增强绘制、阴影、图层、触摸、默认 HQ 和额外图片格式

basic_ui

常规 UI 页面

保留触摸、滚动条、快速文字绘制，关闭 mask、codec、图层和默认 HQ

dashboard

看板 / 仪表 / 展示页

打开 QOI/RLE、增强绘制和阴影，保留触摸，仍然关闭 mask 和默认 HQ

full_feature

高配设备 / 演示工程

打开 mask、双 codec、图层、多点触控、焦点、额外图片格式，默认 HQ 仍保持关闭

3. tiny_rom

适合场景：

  • 小屏

  • 小 ROM

  • 以状态显示和基础交互为主

当前模板直接关闭了这些开关：

  • EGUI_CONFIG_FUNCTION_SUPPORT_MASK

  • EGUI_CONFIG_FUNCTION_IMAGE_CODEC_QOI

  • EGUI_CONFIG_FUNCTION_IMAGE_CODEC_RLE

  • EGUI_CONFIG_FUNCTION_WIDGET_ENHANCED_DRAW

  • EGUI_CONFIG_FUNCTION_SUPPORT_SHADOW

  • EGUI_CONFIG_FUNCTION_SUPPORT_LAYER

  • EGUI_CONFIG_FUNCTION_SUPPORT_SCROLLBAR

  • EGUI_CONFIG_FUNCTION_SUPPORT_TOUCH

  • EGUI_CONFIG_FUNCTION_SUPPORT_FOCUS

  • EGUI_CONFIG_CIRCLE_DEFAULT_ALGO_HQ

  • EGUI_CONFIG_FUNCTION_FONT_STD_FAST_DRAW

  • EGUI_CONFIG_FUNCTION_IMAGE_FORMAT_RGB565_8

  • EGUI_CONFIG_FUNCTION_IMAGE_FORMAT_ALPHA_8

仍然保留：

  • EGUI_CONFIG_FUNCTION_SUPPORT_KEY

建议：

  • 从这档开始时，不要默认引入重控件。

  • 只有业务明确需要时，再向上加功能。

4. basic_ui

适合场景：

  • 设置页

  • 表单页

  • 常规触摸交互

当前模板的特点：

  • 打开 SCROLLBAR、TOUCH、EGUI_CONFIG_FUNCTION_FONT_STD_FAST_DRAW

  • 关闭 MASK、QOI、RLE、LAYER、FOCUS、默认 HQ

  • 仍然保持增强绘制和阴影关闭

建议：

  • 这档适合作为绝大多数普通 UI 应用的起点。

  • 如果项目后续没有压缩图片资源，可以继续保持 codec 关闭。

5. dashboard

适合场景：

  • 看板

  • 仪表

  • 展示型页面

当前模板的特点：

  • 打开 QOI、RLE

  • 打开 WIDGET_ENHANCED_DRAW

  • 打开 SHADOW

  • 保留 TOUCH 和 SCROLLBAR

  • 仍然关闭 MASK、LAYER、FOCUS、默认 HQ

建议：

  • 这档适合已经接受更高视觉成本的项目。

  • 如果实际项目并不使用压缩图片资源，可以回退关闭 QOI/RLE。

6. full_feature

适合场景：

  • 高配 MCU

  • 演示工程

  • 不以极限 ROM 为目标的项目

当前模板额外打开了：

  • EGUI_CONFIG_FUNCTION_SUPPORT_MASK

  • EGUI_CONFIG_FUNCTION_SUPPORT_LAYER

  • EGUI_CONFIG_FUNCTION_SUPPORT_MULTI_TOUCH

  • EGUI_CONFIG_FUNCTION_SUPPORT_KEY

  • EGUI_CONFIG_FUNCTION_SUPPORT_FOCUS

  • EGUI_CONFIG_FUNCTION_IMAGE_FORMAT_RGB565_8

  • EGUI_CONFIG_FUNCTION_IMAGE_FORMAT_ALPHA_8

同时保留：

  • QOI / RLE

  • WIDGET_ENHANCED_DRAW

  • SHADOW

  • TOUCH

  • SCROLLBAR

注意：

  • 即使是 full_feature，当前模板也没有把 EGUI_CONFIG_CIRCLE_DEFAULT_ALGO_HQ 改成 1。

  • HQ 仍建议按场景显式启用，而不是作为全局默认行为。

7. 这些模板已经不再依赖 USER_CFLAGS

当前 size 分析链路已经改为：

  • 把模板内容写入应用本地的 override 头文件

  • 再由应用自己的 app_egui_config.h 体系接管

因此：

  • 批量报告脚本不再依赖 USER_CFLAGS 做 profile 切换

  • 模板的推荐用法是“复制到应用目录”或“作为应用本地 override 的来源”

8. 推荐使用顺序

建议这样使用这些模板：

  1. 先从最接近目标的 profile 起步。

  2. 先确认全局 EGUI_CONFIG_* 是否合理。

  3. 再根据业务代码决定是否真正引入某些 widget、canvas path 和 _hq 路径。

  4. 最后用 size_report.md 和 size_preset_validation.md 做验证。

如果你现在没有明确判断，默认建议：

  • 普通 UI 项目从 basic_ui 起步

  • 小 ROM 项目从 tiny_rom 起步

  • 仪表 / 看板项目从 dashboard 起步

  • 演示或高配设备项目从 full_feature 起步