termin-scene¶
termin-scene — scene-core библиотека для движка Termin.
Основная модель:
- Сцена (
tc_scene) хранит сущности и управляет update-циклом. - Сущности живут в
tc_entity_pool— это идентичность, transform и иерархия. - Поведение задаётся компонентами (
tc_component) с lifecycle-хуками. - Плотные данные хранятся в SoA-архетипах (
tc_archetype) для массовых проходов. - Расширения (
tc_scene_extension) добавляют stateful-модули без изменения core.
Документация описывает фактические контракты текущей реализации: lifecycle, валидность handle, владение памятью и ограничения API.
Рекомендуемый маршрут¶
| # | Раздел | Описание |
|---|---|---|
| 1 | Быстрый старт | Минимальный рабочий поток за 5 шагов |
| 2 | Философия и контекст | Зачем так устроено |
| 3 | Архитектура | Слои, модули, поток кадра |
| 4 | Lifecycle | Порядок вызовов для компонентов |
| 5 | Handles и валидность | Generational-модель идентификаторов |
| 6 | Владение и память | Кто владеет объектами, retain/release |
| 7 | SoA и архетипы | Плотное хранение и chunk-итерация |
| 8 | Scene Extensions | Подключаемые модули сцены |
| 9 | API Reference | Публичные заголовки и как читать API |
| 10 | Ограничения и подводные камни | Что может пойти не так |