How studiocherno/walnut works
Walnut is a C++ desktop application framework combining Dear ImGui UI with Vulkan rendering. The principal workflow is a client-defined application launched through Walnut’s entry point, initialized and run by the framework, with layers providing app UI; images can be uploaded as Vulkan textures. The README also describes real-time Vulkan rendering alongside UI. Sampled sources show input polling, image upload, and random utilities. Several implementation details are unsampled, so only documented or visible relationships are shown.
Main entry points: Application.cpp Application runtime · Image.cpp Image textures · WalnutApp.cpp Client application · Application.h Application API
Components 17
Application launch
- Entry point
Walnut/src/Walnut/EntryPoint.h - Client application
WalnutApp/src/WalnutApp.cpp
Framework runtime
- Application runtime
Walnut/src/Walnut/Application.cpp - Application API
Walnut/src/Walnut/Application.h - Layer interface
Walnut/src/Walnut/Layer.h - Input polling
Walnut/src/Walnut/Input/Input.cpp - Input codes
Walnut/src/Walnut/Input/KeyCodes.h
UI and graphics
- Dear ImGui UI
Walnut/src/Walnut/Application.cpp - Vulkan renderer
Walnut/src/Walnut/Application.cpp - Image textures
Walnut/src/Walnut/Image.cpp - ImGui backend build
Walnut/src/Walnut/ImGui/ImGuiBuild.cpp
App utilities
- Random utilities
Walnut/src/Walnut/Random.h - Timer utility
Walnut/src/Walnut/Timer.h
Other components
- App user
- GLFW window/input
- Vulkan API
- stb_image decoder
Connections 17
- App user → Client application: creates app
README.md - Entry point → Client application: calls factory
Walnut/src/Walnut/EntryPoint.h - Client application → Application runtime: constructs
WalnutApp/src/WalnutApp.cpp - Client application → Layer interface: pushes layer
WalnutApp/src/WalnutApp.cpp - Application runtime → Application API: implements
Walnut/src/Walnut/Application.cpp - Application API → Layer interface: manages layers
Walnut/src/Walnut/Application.h - Application runtime → GLFW window/input: creates window
Walnut/src/Walnut/Application.cpp - Input polling → Application API: gets window
Walnut/src/Walnut/Input/Input.cpp - Input polling → GLFW window/input: polls input
Walnut/src/Walnut/Input/Input.cpp - Input polling → Input codes: uses codes
- Application runtime → Dear ImGui UI: renders UI
Walnut/src/Walnut/Application.cpp - Application runtime → Vulkan renderer: submits frames
Walnut/src/Walnut/Application.cpp - Image textures → Application API: uses device
Walnut/src/Walnut/Image.cpp - Image textures → Vulkan renderer: uploads textures
Walnut/src/Walnut/Image.cpp - Image textures → Dear ImGui UI: registers texture
Walnut/src/Walnut/Image.cpp - Image textures → stb_image decoder: decodes files
Walnut/src/Walnut/Image.cpp - Vulkan renderer → Vulkan API: calls API
Walnut/src/Walnut/Application.cpp