本项目已迁移至 SDL3

Fgui --- Fair GUI Library for SDL3

这是一个基于 SDL3 的 GUI 库,用于快速开发基于 SDL3 的游戏或应用。

优点

缺点

支持的控件

可选编译控件

快速开始

#define NOMINMAX
#include "Fgui\Fgui.hpp"
int main(int,char**){
 //初始化SDL
 SDL_Init(SDL_INIT_VIDEO | SDL_INIT_EVENTS);
 TTF_Init();
 SDL_Window* window = SDL_CreateWindow("Minimal Example",1000,800,0);
 SDL_Rect top_relative_rect = {0,0,1000,800};
 SDL_Renderer* renderer = SDL_CreateRenderer(window,NULL);
 SDL_SetRenderDrawBlendMode(renderer,SDL_BLENDMODE_BLEND);
 Fgui_SetWindow(window);
 // 持久帧缓冲纹理:脏区重绘在离屏纹理上局部进行,再整体拷贝到 backbuffer 呈现,
 // 避免 SDL3 双缓冲交换机制导致脏区重绘时旧画面丢失/闪烁。
 SDL_Texture* frame_buf = SDL_CreateTexture(renderer,SDL_PIXELFORMAT_RGBA8888,SDL_TEXTUREACCESS_TARGET,1000,800);
 //准备GUI
 FontEx font({"font.ttf"});
 //创建根容器
 std::shared_ptr<ControlBox> cb = std::make_shared<ControlBox>(SDL_Rect{0,0,1000,800});
 //创建一个按钮
 auto button = cb->PushbackControl("hello", std::make_shared<PushButton>("Hello Fgui!",&font,128,SDL_Rect{0,0,0,0}));
 //居中显示
 button->default_rect.x = 500 - button->default_rect.w / 2;
 button->default_rect.y = 400 - button->default_rect.h / 2;
 //设定点击回调
 button->actions.OnClick = [](PushButton *){printf("Hello Fgui!\n");};
 //SDL事件循环必须事项
 SDL_Event eve;
 Timer fps_lim(60);
 bool running = true;
 //SDL事件循环
 while(running){
 //处理SDL事件
 while(SDL_PollEvent(&eve)){
 if(eve.type == SDL_EVENT_QUIT) running = false;
 if(SDL_GetWindowID(window) == eve.window.windowID) cb->MaintainEvent(&eve,{0,0,1000,800});
 }
 //调用Tick回调
 cb->MaintainTimer({0,0,1000,800});
 //读取脏区域
 SDL_Rect dirty_rect = cb->GetInvaildRect(top_relative_rect);
 //判断是否有脏区域
 if(dirty_rect.w != 0 && dirty_rect.h != 0){
 //在持久帧缓冲纹理上局部重绘脏区
 SDL_FRect fr_dirty = toFRect(dirty_rect);
 SDL_SetRenderTarget(renderer, frame_buf);
 SDL_SetRenderDrawColor(renderer,
 cb->GetColorKit().BackgroundColorDarker.r,
 cb->GetColorKit().BackgroundColorDarker.g,
 cb->GetColorKit().BackgroundColorDarker.b, 255);
 SDL_RenderFillRect(renderer, &fr_dirty);
 cb->MaintainRender(renderer, top_relative_rect);
 SDL_SetRenderTarget(renderer, NULL);
 //整体拷贝持久缓冲到 backbuffer 并呈现
 SDL_RenderTexture(renderer, frame_buf, NULL, NULL);
 SDL_RenderPresent(renderer);
 }
 fps_lim.Delay();
 }
 //释放SDL资源
 SDL_DestroyTexture(frame_buf);
 SDL_DestroyRenderer(renderer);
 SDL_DestroyWindow(window);
 TTF_Quit();
 SDL_Quit();
 return 0;
}

构建

# 仅测试程序 main.exe(Debug / Release)
cmake --preset debug
cmake --build build/debug --target fast_gui2
# 测试程序 + 示例程序
cmake --preset debug-examples
cmake --build build/debug-examples --target examples

文档(Wiki)

未来计划

Contributor

我(GL)

D指导(DeepSeek,后来加入的,他修复了我2年来写的屎山代码,他比我更懂写GUI,我是完全没经验纯摸索的)

后记