How waywallen/open-wallpaper-engine works
Open Wallpaper Engine provides two wallpaper runtimes: a Vulkan scene renderer for packaged scenes and a CEF-based renderer for web wallpapers. The scene workflow loads package assets, parses scene content into runtime objects, and prepares and renders frames; standalone and Waywallen hosts provide entry points. The README documents these product capabilities and host relationships. Source excerpts expose render-pipeline preparation and selected web and bridge behavior, but many parser and host connections are not shown, so those edges are omitted rather than inferred.
Main entry points: WebViewer.cpp WebViewer · SceneRenderPipeline.cpp Render preparation · BrowserHost.cpp CEF browser host · Scene.cpp Scene state
Components 29
Scene Content
- Scene parsing
src/Scene/Pkg/Parse/Scene - Image layers
src/Scene/Pkg/Parse/Image/SceneImageObjectParser.cpp - Texture assets
src/Scene/Pkg/Parse/Image/TexImageParser.cpp - Particles
src/Scene/Pkg/Parse/Particle/ParticleParser.cpp - Particle objects
src/Scene/Pkg/Parse/Particle/SceneParticleObjectParser.cpp - Puppet models
src/Scene/Pkg/Parse/Puppet/MdlParser.cpp - Text layers
src/Scene/Pkg/Parse/Scene/SceneTextObjectParser.cpp - Shader parsing
src/Scene/Pkg/Parse/Shader/ShaderParser.cpp - Uniform sources
src/Scene/Pkg/Parse/Uniform/UniformSource.cpp - Audio response
src/Scene/Audio/SceneAudioResponse.cpp
Scene Runtime
- Scene state
src/Scene/Scene/Scene.cpp - Text runtime
src/Scene/Text/Text.cpp - Render preparation
src/Scene/SceneRenderPipeline.cpp - Render graph state
src/Scene/VulkanRender/BuildSceneRenderState.cpp - Vulkan renderer
src/Scene/VulkanRender/VulkanRender.cpp
Web Runtime
- CEF browser host
src/Web/BrowserHost.cpp - Browser client
src/Web/ClientHandler.cpp - Offscreen painting
src/Web/OsrRenderHandler.cpp - Web application
src/Web/AppHandler.cpp
Viewer Hosts
- WebViewer
viewer/WebViewer/WebViewer.cpp - Web presentation
viewer/WebViewer/EglPresenter.cpp - Vulkan blitter
viewer/WebViewer/VulkanBlitter.cpp - SceneViewer
viewer/SceneViewer/SceneViewer.cpp - Waywallen scene host
waywallen/SceneRenderer/scene_entry.cpp - Bridge session
waywallen/Producer/BridgeSession.cpp - Waywallen web host
waywallen/WebRenderer/web_entry.cpp - Web producer device
waywallen/WebRenderer/WebProducerDevice.cpp
Other components
- Wallpaper user
- Scene package
Connections 17
- Wallpaper user → SceneViewer: runs viewer
README.md - SceneViewer → Scene package: loads package
README.md - Wallpaper user → WebViewer: runs viewer
README.md - WebViewer → CEF browser host: hosts CEF
- CEF browser host → Browser client: uses client
- Browser client → Offscreen painting: sets render handler
src/Web/ClientHandler.cpp - Web application → CEF browser host: configures browser
- WebViewer → Web presentation: presents frames
- WebViewer → Vulkan blitter: blits frames
- Wallpaper user → Waywallen scene host: uses plugin
README.md - Waywallen scene host → Bridge session: uses bridge
- Wallpaper user → Waywallen web host: uses plugin
README.md - Waywallen web host → Web producer device: produces frames
- Scene package → Scene parsing: parses content
- Scene state → Render preparation: prepares frames
src/Scene/SceneRenderPipeline.cpp - Render preparation → Scene state: captures changes
src/Scene/SceneRenderPipeline.cpp - Render preparation → Render graph state: builds graph state
src/Scene/SceneRenderPipeline.cpp