Wir stellen vor: RGFW: Ein leichtes Single-Header-Windowing-Framework und eine GLFW-Alternative

Einführung

RGFW ist ein plattformübergreifendes Single-Header-Framework, das das Erstellen und Verwalten von Fenstern abstrahiert. RGFW ist einfach zu verwenden, sodass Sie sich auf die Programmierung Ihres Spiels oder Ihrer Anwendung konzentrieren können, anstatt sich mit komplexen Low-Level-Windowing-APIs, Bibliotheken mit viel Overhead oder der Unterstützung plattformspezifischer APIs herumzuschlagen. RGFW verwaltet die Low-Level-APIs für Sie, ohne Ihnen in die Quere zu kommen. Es unterstützt derzeit X11 (Linux), Windows (XP +), Emscripten (HTML5) und MacOS.
Beim Erstellen eines Fensters initialisiert RGFW einen Grafikkontext Ihrer Wahl. Zu den Optionen gehören OpenGL (einschließlich Varianten), DirectX, direktes Software-Rendering oder keine Grafik-API. Es gibt auch einen separaten Header für die Vulkan-Unterstützung, es wird jedoch empfohlen, Ihren Vulkan-Kontext selbst zu erstellen.

Design

RGFW ist auch vom Design her flexibel. Sie können beispielsweise ein Ereignisschleifensystem oder ein Ereignisrückrufsystem verwenden. (Weitere Informationen finden Sie unter „examples/events/main.c“ und „examples/callbacks/main.c“ im RGFW-Repo).

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 gegen GLFW

RGFW ist als Alternative zu GLFW konzipiert. Dies liegt daran, dass die Codebasis von GLFW nicht leichtgewichtig ist und es ihr an Flexibilität mangelt.
Es gibt ein GitHub-Repository, das den gesamten Quellcode von GLFW in einer großen Single-Header-Bibliothek ablegt. Diese GLFW.h-Datei ist 10,7 Megabyte groß und kann nicht auf GitHub angezeigt werden. RGFW kann auf GitHub angezeigt werden, da es 244 Kilobyte groß ist und die RGFW-Binärdateien im Allgemeinen auch etwa ein Drittel der Größe der GLFW-Binärdateien haben. RGFW verbraucht tendenziell auch weniger RAM als GLFW.
Wenn RGFW deutlich leichter ist als GLFW, bedeutet das dann, dass es RGFW an Funktionen mangelt? Nein, RGFW hat fast die gleichen Funktionen wie GLFW. Wenn Sie an den Unterschieden interessiert sind, gibt es im RGFW-Repository eine Tabelle, die RGFW mit GLFW vergleicht.

Verwenden/Kompilieren von RGFW

Um RGFW verwenden zu können, müssen Sie diese Zeile zu einer Ihrer Quelldateien hinzufügen.
#define RGFW_IMPLEMENTATION
Dadurch können die RGFW-Quelldefinitionen einbezogen werden. 
Sie können RGFW auch wie jede andere Bibliothek kompilieren.

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-Beispiel

Um ein Fenster zu erstellen und RGFW zu initialisieren, verwenden Sie, wenn es das erste Fenster ist, RGFW_createWindow(const char* name, RGFW_rect, u16 args)
Zum Beispiel, um ein Fenster in der Mitte des Bildschirms zu erstellen, dessen Größe nicht geändert werden kann

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

Nachdem Sie mit dem Rendern fertig sind, müssen Sie den Fensterpuffer austauschen.
RGFW_window_swapBuffers(RGFW_window* win);
Wenn Sie eine nicht unterstützte API verwenden, müssen Sie die Funktion selbst verwalten.
Hier ist ein vollständiges RGFW-Beispiel:

#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);
}

Schlussbemerkungen

Ein Screenshot der RGFW-Beispiele und PureDoom-RGFWWeitere Beispielcodes und Informationen zu RGFW finden Sie im Repository. Die Beispiele können auch mit HTML5 auf der RGFW-Beispielseite ausgeführt werden. Wenn Sie an RGFW interessiert sind, schauen Sie sich gerne das RGFW-Repository an, markieren Sie es oder stellen Sie mir Ihre Fragen zu RGFW. Ich bin auch offen für jegliche Kritik, Ratschläge oder Funktionswünsche, die Sie haben.

Obwohl RGFW wesentlich leichter ist als GLFW, bedeutet das nicht, dass Sie es über GLFW verwenden sollten. Letztendlich liegt die Wahl bei Ihnen. RGFW ist leichter, aber auch neuer und hat eine kleine Community. Daher gibt es weniger Unterstützung und es wurde noch nicht in einem produktionsreifen Projekt getestet.

Wenn Sie RGFW interessant finden, schauen Sie sich bitte das Repository an. Eine Möglichkeit, RGFW zu unterstützen, besteht darin, es zu markieren.

https://github.com/ColleagueRiley/RGFW

Das obige ist der detaillierte Inhalt vonWir stellen vor: RGFW: Ein leichtes Single-Header-Windowing-Framework und eine GLFW-Alternative. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!