How chuanyuannotboat/catch_chart_editor works
Malody Catch Chart Editor is a Qt desktop application for creating, editing, previewing, and exporting Catch charts. The principal workflow is to open or create a chart, edit notes and tempo through the editor, then save or export it; playback and preview provide feedback along the way. The architecture separates UI, chart editing and file handling, playback/rendering, and plugin extensions. Relationships are based on the README and the supplied source excerpts and index; unsampled implementation details are not assumed.
Main entry points: Application.cpp Application · ChartController.cpp Chart Controller · PluginManager.cpp Plugin Manager · PlaybackController.cpp Playback Controller
Components 21
Editor UI
- Application
src/app/Application.cpp - Main Window
src/app/MainWindow.cpp - Chart Canvas
src/ui/CustomWidgets/ChartCanvas/ChartCanvas.cpp - Editor Panels
src/ui/NoteEditPanel.cpp
Chart Editing
- Chart Controller
src/controller/ChartController.cpp - Chart Model
src/model/Chart.cpp - Selection Controller
src/controller/SelectionController.cpp - Curve Editor
src/editor/NoteChain/NoteChainEditor.cpp - Curve Sidecar
src/editor/NoteChain/NoteChainPersistence.cpp
Playback & Preview
- Playback Controller
src/controller/PlaybackController.cpp - Audio Player
src/audio/AudioPlayer.cpp - BPM Measurement
src/audio/BpmDetector.cpp - Realtime Preview
src/ui/CustomWidgets/RealtimePreviewWidget.cpp - Chart Rendering
src/render/NoteRenderer.cpp
Chart Files
- Chart IO
src/file/ChartIO.cpp - Project IO
src/file/ProjectIO.cpp
Plugin Extensions
- Plugin Manager
src/plugin/PluginManager.cpp - Process Plugins
src/plugin/ExternalProcessPlugin.cpp - Note Chain Assist
plugins/builtin/note_chain_assist/note_chain_assist.py - Note Color Formatter
plugins/builtin/note_color_formatter/note_color_formatter.py
Other components
- Editor User
Connections 24
- Editor User → Application: opens editor
- Application → Main Window: creates window
src/app/Application.cpp - Application → Chart Controller: creates controller
src/app/Application.cpp - Application → Selection Controller: creates controller
src/app/Application.cpp - Application → Playback Controller: creates controller
src/app/Application.cpp - Application → Plugin Manager: initializes plugins
src/app/Application.cpp - Editor User → Chart Canvas: edits chart
- Editor User → Editor Panels: chooses edit mode
- Chart Controller → Chart Model: updates model
- Chart Controller → Chart IO: loads and saves
src/controller/ChartController.cpp - Curve Editor → Chart Controller: commits edits
src/editor/NoteChain/NoteChainEditor.cpp - Curve Editor → Curve Sidecar: persists curves
- Editor User → Chart IO: saves or exports
- Chart IO → Project IO: packages export
- Playback Controller → Audio Player: controls audio
src/controller/PlaybackController.cpp - Editor User → Playback Controller: starts playback
- Editor User → BPM Measurement: measures tempo
- Realtime Preview → Chart Controller: reads chart
src/ui/CustomWidgets/RealtimePreviewWidget.cpp - Realtime Preview → Playback Controller: reads playback
src/ui/CustomWidgets/RealtimePreviewWidget.cpp - Realtime Preview → Chart Rendering: uses renderer
src/ui/CustomWidgets/RealtimePreviewWidget.cpp - Plugin Manager → Process Plugins: manages processes
src/plugin/PluginManager.cpp - Plugin Manager → Note Chain Assist: loads plugin
- Plugin Manager → Note Color Formatter: loads plugin
- Editor User → Note Chain Assist: uses tool actions