Skip to content

Classe C++ : Window

Index · English

Description

Fenêtre native x64 à création asynchrone, non copiable.

Nom complet : gaspardos::Window.

En-tête : bindings/cpp/gaspardos.hpp. C++98.

Dans quel cas l’utiliser

Créer une fenêtre, consommer READY puis dessiner.

Exemple de programme simple

#include "gaspardos.hpp"
#include <cstdio>
#include <cstring>

int main()
{
    gaspardos::Window  window;
    GO64_WindowOptions options = {};
    options.width              = 1000;
    options.height             = 700;
    std::strcpy(options.title, "Example");
    if (window.create(options) < 0)
        return 1;
    for (unsigned i = 0; i < 10000 && !window.ready(); ++i)
    {
        GO64_Event event  = {};
        int64_t    result = window.event(event);
        if (result < 0 && result != -11)
            return 1;
        if (result == 0 && (event.type == GO64_ERROR || event.type == 15))
            return 1;
        GO64_yield();
    }
    if (!window.ready())
        return 1;
    GO64_Drawing drawing = {};
    drawing.width        = 200;
    drawing.height       = 100;
    if (window.fill(drawing) < 0)
        return 1;
    return window.close() == 0 ? 0 : 1;
}

Compilation depuis Windows

Enregistrer le programme ci-dessus dans build/api-examples/Window.cpp, depuis la racine du dépôt. Créer le dossier si nécessaire.

PowerShell — depuis la racine du dépôt :

New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-gcc.exe -std=gnu1x -O2 -mno-red-zone -c bindings/native/gaspardos_x64_syscall.c -o build/api-examples/syscall.o
if ($LASTEXITCODE -ne 0) { throw "C compilation failed" }
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/Window.cpp build/api-examples/syscall.o -o build/api-examples/Window-x64.elf
if ($LASTEXITCODE -ne 0) { throw "C++ compilation/link failed" }

Le binaire ELF s’exécute sous GaspardOS, pas sous Windows. Le pilote fournit CRT et bibliothèques. Préparer les volumes/services requis ; les exemples bornent leurs attentes et peuvent sortir sur saturation au lieu de réessayer. Une compilation réussie ne valide pas l’exécution noyau.

Les fichiers nécessaires à cet exemple sont disponibles dans la section Source files (en anglais).

Méthodes de la classe

Window()

Handle -1 et ready false.

~Window()

Tente la destruction une fois.

int64_t handle() const

Handle brut.

int64_t close()

Détruit ; remet ready à false sur succès ; garde le handle sur erreur.

bool ready() const

Vrai après consommation de GO64_READY, faux après GO64_ERROR.

int64_t create(const GO64_WindowOptions& options)

Copie les options vers le syscall ; handle ou erreur ; -16 si déjà créée.

int64_t event(GO64_Event& e, bool wait = false)

Polling par défaut ; wait=true attend selon le noyau ; -9 si fermée. Met à jour ready.

int64_t fill(const GO64_Drawing& d)

Rectangle GO64_Drawing ; -9 si fermée, -11 avant READY.

int64_t text(const GO64_Drawing& d)

Texte terminé par zéro (128 octets dans Drawing) ; mêmes conditions que fill.

int64_t focus()

Demande le focus ; -9 si fermée.

int64_t blit(const GO64_Blit& tile)

Copie une tuile RGBX8888 (256 × 256 maximum) dans la file UI via le syscall 146. -9 si fermée, -11 avant READY ou en cas de saturation ; 0 = copie acceptée. Pour une image complète, utiliser FramebufferPresenter.

Contrat natif

ABI LP64, wchar_t 32 bits, aucun packing. Les résultats négatifs natifs ne sont pas errno. Traiter -11 avec yield et une limite applicative. Les objets référencés doivent survivre à leurs utilisateurs ; ne pas copier les propriétaires de handles. File utilise stdio/errno et invalide son flux sur close, même sur erreur.