Registry API

The RegistryProxy is an advanced native inspection interface that provides low-level diagnostics into the underlying C TuixRegistry memory pool. It is intended for advanced tools, memory profilers, and bridge debugging.

Public Surface

Surface	How to use it	Why it exists
core.registry	Import core from tuix.core and access properties on core.registry.	Provides a Python proxy over native registry state.
core.registry.current_scene_name	Read or assign bytes/str scene names; prefer scene.select_scene(name) for normal switching.	Maintains compatibility with older code and fallback paths that set the active scene directly.

Advanced Mirrored Fields

When native registry state is available, RegistryProxy may mirror scenes, subcycles, builders, frame_counter, next_uid, terminal_width, terminal_height, terminal_width_old, terminal_height_old, and debug_config. Treat these as diagnostics unless you are debugging the core.

Usage

from tuix.core import core, scene

scene.select_scene(b'Main')
active = core.registry.current_scene_name

# Direct low-level property path:
core.registry.current_scene_name = b'Main'

Prefer Scene APIsDo not mutate mirrored low-level fields directly in application code. Use scene, buffer, object, and core helpers instead.