How artemizmaylov/aimp_projectm works
aimp_projectM is an AIMP visualization plugin that feeds AIMP waveform data into ProjectM and returns rendered frames to AIMP. The workflow begins with plugin registration, continues through the visualization adapter and ProjectM rendering core, and ends with pixel output through AIMP’s canvas or direct-output interface. The core also manages randomized and manually selected presets, texture lookup, configurable rendering, and an optional preset-name overlay. Relationships shown are supported by the excerpts or README; external library internals are not represented.
Main entry points: VisualizationCore.cpp ProjectM render core · Visualization.cpp Visualization adapter · Plugin.cpp Plugin entry · Logger.cpp Logging callback
Components 13
AIMP integration
- Plugin entry
sources/Plugin.cpp - Visualization adapter
sources/Visualization.cpp - Direct output adapter
sources/Visualization.cpp - Canvas output
sources/Visualization.cpp
Visualization runtime
- ProjectM render core
sources/VisualizationCore.cpp - ProjectM engine
Presets and settings
- Preset playlist
sources/VisualizationCore.cpp - Preset and texture files
- Settings and paths
sources/VisualizationSettings.h
Rendering support
- Preset title overlay
sources/gltext.h - OpenGL frame target
sources/VisualizationCore.cpp - Logging callback
sources/Logger.cpp
Other components
- AIMP player
Connections 18
- AIMP player → Plugin entry: loads plugin
sources/Plugin.cpp - Plugin entry → AIMP player: registers visualization
sources/Plugin.cpp - AIMP player → Visualization adapter: sends waveform
sources/Visualization.cpp - Visualization adapter → ProjectM render core: creates and drives
sources/Visualization.cpp - Visualization adapter → AIMP player: returns canvas pixels
sources/Visualization.cpp - Visualization adapter → Direct output adapter: exposes interface
sources/Visualization.cpp - Direct output adapter → ProjectM render core: draws and reads pixels
sources/Visualization.cpp - ProjectM render core → ProjectM engine: feeds audio and renders
sources/VisualizationCore.cpp - ProjectM render core → Preset playlist: creates and controls
sources/VisualizationCore.cpp - Preset playlist → Preset and texture files: loads preset files
README.md - ProjectM render core → Preset and texture files: sets texture search path
sources/VisualizationCore.cpp - ProjectM render core → Settings and paths: loads configuration
sources/VisualizationCore.cpp - Visualization adapter → Settings and paths: loads display limits
sources/Visualization.cpp - ProjectM render core → OpenGL frame target: renders frame target
sources/VisualizationCore.cpp - ProjectM render core → Preset title overlay: draws preset name
sources/VisualizationCore.cpp - Visualization adapter → Logging callback: logs via core
- ProjectM render core → Logging callback: logs runtime events
sources/VisualizationCore.cpp - Plugin entry → Logging callback: configures callback
sources/Plugin.cpp