How webosose/luna-surfacemanager works
Luna surface manager is the webOS Wayland compositor, implemented with Qt/QML. Its principal workflow starts the compositor, establishes its window and core, then manages client surfaces and their presentation and input. The repository also provides shell-surface handling, grouped surfaces, foreign surface export/import, input-method support, and compositor extensions. Relationships below are limited to startup calls visible in the excerpt, explicit source references, and documented behavior; several implementation files were not sampled, so some subsystem links are intentionally omitted.
Main entry points: main.cpp Compositor launcher · weboscorecompositor.cpp Core compositor · webosforeign.cpp Foreign surfaces · webossurfaceitem.cpp Surface items
Components 21
Startup and core
- Compositor launcher
base/src/main.cpp - Compositor config
modules/weboscompositor/weboscompositorconfig.cpp - Compositor window
modules/weboscompositor/weboscompositorwindow.cpp - Core compositor
modules/weboscompositor/weboscorecompositor.cpp
Surface management
- Surface items
modules/weboscompositor/webossurfaceitem.cpp - Surface model
modules/weboscompositor/webossurfacemodel.cpp - Shell surfaces
modules/weboscompositor/shell/webosshellsurface.cpp - Surface groups
modules/weboscompositor/surfacegroup/webossurfacegroup.cpp - Window models
modules/weboscompositor/weboswindowmodel.cpp
Platform integrations
- Foreign surfaces
modules/weboscompositor/foreign/webosforeign.cpp - Video output
modules/weboscompositor/foreign/videooutputd_communicator.cpp - Video informer
modules/weboscompositor/foreign/videowindow_informer.cpp
Input methods
- Input context
modules/weboscompositor/input/waylandinputmethodcontext.cpp - Input method
modules/weboscompositor/input/waylandinputmethod.cpp - IME manager
modules/weboscompositor/input/waylandinputmethodmanager.cpp - Input panel
modules/weboscompositor/input/waylandinputpanel.cpp - Text model
modules/weboscompositor/input/waylandtextmodel.cpp
Compositor extensions
- Extension API
modules/weboscompositorextension/compositorextension.cpp - Extension factory
modules/weboscompositor/compositorextensionfactory.cpp
Other components
- webOS runtime
- IME service
Connections 23
- webOS runtime → Compositor launcher: starts
base/src/main.cpp - Compositor launcher → Compositor config: reads config
base/src/main.cpp - Compositor launcher → Compositor window: creates window
base/src/main.cpp - Compositor launcher → Core compositor: initializes
base/src/main.cpp - Compositor launcher → Extension factory: loads plugin
base/src/main.cpp - Core compositor → Compositor config: uses config
- Core compositor → Surface items: creates items
- Core compositor → Input method: creates method
- Core compositor → Foreign surfaces: creates foreign handler
- Surface items → Shell surfaces: uses shell state
- Surface groups → Surface items: groups items
modules/weboscompositor/surfacegroup/webossurfacegroup.cpp - Surface groups → Window models: updates model
modules/weboscompositor/surfacegroup/webossurfacegroup.cpp - Surface items → Surface model: backs model
- Foreign surfaces → Surface items: exports surfaces
modules/weboscompositor/foreign/webosforeign.cpp - Foreign surfaces → Compositor window: checks geometry
modules/weboscompositor/foreign/webosforeign.cpp - Foreign surfaces → Video output: uses communicator
modules/weboscompositor/foreign/webosforeign.cpp - Foreign surfaces → Video informer: uses informer
modules/weboscompositor/foreign/webosforeign.cpp - Input context → Input method: notifies context
modules/weboscompositor/input/waylandinputmethodcontext.cpp - Input context → IME manager: requests service
modules/weboscompositor/input/waylandinputmethodcontext.cpp - Input context → Text model: updates model
modules/weboscompositor/input/waylandinputmethodcontext.cpp - Input context → Input panel: updates panel
modules/weboscompositor/input/waylandinputmethodcontext.cpp - IME manager → IME service: activates service
modules/weboscompositor/input/waylandinputmethodmanager.cpp - Extension factory → Extension API: loads extension