raylib 即时模式GUIraygui控件上手指南【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylibraygui 是 raylib 仓库自带的即时模式 GUIImmediate Mode GUI实现位于 examples/core/raygui.h。它把控件绘制、输入判定、状态回写合并成单个函数调用适合做游戏内调试面板、参数调台和设置菜单。面向刚接触 raylib 的 C 语言开发者无需事件循环与控件树几行代码即可上手。一、raygui 在 raylib 中的角色raylib GUI 是什么raylib 本体是图形与输入库负责窗口、绘制、事件raygui 是叠在它之上的一层控件库单头文件约 6400 行同时包含声明与实现。即时模式的含义是每帧都重新调用控件函数完成绘制raygui 不替你保存控件控件值滑块数值、勾选状态全部由你自己的变量持有函数通过指针参数直接回写。保留模式的界面库Qt、GTK 一类会维护控件树、布局与信号槽raygui 不存控件、不算布局代码即界面代价是布局要自己排。因此它适合游戏内 UI 开发中的轻量场景——调参面板、模式开关、快速原型不适合做大型编辑器或复杂表单。维度即时模式raygui保留模式Qt/GTK控件状态开发者自己持有库内部维护布局系统无坐标自己算有适合场景游戏内面板、调试工具桌面应用、复杂表单二、最小可运行示例raygui C语言 接入只需两行编译环境用 raylib 5.x把 examples/core/ 加入头文件搜索路径并链接 raylib 库。C 源码只需在已有代码里加两行#include raylib.h #define RAYGUI_IMPLEMENTATION // 只在一个 .c 文件里定义 #include raygui.h // 相对路径 examples/core/raygui.h int main(void) { InitWindow(800, 450, raygui panel); SetWindowMinSize(480, 320); float barWidth 200.0f; // 控件直接读写这个变量 bool showRect true; GuiStyleDefault(); while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); // 拖动滑块时 raygui 回写 barWidth GuiSliderBar((Rectangle){20, 40, 220, 20}, Width, TextFormat(%.0f, barWidth), barWidth, 50, 500); GuiCheckBox((Rectangle){20, 80, 20, 20}, Show rect, showRect); if (showRect) DrawRectangle(60, 140, barWidth, 120, SKYBLUE); EndDrawing(); } CloseWindow(); return 0; }这段代码在做什么初始化是 raylib 的标准写法#define RAYGUI_IMPLEMENTATION与#include raygui.h让 raygui 的函数体在当前编译单元生成全项目只放一份。滑块每帧调用一次鼠标命中、拖动判定、数值回写都由 raygui 完成业务代码不写任何回调滑块右侧文字用TextFormat实时显示当前值。GuiCheckBox同理通过bool*回写勾选状态。最后两行把控件结果画到窗口上形成调参—即时反馈的闭环。官方示例 examples/shapes/shapes_rounded_rectangle_drawing.c 就是滑块改圆角的完整实现可对照阅读。三、按任务选控件raygui 控件怎么选raygui 的控件按任务选不按外观选调数值、切开关、选一项、调颜色四类任务覆盖了游戏内 UI 开发的大部分需求。️调连续数值GuiSliderBar((Rectangle){20, 200, 200, 20}, Volume, TextFormat(%d%%, (int)(volume*100)), volume, 0, 1);GuiSliderBar接收float*与最小、最大值适合音量、灵敏度、尺寸这类连续量。需要整数且范围离散时用GuiValueBox它支持键盘直接输入并做范围钳制。切开关GuiCheckBox((Rectangle){20, 240, 20, 20}, Show FPS, showFps);GuiCheckBox通过bool*回写适合显示网格、开启雾效、调试模式这类独立开关。在固定集合里选一项int selected 1; // editMode 传 true打开状态下点选false点击循环切换 GuiDropdownBox((Rectangle){250, 10, 120, 30}, Easy;Normal;Hard, selected, true);选项写成分号分隔的字符串不用维护数组适合难度、渲染模式等固定选项。调颜色GuiColorPicker((Rectangle){400, 100, 300, 300}, Team Color, teamColor);GuiColorPicker内置色条加 RGB 滑块返回的Color可直接传给任何 raylib 绘制函数。内容超出屏幕GuiScrollPanel(panelRect, Options, contentRect, scroll, view);选项多到一屏放不下时用GuiScrollPanel承载子控件examples/shapes/shapes_pie_chart.c 演示了滚动面板加多个滑块与复选框的组合四、组合示例游戏内调试面板怎么排组合的思路是一个区域一个函数用一个Rectangle定义面板容器先画底与标题GuiGroupBox或直接DrawRectangleDrawText。所有控件坐标从容器起点按固定偏移计算不各自硬编码绝对坐标。每行固定行高例如 40 像素行内左标签、右输入控件。一行控件的写法是固定的三段式DrawText(X Position, panelX 10, y, 10, LIGHTGRAY); GuiValueBox((Rectangle){panelX 120, y - 4, 100, 24}, NULL, camX, -100, 100, true); y rowHeight;把y用循环步进加控件就是加行重置按钮放最后一行点击时把面板绑定的几个变量整体赋回默认值。examples/core/core_3d_camera_free.c 里的相机控制区可以按这个思路对照阅读五、样式与换肤用 GuiSetStyle 改控件配色raygui 的样式是一张按控件 属性索引的全局表。GuiSetStyle改单个属性GuiLoadStyle读取.rgs样式文件整体覆盖。改按钮配色只需要两个属性按下、悬停等状态会沿用默认值GuiSetStyle(BUTTON, BASE_COLOR_NORMAL, COLOR(GREEN)); GuiSetStyle(BUTTON, TEXT_COLOR_NORMAL, COLOR(WHITE));所有可用的控件枚举与属性枚举定义在 examples/core/raygui.h 里的GuiControl与GuiStyleProp照表查即可。六、常见坑与排查现象链接后调用GuiButton报未定义引用。原因raygui.h 是头文件实现函数体只在定义了RAYGUI_IMPLEMENTATION的编译单元生成。处理包含 raygui.h 前加#define RAYGUI_IMPLEMENTATION且整个项目只放一份。现象滑块拖动无效或数值跳变。原因把临时变量地址传了进去或范围写反。处理传稳定的float变量地址确认minValue maxValue。现象控件只在第一次出现后就不动了。原因控件调用被放在初始化阶段没有留在帧循环里。处理即时模式下控件函数必须每帧调用移动进while循环。现象控件超出屏幕或互相重叠。原因raygui 没有布局系统坐标是绝对窗口坐标。处理以面板矩形为锚点统一计算子控件位置窗口尺寸变化时用窗口宽高动态计算锚点。现象中文或 emoji 显示成方块、问号。原因默认字体只覆盖 ASCII。处理加载覆盖目标字符集的字体文件再调用GuiSetFont应用。现象复选框、下拉框点击无反应。原因同一帧内另一个编辑型控件处于激活态raygui 用全局独占模式暂停其余控件的交互。处理检查文本框、数值框的编辑状态参数编辑结束后关闭编辑态。七、延伸资源头文件与实现examples/core/raygui.h示例集合含各*.c对应的运行截图examples/CMake 构建模板projects/CMake/示例清单examples/examples_list.txt【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/2 22:27:20 · 阅读 1.2k raylib 即时模式GUI（raygui）控件上手指南
raylib 即时模式GUIraygui控件上手指南【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylibraygui 是 raylib 仓库自带的即时模式 GUIImmediate Mode GUI实现位于 examples/core/raygui.h。它把控件绘制、输入判定、状态回写合并成单个函数调用适合做游戏内调试面板、参数调台和设置菜单。面向刚接触 raylib 的 C 语言开发者无需事件循环与控件树几行代码即可上手。一、raygui 在 raylib 中的角色raylib GUI 是什么raylib 本体是图形与输入库负责窗口、绘制、事件raygui 是叠在它之上的一层控件库单头文件约 6400 行同时包含声明与实现。即时模式的含义是每帧都重新调用控件函数完成绘制raygui 不替你保存控件控件值滑块数值、勾选状态全部由你自己的变量持有函数通过指针参数直接回写。保留模式的界面库Qt、GTK 一类会维护控件树、布局与信号槽raygui 不存控件、不算布局代码即界面代价是布局要自己排。因此它适合游戏内 UI 开发中的轻量场景——调参面板、模式开关、快速原型不适合做大型编辑器或复杂表单。维度即时模式raygui保留模式Qt/GTK控件状态开发者自己持有库内部维护布局系统无坐标自己算有适合场景游戏内面板、调试工具桌面应用、复杂表单二、最小可运行示例raygui C语言 接入只需两行编译环境用 raylib 5.x把 examples/core/ 加入头文件搜索路径并链接 raylib 库。C 源码只需在已有代码里加两行#include raylib.h #define RAYGUI_IMPLEMENTATION // 只在一个 .c 文件里定义 #include raygui.h // 相对路径 examples/core/raygui.h int main(void) { InitWindow(800, 450, raygui panel); SetWindowMinSize(480, 320); float barWidth 200.0f; // 控件直接读写这个变量 bool showRect true; GuiStyleDefault(); while (!WindowShouldClose()) { BeginDrawing(); ClearBackground(RAYWHITE); // 拖动滑块时 raygui 回写 barWidth GuiSliderBar((Rectangle){20, 40, 220, 20}, Width, TextFormat(%.0f, barWidth), barWidth, 50, 500); GuiCheckBox((Rectangle){20, 80, 20, 20}, Show rect, showRect); if (showRect) DrawRectangle(60, 140, barWidth, 120, SKYBLUE); EndDrawing(); } CloseWindow(); return 0; }这段代码在做什么初始化是 raylib 的标准写法#define RAYGUI_IMPLEMENTATION与#include raygui.h让 raygui 的函数体在当前编译单元生成全项目只放一份。滑块每帧调用一次鼠标命中、拖动判定、数值回写都由 raygui 完成业务代码不写任何回调滑块右侧文字用TextFormat实时显示当前值。GuiCheckBox同理通过bool*回写勾选状态。最后两行把控件结果画到窗口上形成调参—即时反馈的闭环。官方示例 examples/shapes/shapes_rounded_rectangle_drawing.c 就是滑块改圆角的完整实现可对照阅读。三、按任务选控件raygui 控件怎么选raygui 的控件按任务选不按外观选调数值、切开关、选一项、调颜色四类任务覆盖了游戏内 UI 开发的大部分需求。️调连续数值GuiSliderBar((Rectangle){20, 200, 200, 20}, Volume, TextFormat(%d%%, (int)(volume*100)), volume, 0, 1);GuiSliderBar接收float*与最小、最大值适合音量、灵敏度、尺寸这类连续量。需要整数且范围离散时用GuiValueBox它支持键盘直接输入并做范围钳制。切开关GuiCheckBox((Rectangle){20, 240, 20, 20}, Show FPS, showFps);GuiCheckBox通过bool*回写适合显示网格、开启雾效、调试模式这类独立开关。在固定集合里选一项int selected 1; // editMode 传 true打开状态下点选false点击循环切换 GuiDropdownBox((Rectangle){250, 10, 120, 30}, Easy;Normal;Hard, selected, true);选项写成分号分隔的字符串不用维护数组适合难度、渲染模式等固定选项。调颜色GuiColorPicker((Rectangle){400, 100, 300, 300}, Team Color, teamColor);GuiColorPicker内置色条加 RGB 滑块返回的Color可直接传给任何 raylib 绘制函数。内容超出屏幕GuiScrollPanel(panelRect, Options, contentRect, scroll, view);选项多到一屏放不下时用GuiScrollPanel承载子控件examples/shapes/shapes_pie_chart.c 演示了滚动面板加多个滑块与复选框的组合四、组合示例游戏内调试面板怎么排组合的思路是一个区域一个函数用一个Rectangle定义面板容器先画底与标题GuiGroupBox或直接DrawRectangleDrawText。所有控件坐标从容器起点按固定偏移计算不各自硬编码绝对坐标。每行固定行高例如 40 像素行内左标签、右输入控件。一行控件的写法是固定的三段式DrawText(X Position, panelX 10, y, 10, LIGHTGRAY); GuiValueBox((Rectangle){panelX 120, y - 4, 100, 24}, NULL, camX, -100, 100, true); y rowHeight;把y用循环步进加控件就是加行重置按钮放最后一行点击时把面板绑定的几个变量整体赋回默认值。examples/core/core_3d_camera_free.c 里的相机控制区可以按这个思路对照阅读五、样式与换肤用 GuiSetStyle 改控件配色raygui 的样式是一张按控件 属性索引的全局表。GuiSetStyle改单个属性GuiLoadStyle读取.rgs样式文件整体覆盖。改按钮配色只需要两个属性按下、悬停等状态会沿用默认值GuiSetStyle(BUTTON, BASE_COLOR_NORMAL, COLOR(GREEN)); GuiSetStyle(BUTTON, TEXT_COLOR_NORMAL, COLOR(WHITE));所有可用的控件枚举与属性枚举定义在 examples/core/raygui.h 里的GuiControl与GuiStyleProp照表查即可。六、常见坑与排查现象链接后调用GuiButton报未定义引用。原因raygui.h 是头文件实现函数体只在定义了RAYGUI_IMPLEMENTATION的编译单元生成。处理包含 raygui.h 前加#define RAYGUI_IMPLEMENTATION且整个项目只放一份。现象滑块拖动无效或数值跳变。原因把临时变量地址传了进去或范围写反。处理传稳定的float变量地址确认minValue maxValue。现象控件只在第一次出现后就不动了。原因控件调用被放在初始化阶段没有留在帧循环里。处理即时模式下控件函数必须每帧调用移动进while循环。现象控件超出屏幕或互相重叠。原因raygui 没有布局系统坐标是绝对窗口坐标。处理以面板矩形为锚点统一计算子控件位置窗口尺寸变化时用窗口宽高动态计算锚点。现象中文或 emoji 显示成方块、问号。原因默认字体只覆盖 ASCII。处理加载覆盖目标字符集的字体文件再调用GuiSetFont应用。现象复选框、下拉框点击无反应。原因同一帧内另一个编辑型控件处于激活态raygui 用全局独占模式暂停其余控件的交互。处理检查文本框、数值框的编辑状态参数编辑结束后关闭编辑态。七、延伸资源头文件与实现examples/core/raygui.h示例集合含各*.c对应的运行截图examples/CMake 构建模板projects/CMake/示例清单examples/examples_list.txt【免费下载链接】raylibA simple and easy-to-use library to enjoy videogames programming项目地址: https://gitcode.com/GitHub_Trending/ra/raylib创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考