Classe C++ : NativePainter¶
Description¶
Adaptateur Painter sur une Window.
Nom complet : gaspardos::gui::NativePainter.
En-tête : bindings/cpp/gui.hpp. C++98.
Dans quel cas l’utiliser¶
Dessiner les widgets dans une vraie fenêtre GaspardOS.
Exemple de programme simple¶
#include "gui.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;
gaspardos::gui::NativePainter painter(window);
if (painter.text(10, 10, 0x202020, "hello") < 0)
return 1;
return window.close() == 0 ? 0 : 1;
}
Compilation depuis Windows¶
Enregistrer le programme ci-dessus dans build/api-examples/NativePainter.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/NativePainter.cpp build/api-examples/syscall.o -o build/api-examples/NativePainter-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¶
explicit NativePainter(Window& window)¶
Garde une référence à la fenêtre ; elle doit survivre au peintre.
int64_t fill(int x, int y, int w, int h, uint32_t color)¶
Construit Drawing puis appelle Window::fill ; mêmes erreurs.
int64_t text(int x, int y, uint32_t color, const char* value)¶
Copie au plus 127 octets, termine par zéro ; coupure UTF-8 possible.
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.