summaryrefslogtreecommitdiff
path: root/src/til_knobs.h
diff options
context:
space:
mode:
authorVito Caputo <vcaputo@pengaru.com>2021-10-01 16:35:08 -0700
committerVito Caputo <vcaputo@pengaru.com>2021-10-01 16:35:08 -0700
commitb686b405c6a22b26e9b8082c92ed91513608bea3 (patch)
tree0000f671501863a8ee9b536ba869221d0f6710f9 /src/til_knobs.h
parentd1da5500261e96efe0ede06fbebb32f0e191f3c1 (diff)
*: librototiller->libtil
Largely mechanical rename of librototiller -> libtil, but introducing a til_ prefix to all librototiller (now libtil) functions and types where a rototiller prefix was absent. This is just a step towards a more libized librototiller, and til is just a nicer to type/read prefix than rototiller_.
Diffstat (limited to 'src/til_knobs.h')
-rw-r--r--src/til_knobs.h91
1 files changed, 91 insertions, 0 deletions
diff --git a/src/til_knobs.h b/src/til_knobs.h
new file mode 100644
index 0000000..370be27
--- /dev/null
+++ b/src/til_knobs.h
@@ -0,0 +1,91 @@
+#ifndef _TIL_KNOBS_H
+#define _TIL_KNOBS_H
+
+#include <assert.h>
+
+/* A knob exposes a binding for some float in a module's context
+ * which can be varied at runtime between frames to influence
+ * the output. There's some overlap with settings, but settings
+ * are more intended for configuration applied at context
+ * creation, which won't vary frame-to-frame, but may influence
+ * the initial value and/or automatic behavior of knobs for
+ * instance, or even which knobs are available.
+ *
+ * At this time knobs will only apply to floats, accompanied by
+ * some rudimentary bounds.
+ *
+ * Integer types would probably be useful, and maybe a precision
+ * specifier, those can be added in the future as needed, but I'd
+ * like to keep it simple for now and see what kind of problems
+ * emerge.
+ *
+ * The current expectation is that a module context struct will
+ * incorporate an array of knobs, replacing loose floats already
+ * being automatically varied within the module frame-to-frame.
+ *
+ * The module will then use the knob_auto_* helpers below to
+ * access and manipulate the values, instead of directly
+ * accessing the loose floats as before.
+ *
+ * External manipulators of the knobs will use the knob_*
+ * helpers, instead of the knob_auto_* helpers, to
+ * access+manipulate the knobs. These helpers are basically just
+ * to get external and internal manipulators to agree on which
+ * side owns control via the managed field.
+ */
+typedef struct til_knob_t {
+ const char *name; /* Short API-oriented name */
+ const char *desc; /* Longer UI-oriented name */
+ const float min, max; /* Value bounds */
+ float value; /* Value knob affects */
+ unsigned managed:1; /* Set when knob control of value is active,
+ * suppress automagic control of value when set.
+ */
+} til_knob_t;
+
+
+/* helper for modules automating knob controls, use this to
+ * change values intead of direct manipulation to respect active.
+ * returns new (or unchanged) value
+ */
+static inline float til_knob_auto_set(til_knob_t *knob, float value)
+{
+ assert(knob);
+
+ if (knob->managed)
+ return knob->value;
+
+ return knob->value = value;
+}
+
+/* identical to knob_auto_set, except adds to existing value.
+ */
+static inline float til_knob_auto_add(til_knob_t *knob, float value)
+{
+ assert(knob);
+
+ return til_knob_auto_set(knob, knob->value + value);
+}
+
+
+/* identical to knob_auto* variants, except intended for
+ * external knob-twisters, i.e. the "managed" knob entrypoints.
+ */
+static inline float til_knob_set(til_knob_t *knob, float value)
+{
+ assert(knob);
+
+ knob->managed = 1;
+
+ return knob->value = value;
+}
+
+
+static inline float til_knob_add(til_knob_t *knob, float value)
+{
+ assert(knob);
+
+ return til_knob_set(knob, knob->value + value);
+}
+
+#endif
© All Rights Reserved