How aptumfr/lv works
lv:: is a header-only C++20 wrapper for LVGL. The principal workflow is application code initializing LVGL, creating a display and composing a UI from widgets and layouts, then running LVGL’s timer handler to process the interface. Core wrappers provide object, event, style, and state APIs; additional modules cover animation, input, drawing, assets, internationalization, and fragments. The graph reflects README capabilities and sampled/index evidence; connections to unsampled subsystems are omitted unless documented.
Main entry points: object.hpp Object API · widgets Widgets · objectref.hpp Object references · style.hpp Style API
Components 26
Application UI
- Lifecycle loop
include/lv/core/app.hpp - Display setup
include/lv/core/display.hpp - Components
include/lv/core/component.hpp - Widgets
include/lv/widgets - Layouts
include/lv/layout - Reactive state
include/lv/core/state.hpp - Label widget
include/lv/widgets/label.hpp
Core wrappers
- Object API
include/lv/core/object.hpp - Object references
include/lv/core/objectref.hpp - Typed events
include/lv/core/event.hpp - Style API
include/lv/core/style.hpp - Color utilities
include/lv/core/color.hpp - Version support
include/lv/core/version.hpp - C API interop
include/lv/core/wrap.hpp - String utilities
include/lv/core/string_utils.hpp
Presentation
- Drawing APIs
include/lv/draw - Animation
include/lv/core/anim.hpp - Input devices
include/lv/core/indev.hpp - Font loading
include/lv/core/font_loader.hpp - Image support
include/lv/core/image.hpp - Filesystem
include/lv/core/fs.hpp - Timers
include/lv/core/timer.hpp
Runtime extensions
- Internationalization
include/lv/core/translation.hpp - Fragment navigation
include/lv/others/fragment.hpp
Other components
- Application code
- LVGL runtime
Connections 31
- Application code → Lifecycle loop: initializes and runs
- Application code → Display setup: creates display
- Application code → Widgets: composes UI
- Application code → Components: builds component
- Application code → Reactive state: updates state
- Lifecycle loop → LVGL runtime: handles timers
include/lv/core/app.hpp - Display setup → LVGL runtime: configures display
- Components → Object references: uses references
include/lv/core/component.hpp - Widgets → Object API: wraps objects
include/lv/widgets/button.hpp - Widgets → Typed events: uses callbacks
include/lv/widgets/button.hpp - Widgets → Style API: uses styling
include/lv/widgets/button.hpp - Layouts → Object API: creates containers
include/lv/layout/flex.hpp - Layouts → Style API: sets layout styles
include/lv/layout/grid.hpp - Reactive state → Widgets: updates UI
- Object references → Object API: extends object view
include/lv/core/objectref.hpp - Object references → Typed events: provides event API
include/lv/core/objectref.hpp - Object references → Style API: provides style API
include/lv/core/objectref.hpp - Object API → C API interop: uses wrapper types
include/lv/core/object.hpp - Label widget → String utilities: uses text helpers
include/lv/widgets/label.hpp - Label widget → Object API: creates LVGL object
include/lv/widgets/label.hpp - Animation → Object API: animates objects
include/lv/core/anim.hpp - Drawing APIs → LVGL runtime: calls drawing APIs
- Input devices → Typed events: dispatches input events
- Font loading → LVGL runtime: loads fonts
- Image support → LVGL runtime: handles images
- Filesystem → LVGL runtime: wraps filesystem APIs
- Timers → LVGL runtime: wraps timer APIs
- Internationalization → Label widget: translates text
- Fragment navigation → LVGL runtime: manages fragments
include/lv/others/fragment.hpp - Version support → LVGL runtime: detects version
include/lv/core/version.hpp - Color utilities → Style API: sets style colors