ArchitecturalSummary » History » Version 6
Version 5 (Chris Cannam, 2012-01-13 04:55 PM) → Version 6/10 (Chris Cannam, 2012-01-13 05:02 PM)
h1. Sonic Visualiser: architectural summary
Sonic Visualiser is a substantial application written in C++ using the "Qt":http://qt.nokia.com user interface toolkit.
It is a cross-platform application that can be built on (at least) OS/X, Windows, Linux, and Solaris, but it has a substantial number of dependencies on third-party libraries which contribute to the complexity of the build process. The code also does not currently build with Visual C++; the Windows build is done using MinGW and g++.
The Sonic Visualiser code is provided as a number of separate libraries, with varying dependencies. These are managed in separate projects on this code site, and are as follows:
* "*svcore*":/projects/svcore -- Non-interactive code, without user interface or audio device I/O. This code is used by batch applications such as "Sonic Annotator":/projects/sonic-annotator as well as Sonic Visualiser. It contains a number of submodules:
** *system* -- Some system-dependent code that Qt did not provide
** *base* -- Miscellaneous handy classes
** *data/fft* -- FFT code _[depends on fftw]_
** *data/fileio* -- Audio file import and export and related classes _[depends on libmad, liboggz, libfishsound, libsndfile]_
** *data/midi* -- MIDI-related code _[using rtmidi]_
** *data/model* -- Data models used for Sonic Visualiser's internal representations. These include waveforms (including zoomed previews) as well as grids (spectrograms etc) and editable data (time/value plots, MIDI-style note tracks, text etc).
** *data/osc* -- OSC control _[depends on liblo]_
** *plugin* -- Interfaces for audio plugins such as LADSPA, DSSI, "Vamp":http://vamp-plugins.org/ _[depends on vamp-hostsdk]_
** *transform* -- A set of classes that use such plugins to transform the models found in *data/model* into one another (through audio analysis or effects transformations)
** *rdf* -- Classes to carry out RDF queries and to import and export RDF data to models or transforms _[depends on librdf]_
* "*svgui*":/projects/svgui -- User interface widgets and helpers, with the following submodules:
** *widgets* -- Custom Qt widgets
** *layer* -- Classes that manage rendering of the data models found in *svcore/data/model* onto a widget surface, and limited interactive editing. These include the waveform renderer, line plots, grids, time ruler, etc. Layers rely on a lot of common code to carry out scaling and manage adjustable properties.
** *view* -- Classes (in fact also widgets) which display layers on top of one another. The View class handles drawing, and the Pane subclass handles interaction.
* "*svapp*"
Sonic Visualiser is a substantial application written in C++ using the "Qt":http://qt.nokia.com user interface toolkit.
It is a cross-platform application that can be built on (at least) OS/X, Windows, Linux, and Solaris, but it has a substantial number of dependencies on third-party libraries which contribute to the complexity of the build process. The code also does not currently build with Visual C++; the Windows build is done using MinGW and g++.
The Sonic Visualiser code is provided as a number of separate libraries, with varying dependencies. These are managed in separate projects on this code site, and are as follows:
* "*svcore*":/projects/svcore -- Non-interactive code, without user interface or audio device I/O. This code is used by batch applications such as "Sonic Annotator":/projects/sonic-annotator as well as Sonic Visualiser. It contains a number of submodules:
** *system* -- Some system-dependent code that Qt did not provide
** *base* -- Miscellaneous handy classes
** *data/fft* -- FFT code _[depends on fftw]_
** *data/fileio* -- Audio file import and export and related classes _[depends on libmad, liboggz, libfishsound, libsndfile]_
** *data/midi* -- MIDI-related code _[using rtmidi]_
** *data/model* -- Data models used for Sonic Visualiser's internal representations. These include waveforms (including zoomed previews) as well as grids (spectrograms etc) and editable data (time/value plots, MIDI-style note tracks, text etc).
** *data/osc* -- OSC control _[depends on liblo]_
** *plugin* -- Interfaces for audio plugins such as LADSPA, DSSI, "Vamp":http://vamp-plugins.org/ _[depends on vamp-hostsdk]_
** *transform* -- A set of classes that use such plugins to transform the models found in *data/model* into one another (through audio analysis or effects transformations)
** *rdf* -- Classes to carry out RDF queries and to import and export RDF data to models or transforms _[depends on librdf]_
* "*svgui*":/projects/svgui -- User interface widgets and helpers, with the following submodules:
** *widgets* -- Custom Qt widgets
** *layer* -- Classes that manage rendering of the data models found in *svcore/data/model* onto a widget surface, and limited interactive editing. These include the waveform renderer, line plots, grids, time ruler, etc. Layers rely on a lot of common code to carry out scaling and manage adjustable properties.
** *view* -- Classes (in fact also widgets) which display layers on top of one another. The View class handles drawing, and the Pane subclass handles interaction.
* "*svapp*"