Reference Python API

Tato reference dokumentuje stabilní veřejný wrapper povrch v tuix.core pro v0.5. Každý záznam metody vysvětluje, jak ji volat a proč existuje.

Import pattern

from tuix.core import engine, builders, registry, input, scenes, buffers, objects

Společná pravidla

Názvy scén, builderů, labely a titulky obvykle přijímají bytes nebo str.
Znakové argumenty jako sym, fill, empty, left a right přijímají one-byte bytes, jednoznakový str nebo integer byte hodnotu.
Metody widgetů používají obj_ptr. V běžném kódu ho jednou získejte přes objects.get_object_by_uid(uid) a znovu používejte.
Většina setterů vrací 0 při úspěchu a nenulovou hodnotu při chybě. Snapshot gettery vrací dict nebo None.
Kompatibilní feed_input metody zůstávají pro starý kód; aktuální v0.5 aplikace mají obvykle spoléhat na input.listen() a engine.main_loop().

Mapa pokrytí

Modul	Dokumentovaný povrch	Primární stránka
tuix.core.builders	Konstanty builderů, aliasy, layout konstanty a register_standard().	Builders
tuix.core.engine	7 metod pro lifecycle, frame, statistiky a mouse capture.	Engine
tuix.core.input	4 metody listeneru a snapshotů.	Input API
tuix.core.scenes	16 metod pro lifecycle, výběr, focus, modal, transakce, statistiky a kompaktaci.	Scenes API
tuix.core.buffers	12 metod pro hierarchii, z-index, layout override, grid placement a snapshoty.	Buffers API
tuix.core.objects	Lifecycle objektů plus každá runtime metoda widgetů, layoutů, viewportů a modalů.	Objects API
tuix.core.registry	RegistryProxy a property current_scene_name.	Registry
tuix.core._lib	Interní bridge helpery dokumentované zvlášť pouze pro debug.	Internal API

Typická startovací sekvence

engine.init()
builders.register_standard()
scenes.init_scene('Main')
scenes.select_scene('Main')
input.listen()

uid = objects.create_object(builders.TEXT, 'Main', 0.5, 0.1, 0.1, 0.1)
obj = objects.get_object_by_uid(uid)
objects.tuix_text_set_text(obj, 'Ready')

engine.main_loop()
input.stop()
engine.shutdown()