cxxmidi
cxxmidi copied to clipboard
5tan
C++ MIDI library
cxxmidi
C++ MIDI library.
Key features
- MIDI files read/write
- MIDI files parsing, editing, sequencing (composition)
- MIDI outputs
- ALSA on Linux
- WinMM on Windows
- Multiplatform MIDI players
- synchronous
- asynchronous
Design
- Multiplatform (Linux, Windows)
- Endian safe
- Boost-like HPP header files only library
Simple example
#include <cxxmidi/file.hpp>
#include <cxxmidi/output/default.hpp>
#include <cxxmidi/player/synchronous.hpp>
int main(int /*argc*/, char** /*argv*/) {
cxxmidi::output::Default output;
for (size_t i = 0; i < output.GetPortCount(); i++)
std::cout << i << ": " << output.GetPortName(i) << std::endl;
output.OpenPort(1);
cxxmidi::File file("music/chopin.mid");
cxxmidi::player::Synchronous player(&output);
player.SetFile(&file);
player.SetCallbackHeartbeat(
[&]() { std::cout << player.CurrentTimePos().count() << std::endl; });
player.Play();
}
More examples
examples/callbacksUse of CxxMidi callbacks.examples/qtmidieditorSimple Qt GUI MIDI editor.examples/qtmidiplayerSimple Qt GUI MIDI player.examples/player_asyncAsynchronous MIDI player.examples/player_syncSynchronous MIDI player.examples/sequencingHow to algorithmically create MIDI files.
How to use
To use library clone the repo and copy include directory into your project.
Use of some cxxmidi classes requires external libraries linkage.
| Class | Required external library |
|---|---|
cxxmidi::output::Alsa |
libasound |
cxxmidi::output::Windows |
winmm.lib |
How to build tests and examples
mkdir build
cd build
cmake ..
make
cpplint suppressions
cpplint suppressions in the code are marked:
// NOLINT(${checkName}) ${mark}
| Mark | Related check name | Reason for suppression |
|---|---|---|
CPP11_INCLUDES |
build/c++11 |
[build/c++11] [5] is reported when parsing include directive of unapproved C++11 header file (like chrono, thread or mutex). These files have custom implementations in Chrome, but not in this project. |
INCLUDE_NO_DIR |
build/include_subdir |
[build/include_subdir] [4] is reported if no directory name is present in include directive, but it is common in Qt code to skip it. This exception is allowed only in examples code. |
SIGNAL_SLOT_SPECIFIER |
[whitespace/indent] |
[whitespace/indent] [3] is reported when parsing Qt signal/slot specifiers. |
cppcheck suppressions
cppcheck suppressions in the code are marked:
// cppcheck-suppress ${checkName} ${mark}
| Mark | Related check name | Reason for suppression |
|---|---|---|
RAII |
unreadVariable |
(style) Variable '...' is assigned a value that is never used. is reported for RAII objects like mutexes. |
LIB_FUNC |
unusedFunction |
(style) The function '...' is never used. is reported for library functions. |
License
- cxxmidi: MIT
- RtMidi: https://www.music.mcgill.ca/~gary/rtmidi/index.html#license
5tan