SuperAPI AI 工具集

ui-theming

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:这是 Godot 项目中 UI 主题(UI Theming)的专家级做法蓝图,用 Theme 资源、StyleBox、字体管理和覆盖机制,为界面建立统一、可维护的视觉识别。

主要能力与脚本:提供 global_theme_manager.gd,用于动态切换主题、管理主题变体和回退处理;提供 ui_scale_manager.gd,用于运行时切换主题并管理 DPI/分辨率缩放。

使用方式:在项目设置 Project Settings → GUI → Theme 中创建新的 Theme 资源,分配给根 Control 节点,子节点自动继承。StyleBox 模式:用 StyleBoxFlat 设置 bg_color 和各角圆角后,通过 add_theme_stylebox_override("normal", style) 应用到按钮。字体加载:用 load("res://fonts/my_font.ttf") 载入字体,再调用 add_theme_font_override("font", font) 和 add_theme_font_size_override("font_size", 24)。颜色定义在主题中,通过 theme.get_color("primary", "Button") 引用。均匀圆角可使用 corner_radius_all = 5(仅 StyleBoxFlat)。

限制与禁止做法:不要在 _ready() 中为大量节点创建 StyleBox,避免重复对象;不要忘记主题继承,在根 Control 设置主题而非逐节点覆盖;不要在 StyleBox 中硬编码颜色;不要用 add_theme_override 处理全局样式;不要在渲染期间修改主题,主题应在初始化或用户操作时加载。参考 Godot 官方 GUI Theming 文档。

暂未提供:版本要求、安装命令、具体 API 名称之外的信息以及效果或性能数据。