Classe C++ : PaintQueue¶
Description¶
File de commandes de dessin avec reprise après saturation.
Nom complet : gaspardos::desktop::PaintQueue.
En-tête : bindings/cpp/desktop_gui.hpp. C++98.
Dans quel cas l’utiliser¶
Découper le rendu en tours de boucle courts.
Exemple de programme simple¶
#include "desktop_gui.hpp"
#include <cstdio>
#include <cstring>
int main()
{
gaspardos::desktop::PaintQueue queue;
queue.fill(0, 0, 100, 30, 0xFFFFFF);
queue.text(4, 4, "hello");
return queue.finished() ? 1 : 0;
}
Compilation depuis Windows¶
Enregistrer le programme ci-dessus dans build/api-examples/PaintQueue.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/PaintQueue.cpp build/api-examples/syscall.o bindings/cpp/file_explorer.cpp bindings/cpp/desktop_native.cpp bindings/cpp/desktop_gui.cpp -o build/api-examples/PaintQueue-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¶
PaintQueue()¶
Position initiale zéro.
void clear()¶
Efface commandes et position.
void fill(int x, int y, int width, int height, uint32_t color)¶
Ajoute un rectangle si dimensions positives.
void text(int x, int y, const std::string& value, uint32_t color = 0x202020, unsigned columns = 110)¶
Ajoute un texte tronqué à min(columns,120) octets, sans couper UTF-8.
void button(int x, int y, int width, const std::string& text, bool selected = false)¶
Ajoute bordure, fond et titre d’un bouton de hauteur 26.
void input(int x, int y, int width, const TextInput& input, bool focused)¶
Ajoute le rendu d’un TextInput ; largeur utile positive requise.
bool finished() const¶
Vrai quand toutes les commandes ont été traitées.
int64_t paint(gui::Painter& painter)¶
Au plus 12 commandes par appel ; 0 ne signifie pas finished ; erreur conserve la commande courante.
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.