smgui/docs/hu/welcome.md

Státusz-Módú GUI API

Üdvözöl az SMGUI, a státusz vezérelt grafikus felhasználói felület eszköztár kézikönyve.

A státusz-vezérelt UI alapelve az, hogy már úgyis megvannak a változóid, szóval elég csak hivatkozni azokra egy űrlapból, nem kell sem visszahívás sem azonnali kódlekezlés, csupán csak azon már meglévő változók értékei vezérlik a GUI megjelenítését.

HINT: Ez a kézikönyv internet nélkül is használható. A jobb-klikk menüben válaszd az "Oldal mentése" menüpontot.

Behúzás

Ez a függvénykönyvtár mindent tartalmaz egyetlen fejlécfájlban, és használható mind fejléc, mind implementációs módban. Alapból a fejléc-mód van használatban, ami lehetővé teszi, hogy más fejlécekből is behúzásra kerüljön, és nem tartalmazza ilyenkor az implementációt. Az implementációs módhoz pontosan egyetlen egy .c/.cpp forrásban meg kell adni az UI_IMPLEMENTATION előfordító define-t pontosan ezen fejléc fájl include-ja előtt.

Az alap függvénykönyvtár platform és motor független. Bármilyen motorral és fontmeghajtóval képes működni, ehhez csak be kell húzni a megfelelő fejlécfájlt még az ui.h előtt. Például:

#include "ui_glfw.h"
#include "ui_psf2.h"
#define UI_IMPLEMENTATION
#include "ui.h"

A referencia implementáció GLFW3, SDL2/3 és X11 motorral érkezik; ami a fontokat illeti, van PC-Screen-Font (amit a Linux Console használ), illetve Scalable Screen Font (sokkal hatékonyabb, mint a TTF vagy OTF, és bármilyen font, bitmap, vektor vagy pixel font átkonvertálható SSFN-é).

Alapból - ha semmilyen másik modul nem lett előtte behúzva -, akkor az ui.h behúzza a GLFW3 motort és a PSF2 font meghajtót, valamint egy minimális, ékezetes betűk néküli ASCII font-ot is beágyaz (2080 bájt lefordítva).

Visszatérési értékek

Hacsak másképp nincs jelezve, minden függvény negatív hibakódot ad vissza.

Define	Leírás
UI_OK	Sikeres, nem volt hiba
UI_ERR_BADINP	Hibás paraméter
UI_ERR_BACKEND	Hiba a motor inicializálásánál
UI_ERR_NOMEM	Memória foglalási hiba