RGFW 简介：轻量级单头窗口框架和 GLFW 替代方案

简介

RGFW 是一个跨平台单头框架，它抽象了窗口的创建和管理。 RGFW 使用简单，让您可以专注于游戏或应用程序编程，而不是处理复杂的低级窗口 API、具有大量开销的库或支持特定于平台的 API。 RGFW 会为您处理低级 API，而不会妨碍您。目前支持 X11 (Linux)、Windows (XP +)、Emscripten (HTML5) 和 MacOS。
创建窗口时，RGFW 会初始化您选择的图形上下文。这些选项包括 OpenGL（包括变体）、DirectX、直接软件渲染或无图形 API。尽管建议您自己创建 Vulkan 上下文，但还有一个用于 Vulkan 支持的单独标头。

设计

RGFW 的设计也很灵活。例如，您可以使用事件循环系统或事件回调系统。 （更多信息请参见 RGFW 存储库中的 Examples/events/main.c 和 Examples/callbacks/main.c）。

while (RGFW_window_checkEvent(win)) {
  switch (win->event.type) {
     case RGFW_quit:
       break;  
     case RGFW_keyPressed:
       break;
     case RGFW_mousePosChanged:
        break;
     ...
  }
}
void mouseposfunc(RGFW_window* win, RGFW_point point) {

} 
void keyfunc(RGFW_window* win, u32 keycode, char keyName[16], u8 lockState, u8 pressed) {

}

void windowquitfunc(RGFW_window* win) {

}

RGFW_setMousePosCallback(mouseposfunc);
RGFW_setKeyCallback(keyfunc);
RGFW_setWindowQuitCallback(windowquitfunc);

RGFW vs GLFW

RGFW 被设计为 GLFW 的替代品。这是因为 GLFW 的代码库并不轻量级，缺乏一定的灵活性。
有一个 GitHub 存储库，它获取 GLFW 的所有源代码并将其放入一个大型单头库中。此 GLFW.h 文件大小为 10.7 MB，无法在 GitHub 上查看。 RGFW 可以在 GitHub 上查看，因为它有 244 KB，而且 RGFW 二进制文件的大小通常也约为 GLFW 二进制文件大小的三分之一。 RGFW 也往往比 GLFW 使用更少的 RAM。
如果 RGFW 比 GLFW 轻得多，是否意味着 RGFW 缺乏功能？不，RGFW 具有与 GLFW 几乎相同的功能。如果您有兴趣了解差异，RGFW 存储库中包含一个表格，用于比较 RGFW 和 GLFW。

使用/编译 RGFW

要使用 RGFW，您需要将此行添加到您的源文件之一。
#定义 RGFW_IMPLMENTATION
这允许包含 RGFW 源定义。 
您还可以像任何其他库一样编译 RGFW。

cc -x c -c RGFW.h -D RGFW_IMPLEMENTATION -fPIC -D 

RGFW_EXPORT
(Linux): 
cc -shared RGFW.o -lX11 -lXrandr -lm -lGL

(window mingw): 
cc -shared RGFW.o -lgdi32 -lopengl32 -lwinmm -lm

(macOS)
cc -shared RGFW.o -framework Foundation -framework AppKit -framework OpenGL -framework CoreVideo -lm 

RGFW 示例

要创建窗口并初始化 RGFW，如果它是第一个窗口，请使用 RGFW_createWindow(const char* name, RGFW_rect, u16 args)
例如，在屏幕中央创建一个无法调整大小的窗口

RGFW_window* win = RGFW_createWindow("Window", RGFW_RECT(0, 0, 200, 200) RGFW_CENTER | RGFW_NO_RESIZE);

... // do software stuff

RGFW_window_close(win); // close window now that we're done

完成渲染后，需要交换窗口缓冲区。
RGFW_window_swapBuffers(RGFW_window* win);
如果您使用不受支持的 API，则需要自己处理该函数。
现在这是一个完整的 RGFW 示例：

#define RGFW_IMPLEMENTATION
#include "RGFW.h"

u8 icon[4 * 3 * 3] = {0xFF, 0x00, 0x00, 0xFF,    0xFF, 0x00, 0x00, 0xFF,     0xFF, 0x00, 0x00, 0xFF,   0xFF, 0x00, 0x00, 0x00, 0xFF, 0xFF, 0x00, 0xFF, 0xFF, 0xFF, 0x00, 0xFF,     0xFF, 0x00, 0x00, 0xFF, 0xFF, 0x00, 0x00, 0xFF, 0xFF, 0x00, 0x00, 0xFF};

void keyfunc(RGFW_window* win, u32 keycode, char keyName[16], u8 lockState, u8 pressed) {
    printf("this is probably early\n");
}

int main() {
    RGFW_window* win = RGFW_createWindow("name", RGFW_RECT(500, 500, 500, 500), (u64)RGFW_CENTER);

    RGFW_window_setIcon(win, icon, RGFW_AREA(3, 3), 4);

    RGFW_setKeyCallback(keyfunc); // you can use callbacks like this if you want 

    i32 running = 1;

    while (running) {
        while (RGFW_window_checkEvent(win)) { // or RGFW_window_checkEvents(); if you only want callbacks
            if (win->event.type == RGFW_quit || RGFW_isPressed(win, RGFW_Escape)) {
                running = 0;
                break;
            }

            if (win->event.type == RGFW_keyPressed) // this is the 'normal' way of handling an event
                printf("This is probably late\n");
        }

        glClearColor(0xFF, 0XFF, 0xFF, 0xFF);
        glClear(GL_COLOR_BUFFER_BIT);

        RGFW_window_swapBuffers(win);
    }

    RGFW_window_close(win);
}

最后的笔记

RGFW 示例和 PureDoom-RGFW 的屏幕截图更多有关 RGFW 的示例代码和信息可以在存储库中找到。这些示例还可以在 RGFW 示例站点上使用 HTML5 运行。如果您对 RGFW 感兴趣，请随时查看 RGFW 存储库，为其加注星标，或者向我询问有关 RGFW 的任何问题。我也愿意接受您可能提出的任何批评、建议或功能请求。

虽然 RGFW 比 GLFW 轻得多，但这并不意味着您应该使用它而不是 GLFW。最终，选择取决于您。 RGFW 更轻量级，但它也较新，并且社区很小。因此支持较少，并且尚未在生产就绪项目中进行测试。

如果您发现 RGFW 有趣，请查看存储库。支持 RGFW 的一种方法是为其加注星标。

https://github.com/ColleagueRiley/RGFW

以上是RGFW 简介：轻量级单头窗口框架和 GLFW 替代方案的详细内容。更多信息请关注PHP中文网其他相关文章！