OpenGL-Erweiterungen in PHP FFI über GLFW

Dynamisches OpenGL-Laden über GLFW in PHP FFI

Beim PHP-FFI-Ansatz für OpenGL führt das manuelle Kopieren von Konstanten und Typdefinitionen aus GLFW3-Headern zu übermäßigem Boilerplate-Code. Wir wandeln #define-Anweisungen in PHP-Konstanten um und fügen API-Funktionen unverändert in den Ressourcenabschnitt ein.

Beispieltransformation:

// glfw3.h
#define GLFW_VERSION_MAJOR 3

// glfw3.php
const GLFW_VERSION_MAJOR = 3;

// glfw3.h
GLFWAPI void glfwMakeContextCurrent(GLFWwindow* window);

// glfw3.php (in __halt_compiler())
void glfwMakeContextCurrent(GLFWwindow* window);

FFI-Funktionen verhalten sich gleichzeitig als Proxy-Objektmethoden und Zeiger:

$glfwMakeContextCurrent = $glfw->glfwMakeContextCurrent;
$glfwMakeContextCurrent($window);

Prozedurale Stubs für Autovervollständigung

Erstellen Sie PHP-Wrapper-Funktionen mit static-Zeiger-Caching für Typisierung und IDE-Unterstützung:

const GLFW_INSTANCE = FFI::cdef(...);

function glfwMakeContextCurrent(mixed ...$args): void {
    static $function = GLFW_INSTANCE->glfwMakeContextCurrent;
    $function(...$args);
}

Dieser Ansatz minimiert FFI-Proxy-Methodenaufrufe, indem sie durch Closures ersetzt werden. Die Leistung bleibt erhalten, da Funktionsadressen statisch sind.

Alternativen (nicht empfohlen):

• Übergeben von $glfw als erstes Argument.
• Verwenden von global $glfw.

Mit der GLFW_INSTANCE-Konstante vereinfacht sich der Hauptcode:

require 'src/glfw3.php';

if (!glfwInit()) exit(-1);
glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);
glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 3);
$window = glfwCreateWindow(640, 480, 'Hallo Welt', null, null);

Dynamisches OpenGL-Laden ohne opengl32.dll

OpenGL-Funktionen werden dynamisch über plattformabhängige GetProcAddress-Funktionen geladen:

• Windows: wglGetProcAddress
• Linux: glXGetProcAddressARB
• Android: eglGetProcAddress

GLFW vereinheitlicht dies in der plattformübergreifenden Funktion glfwGetProcAddress:

function glClear(mixed ...$args): void {
    static $function = GLFW_INSTANCE->cast(
        'PFNGLCLEARPROC',
        GLFW_INSTANCE->glfwGetProcAddress('glClear')
    );
    $function(...$args);
}

Typen wie PFNGLCLEARPROC stammen aus glcorearb.h:

typedef void (*PFNGLCLEARPROC)(GLbitfield mask);

Die Unterstützung für Erweiterungen (NV, AMD → ARB) wird dynamisch überprüft: Die Hardware bestimmt verfügbare Funktionen, und Treiber emulieren fehlende.

Generierung von Bridges aus Quellcode

Automatisieren Sie die Erstellung von glfw3.php (20k+ Zeilen):

• ffi/preprocessor: Wandelt C-Header in PHP-Format um, extrahiert Defines.
• ffi/ide-helper-generator: Erzeugt Stubs mit Argumenttypen.

GLFW 3.3 wurde für Kompatibilität mit Ubuntu 24.04 gewählt. OpenGL-Konstanten und -Funktionen werden in einer einzigen Datei integriert, und opengl.php wird entfernt.

Vorteile:

• Volle Kompatibilität mit ext-glfw.
• Plattformübergreifend ohne manuelle Anpassungen.
• Autovervollständigung und Typisierung ohne Kompilierung.

Wichtige Punkte

• GLFW_INSTANCE als globale Konstante bietet schnellen FFI-Zugriff ohne Globals.
• *PFNGLPROC**-Typen aus glcorearb.h vereinfachen das Casting ohne manuelle Signaturspezifikation.
• glfwGetProcAddress ersetzt den Plattform-Zoo (WGL/GLX/EGL).
• Generierung aus Quellcode garantiert die Relevanz von 20k+ Zeilen.
• Leistung: Statischer Cache minimiert FFI-Methoden-Overhead.

Der Code ist bereit für das Zeichnen von Dreiecken mit Puffern und Shadern im nächsten Teil.

— Editorial Team