How emdyeray/library-of-stars works
Starry Library is a native interactive 3D reading application. The principal workflow is to browse a room or catalog, select a book, approach and open it, then read and turn illustrated pages with animated pop-ups; a separate lectern provides mission references. The map preserves the documented bilingual catalogs and reading collections. Edges follow README statements or source-index references; desktop event-loop and several runtime links are only documented or implied, so uncertain links are omitted or dashed.
Main entry points: library.cpp Book collections · locale.hpp Language selection · ui.cpp Interface interaction · render.cpp 3D renderer
Components 18
Desktop experience
- Application entry
src/main.cpp - Desktop window
src/desktop.cpp - Interface interaction
src/ui.cpp
Reading and content
- Library state
src/library.cpp - Book collections
src/library.cpp - Original stories
src/stories.cpp - Children's readings
src/child_text.cpp - Adult readings
src/adult_books.cpp - Adapted readings
src/imported_books.cpp - Technical notes
src/technical_notes.cpp
Rooms and rendering
- Room navigation
src/room.cpp - Room layout
src/room_layout.cpp - 3D renderer
src/render.cpp
Pages and pop-ups
- Book page artwork
src/printing.cpp - Foldable pop-ups
src/popup.cpp
Language and references
- Language selection
src/locale.hpp - Mission references
src/references.hpp
Other components
- Library visitor
Connections 24
- Library visitor → Desktop window: uses controls
README.md - Application entry → Desktop window: starts
src/main.cpp - Desktop window → Interface interaction: dispatches input
- Interface interaction → Library state: selects and reads
README.md - Library state → Book collections: provides catalog
src/library.cpp - Library state → Room navigation: navigates rooms
- Library state → Room layout: uses layout
src/library.cpp - Library state → Language selection: uses language
src/library.cpp - Book collections → Original stories: uses stories
src/library.cpp - Book collections → Children's readings: uses readings
src/library.cpp - Book collections → Adult readings: uses readings
src/library.cpp - Book collections → Adapted readings: uses readings
src/library.cpp - Book collections → Technical notes: uses notes
src/library.cpp - Interface interaction → Mission references: opens links
README.md - Interface interaction → 3D renderer: requests drawing
- 3D renderer → Room navigation: draws rooms
src/render.cpp - 3D renderer → Book page artwork: renders pages
src/render.cpp - 3D renderer → Foldable pop-ups: loads scenes
src/render.cpp - Book page artwork → Original stories: uses chapter art
src/printing.cpp - Foldable pop-ups → Original stories: maps figures
src/popup.cpp - Language selection → Children's readings: selects translation
src/locale.hpp - Language selection → Adult readings: selects translation
src/locale.hpp - Language selection → Adapted readings: selects translation
src/locale.hpp - Language selection → Technical notes: selects translation
src/locale.hpp