mini-curve-display: support stacked mini curves

Author: abique

include/clap/ext/draft/mini-curve-display.h

@@ -54,14 +54,38 @@ typedef struct clap_mini_display_curve_hints {
 
 } clap_mini_display_curve_hints_t;
 
+// A set of points representing the curve to be painted.
+typedef struct clap_mini_display_curve_data {
+   // Indicates the kind of curve those values represent, the host can use this
+   // information to paint the curve using a meaningful color.
+   int32_t curve_kind;
+
+   // values[0] will be the leftmost value and values[data_size -1] will be the rightmost
+   // value.
+   //
+   // The value 0 and UINT16_MAX won't be painted.
+   // The value 1 will be at the bottom of the curve and UINT16_MAX - 1 will be at the top.
+   uint16_t *values;
+   uint32_t  values_count;
+} clap_mini_display_curve_data_t;
 
 typedef struct clap_plugin_mini_curve_display {
+   // Returns the number of curves the plugin wants to paint.
+   // Be aware that the space to display those curves will be small, and too much data will make
+   // the output hard to read.
+   uint32_t(CLAP_ABI *get_curve_count)(const clap_plugin_t *plugin);
+
    // Renders the curve into the data buffer.
-   // The value 0 will be at the bottom of the curve and UINT16_MAX will be at the top.
-   // The value at index 0 will be the leftmost and the value at index data_size -1 will be the
-   // rightmost.
+   //
+   // The host will "stack" the curves, from the first one to the last one.
+   // data[0] is the first curve to be painted.
+   // data[n + 1] will be painted over data[n].
+   //
+   // Returns the number of curves rendered.
    // [main-thread]
-   bool(CLAP_ABI *render)(const clap_plugin_t *plugin, uint16_t *data, uint32_t data_size);
+   uint32_t(CLAP_ABI *render)(const clap_plugin_t            *plugin,
+                              clap_mini_display_curve_data_t *data,
+                              uint32_t                        data_size);
 
    // Tells the plugin if the curve is currently observed or not.
    // When it isn't observed render() can't be called.
@@ -77,6 +101,7 @@ typedef struct clap_plugin_mini_curve_display {
    // Returns true on success, if the name capacity was sufficient.
    // [main-thread]
    bool(CLAP_ABI *get_axis_name)(const clap_plugin_t *plugin,
+                                 uint32_t             curve_index,
                                  char                *x_name,
                                  char                *y_name,
                                  uint32_t             name_capacity);
@@ -97,8 +122,8 @@ typedef struct clap_host_mini_curve_display {
    // true if succesful. If not, return false.
    // [main-thread]
    bool(CLAP_ABI *get)(const clap_host_t               *host,
-      uint32_t                         kind,
-      clap_mini_display_curve_hints_t *hints);
+                       uint32_t                         kind,
+                       clap_mini_display_curve_hints_t *hints);
 
    // Mark the curve as being static or dynamic.
    // The curve is initially considered as static, though the plugin should explicitely