Extensions OpenGL en PHP FFI via GLFW

Chargement dynamique d'OpenGL via GLFW en PHP FFI

Dans l'approche PHP FFI pour OpenGL, la copie manuelle des constantes et typedefs depuis les en-têtes GLFW3 génère un code répétitif excessif. Nous convertissons les déclarations #define en constantes PHP et insérons les fonctions API dans la section ressource sans modification.

Exemple de transformation :

// glfw3.h
#define GLFW_VERSION_MAJOR 3

// glfw3.php
const GLFW_VERSION_MAJOR = 3;

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

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

Les fonctions FFI se comportent à la fois comme des méthodes d'objet proxy et des pointeurs simultanément :

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

Stubs procéduraux pour l'autocomplétion

Créez des fonctions wrapper PHP avec mise en cache statique des pointeurs pour le typage et le support IDE :

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

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

Cette approche minimise les appels de méthodes proxy FFI en les remplaçant par des fermetures. Les performances sont maintenues car les adresses des fonctions sont statiques.

Alternatives (non recommandées) :

• Passer $glfw comme premier argument.
• Utiliser global $glfw.

Avec la constante GLFW_INSTANCE, le code principal se simplifie :

require 'src/glfw3.php';

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

Chargement dynamique d'OpenGL sans opengl32.dll

Les fonctions OpenGL sont chargées dynamiquement via des fonctions GetProcAddress dépendantes de la plateforme :

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

GLFW unifie cela avec glfwGetProcAddress multiplateforme :

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

Les types comme PFNGLCLEARPROC sont extraits de glcorearb.h :

typedef void (*PFNGLCLEARPROC)(GLbitfield mask);

Le support des extensions (NV, AMD → ARB) est vérifié dynamiquement : le matériel détermine les fonctions disponibles, et les pilotes émulent celles manquantes.

Génération de ponts depuis le code source

Automatisez la création de glfw3.php (20k+ lignes) :

• ffi/preprocessor : Convertit les en-têtes C en format PHP, extrait les définitions.
• ffi/ide-helper-generator : Génère des stubs avec types d'arguments.

GLFW 3.3 a été choisi pour la compatibilité avec Ubuntu 24.04. Les constantes et fonctions OpenGL sont intégrées dans un seul fichier, et opengl.php est supprimé.

Avantages :

• Compatibilité totale avec ext-glfw.
• Multiplateforme sans ajustements manuels.
• Autocomplétion et typage sans compilation.

Points clés

• GLFW_INSTANCE comme constante globale fournit un accès FFI rapide sans variables globales.
• Les types *PFNGLPROC** de glcorearb.h simplifient le casting sans spécification manuelle de signature.
• glfwGetProcAddress remplace le zoo de plateformes (WGL/GLX/EGL).
• La génération depuis la source garantit la pertinence de 20k+ lignes.
• Performances : le cache statique minimise la surcharge des méthodes FFI.

Le code est prêt pour dessiner des triangles avec des tampons et des shaders dans la partie suivante.

— Editorial Team