Classe C++ : Window¶
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.