shithub: neindaw

Download patch

ref: 0a4745da16ef9463d5fa01eedd7778dcca039288
parent: e93003292b1c6bceed680831cffeae5329bb0104
author: Sigrid Haflínudóttir <ftrvxmtrx@gmail.com>
date: Mon Dec 30 07:48:06 EST 2019

rename ui element types and update readme

--- a/README.md
+++ b/README.md
@@ -19,10 +19,10 @@
 % cd `{cat clone}
 
 # check the A oscillator frequency
-# the order is: type key value initial min max step
+# the order is: type value initial min max step
 # it's different for different UI elements
 % cat K*/a/frequency/ctl
-vslider	0	100.000000	100.000000	10.000000	200.000000	5.000000
+vslider	100.000000	100.000000	10.000000	200.000000	5.000000
 
 # raise frequency to 160Hz
 % echo 160 > K*/a/f*/ctl
@@ -49,9 +49,10 @@
 can be read from it.  The format is raw stream of `float`.
 
 Each DSP instance, in addition to the mentioned files, provides a file
-tree that reflects the UI elements.  UI elements may provide `ctl`
-file to read initial and current, maximum and minimum, step, and may
-be used to write a new value to it.
+tree that reflects the UI elements.  UI elements provide `ctl` file to
+read initial and current, maximum and minimum, step, and may be used
+to write a new value to it.  `metadata` is provided to read/write
+UI-specific metadata key/values.
 
 Several DSPs may be connected by chaining their `data` interfaces
 together.  If some parameters need to be changed dynamically during
--- a/aux.h
+++ b/aux.h
@@ -5,14 +5,14 @@
 	Xdsp,
 	Xdspctl,
 	Xdspdata,
-	UITBox,
-	UIHBox,
-	UIVBox,
+	UITGroup,
+	UIHGroup,
+	UIVGroup,
 	UIButton,
-	UICheck,
+	UICheckBox,
 	UIVSlider,
 	UIHSlider,
-	UINum,
+	UINEntry,
 	UIHBarGraph,
 	UIVBarGraph,
 	Xuictl,
--- a/uiglue.c
+++ b/uiglue.c
@@ -20,14 +20,14 @@
 
 	if (type == Xuictl) {
 		switch (a->type) {
-		case UITBox: snprint(s, sz, "tbox\n"); return s;
-		case UIHBox: snprint(s, sz, "hbox\n"); return s;
-		case UIVBox: snprint(s, sz, "vbox\n"); return s;
+		case UITGroup: snprint(s, sz, "tgroup\n"); return s;
+		case UIHGroup: snprint(s, sz, "hgroup\n"); return s;
+		case UIVGroup: snprint(s, sz, "vgroup\n"); return s;
 		case UIButton: snprint(s, sz, "button\t%d\n", !!*ui->zone); return s;
-		case UICheck: snprint(s, sz, "check\t%d\n", !!*ui->zone); return s;
+		case UICheckBox: snprint(s, sz, "checkbox\t%d\n", !!*ui->zone); return s;
 		case UIVSlider: snprint(s, sz, "vslider\t%f\t%f\t%f\t%f\t%f\n", *ui->zone, ui->init, ui->min, ui->max, ui->step); return s;
 		case UIHSlider: snprint(s, sz, "hslider\t%f\t%f\t%f\t%f\t%f\n", *ui->zone, ui->init, ui->min, ui->max, ui->step); return s;
-		case UINum: snprint(s, sz, "num\t%f\t%f\t%f\t%f\t%f\n", *ui->zone, ui->init, ui->min, ui->max, ui->step); return s;
+		case UINEntry: snprint(s, sz, "nentry\t%f\t%f\t%f\t%f\t%f\n", *ui->zone, ui->init, ui->min, ui->max, ui->step); return s;
 		case UIHBarGraph: snprint(s, sz, "hbargraph\t%f\t%f\t%f\n", *ui->zone, ui->min, ui->max); return s;
 		case UIVBarGraph: snprint(s, sz, "vbargraph\t%f\t%f\t%f\n", *ui->zone, ui->min, ui->max); return s;
 		default: sysfatal("unknown ui type %d", a->type);
@@ -69,7 +69,7 @@
 	}
 
 	if (ui->zone != nil) {
-		if (a->type == UIButton || a->type == UICheck)
+		if (a->type == UIButton || a->type == UICheckBox)
 			v = !!v;
 		else if (*ui->zone < ui->min)
 			v = ui->min;
@@ -113,25 +113,25 @@
 }
 
 static void
-ui_tbox(void *f, const char *label)
+ui_tgroup(void *f, const char *label)
 {
-	newui(f, label, UITBox);
+	newui(f, label, UITGroup);
 }
 
 static void
-ui_hbox(void *f, const char *label)
+ui_hgroup(void *f, const char *label)
 {
-	newui(f, label, UIHBox);
+	newui(f, label, UIHGroup);
 }
 
 static void
-ui_vbox(void *f, const char *label)
+ui_vgroup(void *f, const char *label)
 {
-	newui(f, label, UIVBox);
+	newui(f, label, UIVGroup);
 }
 
 static void
-ui_close(void *file)
+ui_close_group(void *file)
 {
 	File *f;
 
@@ -160,9 +160,9 @@
 }
 
 static void
-ui_check(void *f, const char *label, FAUSTFLOAT *zone)
+ui_checkbox(void *f, const char *label, FAUSTFLOAT *zone)
 {
-	ui_define(f, UICheck, label, zone);
+	ui_define(f, UICheckBox, label, zone);
 }
 
 static void
@@ -190,11 +190,11 @@
 }
 
 static void
-ui_num(void *f, const char *label, FAUSTFLOAT *zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+ui_nentry(void *f, const char *label, FAUSTFLOAT *zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
 {
 	UI *ui;
 
-	ui = ui_define(f, UINum, label, zone);
+	ui = ui_define(f, UINEntry, label, zone);
 	ui->init = init;
 	ui->min = min;
 	ui->max = max;
@@ -236,15 +236,15 @@
 }
 
 UIGlue uiglue = {
-	.openTabBox = ui_tbox,
-	.openHorizontalBox = ui_hbox,
-	.openVerticalBox = ui_vbox,
-	.closeBox = ui_close,
+	.openTabBox = ui_tgroup,
+	.openHorizontalBox = ui_hgroup,
+	.openVerticalBox = ui_vgroup,
+	.closeBox = ui_close_group,
 	.addButton = ui_button,
-	.addCheckButton = ui_check,
+	.addCheckButton = ui_checkbox,
 	.addVerticalSlider = ui_vslider,
 	.addHorizontalSlider = ui_hslider,
-	.addNumEntry = ui_num,
+	.addNumEntry = ui_nentry,
 	.addHorizontalBargraph = ui_hbargraph,
 	.addVerticalBargraph = ui_vbargraph,
 	.declare = ui_declare,