control.h

   1 /* control.h - API for interfaces to the controls of a jackspa plugin instance
   2  * Copyright © 2013 Géraud Meyer <graud@gmx.com>
   3  *
   4  * control.h is part of ng-jackspa.
   5  *
   6  * ng-jackspa is free software; you can redistribute it and/or modify it under
   7  * the terms of the GNU General Public License version 2 as published by the
   8  * Free Software Foundation.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  12  * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  13  * for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18
  19 #ifndef CONTROL_H
  20 #define CONTROL_H
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif
  24
  25 #include <glib.h>
  26 #include <ladspa.h>
  27 #include "jackspa.h"
  28
  29 enum ctype {
  30         JACKSPA_FLOAT,
  31         JACKSPA_INT,
  32         JACKSPA_TOGGLE
  33 };
  34
  35 typedef struct {
  36         unsigned long port;
  37         unsigned long ctrl;
  38         const char *name;
  39         const LADSPA_PortDescriptor *desc;
  40         const LADSPA_PortRangeHint *hint;
  41         /* value in the plugin */
  42         LADSPA_Data *val;
  43         /* values selected in the interface */
  44         LADSPA_Data sel;
  45         /* value range */
  46         LADSPA_Data min;
  47         LADSPA_Data max;
  48         LADSPA_Data *def;
  49         enum ctype type;
  50         struct { LADSPA_Data fine; LADSPA_Data coarse; } inc;
  51 } control_t;
  52
  53
  54 /* Return a value close to val that is valid for the given control */
  55 /* val is supposed to be inside the min/max of control */
  56 LADSPA_Data control_rounding(const control_t *control, LADSPA_Data val);
  57
  58 /* Exchange the selected and the active values */
  59 void control_exchange(control_t *control);
  60
  61
  62 /* Initial config (command line switches) */
  63 extern const GOptionEntry control_entries[];
  64
  65 /* Compute the type, the bounds, the default value and the increments */
  66 int control_init(control_t *control, state_t *state, unsigned long port,
  67                  unsigned long ctrl);
  68
  69
  70 /* Array of pointers */
  71 /* Using an array type would be invalid C++ */
  72 typedef control_t **controls_t;
  73
  74 /* Allocate an array *controls and initialise it with allocated controls (and
  75  * set *count to the number of controls) */
  76 int control_buildall(unsigned long *count, controls_t *controls, state_t *state);
  77
  78 /* Deallocate the array *controls */
  79 void control_cleanupall(unsigned long count, controls_t *controls);
  80
  81 #ifdef __cplusplus
  82 } /* extern "C" */
  83 #endif
  84 #endif