How newterm/florence works
Florence is an accessible virtual keyboard: users point at or touch on-screen keys, which are rendered as a keyboard and dispatched as input; optional auto-click and focus-aware hiding support hands-free use. The GTK application also provides preferences, tray controls, configurable layouts/styles, and an optional Qt widget integration. The graph separates the GTK runtime, its domain layers, Qt components, and the layout editor. Edges reflect README statements or SOURCE INDEX references; unsampled implementations are represented only at the subsystem level.
Main entry points: florence.c Runtime coordinator · view.c Keyboard display · keyboard.c Keyboard assembly · florence.cpp Qt keyboard widget
Components 23
GTK keyboard
- Application startup
src/main.c - Runtime coordinator
src/florence.c - Preferences state
src/settings.c - Preferences window
src/settings-window.c - Tray controls
src/trayicon.c - Session service
src/service.c
Input and presentation
- Keyboard assembly
src/keyboard.c - Layout reader
src/layoutreader.c - Key behavior
src/key.c - Input state
src/status.c - Input state machine
src/fsm.c - Keyboard display
src/view.c - Visual styling
src/style.c - System keyboard input
src/xkeyboard.c - Ramble input mode
src/ramble.c
Qt widget
- Qt keyboard widget
qt/src/florence.cpp - Qt key interaction
qt/src/key.cpp - Qt keymap
qt/src/keymap.cpp - Qt settings
qt/src/settings.cpp - Qt style loader
qt/src/style.cpp
Layout editor
- Layout editor
editor/editor.py - Editor toolkit
editor/toolkit.py
Other components
- Pointing-device user
Connections 27
- Pointing-device user → Keyboard display: points at keys
README - Application startup → Preferences state: initializes
src/main.c - Application startup → Runtime coordinator: creates runtime
src/main.c - Application startup → Session service: terminates
src/main.c - Runtime coordinator → Preferences state: uses settings
src/florence.c - Runtime coordinator → Keyboard assembly: creates keyboard
src/florence.c - Runtime coordinator → Keyboard display: coordinates display
src/florence.c - Runtime coordinator → System keyboard input: uses system input
src/florence.c - Runtime coordinator → Layout reader: loads layouts
src/florence.c - Keyboard assembly → Layout reader: reads layout
- Keyboard assembly → Key behavior: assembles keys
- Keyboard assembly → System keyboard input: uses key mapping
- Input state → Key behavior: tracks key state
- Input state → Keyboard display: updates display
- Input state → Input state machine: uses state machine
- Keyboard display → Keyboard assembly: displays keyboard
src/view.c - Keyboard display → Preferences state: reads settings
src/view.c - Keyboard display → Visual styling: uses styling
- Visual styling → Layout reader: reads style data
src/style.c - Preferences window → Preferences state: edits settings
src/settings-window.c - Qt keyboard widget → Qt key interaction: manages keys
qt/src/key.cpp - Qt keyboard widget → Qt settings: uses settings
- Qt keyboard widget → Qt keymap: loads keymap
- Qt keyboard widget → Qt style loader: loads style
- Qt key interaction → Qt style loader: uses style
- Qt key interaction → Qt keymap: uses keymap
- Layout editor → Editor toolkit: uses toolkit
editor/editor.py