CustomMatPlot (CMP) is a plotting library for C++. It provides an API for embedding plot components into applications using the JUCE framework. The plot component is easy to integrate and is customizable using the included lookandfeel class.
![]() |
![]() |
---|
Note: I'm not a senior developer so there may be several design flaws.
- Features
- Requirements
- Controls
- LookAndFeel
- Graph line attributes
- Examples
- Realtime frequency response example
- Tests
- License
CMP implements many of the same features that exist in Matplotlib. Below is the feature list of CMP:
- Axis scaling: Linear and logarithmic.
- Customizable view using the lookandfeel class.
- Legend.
- Zoom.
- Trace.
- Fill area between two graphs.
- Axis labels.
- Ticks and Tick-labels.
- Grids and tiny grids.
- Markers: Star, triangles, square etc.
- Custom stroke path.
- Callback for every visible data point.
- Callback for tace points.
- Two different downsampler levels.
- Move points in the garph with mouse.
- Customizable userinput mapping using lookandfeel class.
- Compiler that supports C++17
- CMake 3.12
The CMP compontent implements MouseEvents to interact with the plot using the mouse. Below is a list with the default added mouse commands which can be overrided using a custom lookandfeel class (see "move_pixel_points" example):
- Left click drag anywhere in the graph area to zoom into the plot. The zoom area is displayed as traced lined rectangle.
- Right click to zoom out to home.
- Double-click to add a trace-point to the graph lines closest to the mouse pointer.
- Double-click on a trace-point to remove it.
- Drag the trace point to move it along the graph-line.
- Move the trace point label by dragging it.
- Move the legend to by dragging it.
- Move pixel points.
- Panning.
Customize the plot to your liking by overriding the lookandfeel functions. See the lookandfeel example.
Use the graph line attributes to change the appearance of the graph lines. See custom_graph_attributes example.
The examples can be built using the following commands:
# Clone repository
git clone https://github.com/franshej/CustomMatPlot.git
cd CustomMatPlot
# Update submodules
git submodule update --init
mkdir build
cd build
# Config & build
cmake ../ -DCMP_BUILD_EXAMPLES=ON
make -j4
An example app plotting the frequency response of the incoming left and right audio signals can be seen here: Realtime plot example
The juce::UnitTest
class is wrapped into macros to make it easier to write new structured tests.
SECTION(PlotTest, "Plot class") {
cmp::Plot plot;
TEST("Part 1: empty graph line.") {
const auto graph_lines = getChildComponentHelper<cmp::GraphLine>(plot);
expect(graph_lines.empty());
}
TEST("Part 2: single graph line") {
plot.plot({y_data1});
...
}
}
To make it more convenient to write new manual tests the CMP library implements tests macros similar to the macros in google tests.
The following example below will plot a ramp of 10 values from 0-9:
TEST(ramp, non_real_time) {
ADD_PLOT;
std::vector<float> y_test_data(10u);
std::iota(y_test_data.begin(), y_test_data.end(), 0.0f);
PLOT_Y({y_test_data});
}
The MIT License (MIT)
Copyright (c) 2017-2022 Frans Rosencrantz
Free Software, Hell Yeah!