cawUi.cpp : _get_widget_type_id() is now able to directly use ui_var->ui_cfg.

Added enable/hide widget attributes.

Makefile.am

@@ -24,7 +24,7 @@ AM_LDFLAGS  =
 # debug/release switches
 if DEBUG
   AM_CFLAGS   += -g 
-  AM_CXXFLAGS += -g -Wall  -fsanitize=undefined
+  AM_CXXFLAGS += -g -Wall -Wextra -Wno-unused  -fsanitize=undefined
 else
   AM_CFLAGS   += -O3
   AM_CXXFLAGS += -O3
@@ -56,7 +56,7 @@ if cwWEB
   AM_CPPFLAGS += -I$(FFT_DIR)/include -I$(FFT_DIR_D)/include -I$(FFT_DIR_S)/include
   AM_LDFLAGS  += -L$(FFT_DIR)/lib     -L$(FFT_DIR_D)/lib     -L$(FFT_DIR_S)/lib
 else
-  AM_CXXFLAGS += --std=c++17
+  AM_CXXFLAGS += --std=c++20
 endif
 
 include src/libcw/Makefile.am

build/linux/debug/vgrind.sh

@@ -0,0 +1,5 @@
+# export LD_LIBRARY_PATH=~/sdk/libwebsockets/build/out/lib
+# valgrind --leak-check=yes --log-file=vg0.txt --track-origins=yes bin/caw ui ~/src/caw/src/caw/ui/ui_caw.cfg $1
+# valgrind --leak-check=yes --log-file=vg0.txt --track-origins=yes bin/caw test ~/src/cwtest/src/cwtest/cfg/main.cfg /flow_value all echo
+valgrind --leak-check=yes --log-file=vg0.txt --track-origins=yes bin/caw ui ~/src/caw/src/caw/perf/perf_caw.cfg
+

build/linux/release/build.sh

@@ -12,7 +12,7 @@ cd ${curdir}
 # 2) Run the program. ./foo
 # 3) Run gprof /libtool --mode=execute gprof ./foo
 
-../../../configure --prefix=${curdir} \
+../../../configure --prefix=${curdir}  --enable-websock --enable-alsa \
 CFLAGS="-Wall" \
 CXXFLAGS="-Wall" \
 CPPFLAGS= \

examples/examples.md

@@ -1,6 +1,6 @@
 # __caw__ By Example
 
-__caw__ is a declarative language for describing data flow based
+__caw__ is a configuration language for describing data flow based
 real-time audio signal processing programs. The language
 is based on the __flow__ framework within [libcw](https://gitea.currawongproject.org/cml/libcw).
 
@@ -11,6 +11,8 @@ Features of the language include:
 - Clear and easily interpreted network execution semantics.
 - Automatic user interface generation.
 - Large collection of data flow unit processors.
+- Automatic multi-thread programming support.
+
 
 
 
@@ -78,7 +80,7 @@ The `args:{ ... }` statment lists processor specific arguments used to create th
 `af` instance. In this case `af.fname` names the output file. The use of the
 `$` prefix on the file name indicates that the file should be written to 
 the _project directory_ which is formed by joining `base_dir` with the program name.
-The _project directory_ is automatically created when the program is run.
+The _project directory_ is automatically created, if it doesn't already exist, when the program is run.
 
 
 ### Processor Class Descriptions
@@ -163,8 +165,9 @@ midi     | MIDI message array.
 runtime  | 'no_src' variable whose type is determined by the types of the other variables. See the 'list' processor.
 numeric  | bool | uint | int | float | double
 all      | This variable can be any type. Commonly used for variables which act as triggers. See the 'counter' processor.
+record   | This type is used to form records of fields based on the the above types.
 
-A few type aliases are defined to help document the intended purpose of a given variable.
+A few type aliases are also defined. Thse aliases are intended to help document the intended purpose of a given variable.
 
 Type aliases:
 Alias    | Type   | Description
@@ -182,10 +185,11 @@ an example of a class preset used this way.
 
 ### Example 02: Modulated Sine Signal
 
-This example is an extended version of `ex_01_sine_file` where a low frequency oscillator (LFO)
+This example extends `ex_01_sine_file` by using a low frequency oscillator (LFO) to
+modulate the frequency of a second audio oscillator.  The LFO 
 is formed using a second `sine_tone` processor and a sample and hold unit. The output
-of the sample and hold unit is then used to modulate the frequency of an audio
-frequency `sine_tone` oscillator.
+of the sample and hold unit is then used to set the frequency of the audio
+`sine_tone` oscillator.
 
 Note that the LFO output is a 3 Hertz sine signal
 with a gain of 110 (220 peak-to-peak amplitude) and an offset
@@ -213,10 +217,11 @@ ex_02_mod_sine: {
 
 The `osc` instance in this example uses a `preset` statement. This will have
 the effect of applying the class preset `mono` to the `osc` when it is 
-instantiated. Based on the `sine_tone` class description the `osc` will then
-have a single audio channel with an amplitude of 0.75.
+instantiated. Based on values in the `mono` preset the `osc` will therefore initially have 
+a single audio channel with an amplitude of 0.75.
 
-In this example the sample and hold unit  is necessary to convert the audio signal to a scalar
+In this example the sample and hold unit  is necessary to convert the audio signal, which
+is internally represented as a vector value, to a scalar
 value which is suitable as a `coeff` type value for the `hz` variable of the audio oscillator.
 
 Here is the `sample_hold` class description:
@@ -245,7 +250,7 @@ presets which can set the network, or a given processor, to a particular state.
 audio channels generated by the audio oscillator.  `ex_03_presets` shows
 how presets can be specified and applied for the entire network.
 
-In this example four network presets are specified in the  `presets` statement 
+In this example four network presets are given in the  `presets` statement 
 and the "a" preset is automatically applied once the network is created
 but before it starts to execute.
 
@@ -331,7 +336,7 @@ on either preset then it uses the value from channel 0.
 
 TODO: Check that this accurately describes preset interpolation.
 
-### Example 04 : Event Programming
+### Example 04 : Programming
 
 ```
 ex_04_program: {

src/caw/cawUi.cpp

@@ -63,7 +63,7 @@ namespace caw {
       return rc;
     }
 
-    rc_t _create_bool_widgets( ui_t* p, unsigned widgetListUuId, const flow::ui_var_t* ui_var, unsigned& uuid_ref )
+    rc_t _create_bool_widget( ui_t* p, unsigned widgetListUuId, const flow::ui_var_t* ui_var, unsigned& uuid_ref )
     {
       rc_t rc = kOkRC;
       if((rc = uiCreateCheck(p->ioH, uuid_ref, widgetListUuId, nullptr, kCheckWidgetId, kInvalidId, nullptr, nullptr )) != kOkRC )
@@ -74,6 +74,18 @@ namespace caw {
       return rc;
     }
 
+    rc_t _create_button_widget( ui_t* p, unsigned widgetListUuId, const flow::ui_var_t* ui_var, unsigned& uuid_ref )
+    {
+      rc_t rc = kOkRC;
+      
+      if((rc = uiCreateButton(p->ioH, uuid_ref, widgetListUuId, nullptr, kButtonWidgetId, kInvalidId, nullptr, ui_var->label )) != kOkRC )
+      {
+        rc = cwLogError(rc,"Check box widget create failed on '%s:%i'.",cwStringNullGuard(ui_var->label),ui_var->label_sfx_id);
+      }
+    
+      return rc;
+    }
+    
     rc_t _create_number_widget( ui_t* p, unsigned widgetListUuId, const flow::ui_var_t* ui_var, unsigned appId, unsigned value_type_flag, unsigned& uuid_ref, double min_val, double max_val, double step,  unsigned dec_pl )
     {
       rc_t rc;
@@ -150,8 +162,9 @@ namespace caw {
 
       widget_type_id_ref  = kInvalidId;
       
-      switch( value_type_flag )
+      switch( value_type_flag  )
       {
+        case flow::kAllTFl:    widget_type_id_ref = kButtonWidgetId; break;
         case flow::kBoolTFl:   widget_type_id_ref = kCheckWidgetId;  break;
         case flow::kIntTFl:    widget_type_id_ref = kIntWidgetId;    break;
         case flow::kUIntTFl:   widget_type_id_ref = kUIntWidgetId;   break;
@@ -160,29 +173,12 @@ namespace caw {
         case flow::kStringTFl: widget_type_id_ref = kStringWidgetId; break;          
       }
 
-      // get the proc desc 'vars' dict.
-      if((rc = ui_var->ui_proc->proc->class_desc->cfg->getv_opt("vars",cfg)) != kOkRC )
+      if( ui_var->ui_cfg == nullptr )
       {
-        rc = cwLogError(rc,"Error parsing proc desc. 'vars'.");
+        rc = cwLogError(rc,"Error locating 'var' '%s' on proc desc.",cwStringNullGuard(ui_var->label));
         goto errLabel;
       }
-
-      // locate this 'var' in the var-list
-      if((cfg = cfg->find(ui_var->label)) == nullptr )
-      {
-        rc = cwLogError(rc,"Error locating 'var' '%s' on proc desc.",ui_var->label);
-        goto errLabel;
-      }
-
-      // get the 'ui' record for this var
-      if((rc = cfg->getv_opt("ui",ui_cfg)) != kOkRC )
-      {
-        rc = cwLogError(rc,"Error parsing variable 'ui' cfg.");
-        goto errLabel;
-      }
-
-      // if a 'ui' record was found
-      if( ui_cfg != nullptr )
+      else
       {
         // get the type of this 'ui' widget
         if((rc = ui_cfg->getv("type",widget_type_label)) != kOkRC )
@@ -238,7 +234,11 @@ namespace caw {
       switch( widget_type_id )
       {
         case kCheckWidgetId:
-          rc = _create_bool_widgets(p,widgetListUuId,ui_var,widget_uuId);
+          rc = _create_bool_widget(p,widgetListUuId,ui_var,widget_uuId);
+          break;
+
+        case kButtonWidgetId:
+          rc = _create_button_widget(p,widgetListUuId,ui_var,widget_uuId);
           break;
           
         case kIntWidgetId:
@@ -307,8 +307,14 @@ namespace caw {
 
         // if this is a 'init' variable or connected to a source variable then disable it
         // (The UI should not be able to change the value of a var. that is being set by a source in the network.)
-        if( (ui_var->desc_flags & flow::kInitVarDescFl) || ui_var->has_source_fl)
+        if( (ui_var->desc_flags & flow::kInitVarDescFl) || ui_var->disable_fl)
+        {
           uiClearEnable(p->ioH, widget_uuId );
+        }
+
+        if( ui_var->hide_fl )
+          uiSetVisible(p->ioH, widget_uuId, !ui_var->hide_fl );
+        
 
         if((rc = set_variable_user_id( p->ioFlowH, ui_var, widget_uuId )) != kOkRC )
           goto errLabel;
@@ -330,7 +336,7 @@ namespace caw {
     {
       unsigned n = 0;
       for(unsigned i=0; i<ui_proc->varN; ++i)
-        if( ui_proc->varA[i].ch_cnt != kInvalidCnt && ui_proc->varA[i].ch_cnt > n )
+        if( !(ui_proc->varA[i].desc_flags & flow::kUiCreateVarDescFl) && ui_proc->varA[i].ch_cnt != kInvalidCnt && ui_proc->varA[i].ch_cnt > n )
           n = ui_proc->varA[i].ch_cnt;
 
       return n==0 ? 1 : n;
@@ -385,7 +391,18 @@ namespace caw {
         // for each var
         for(unsigned j=0; j<ui_proc->varN; ++j)
         {
-          const flow::ui_var_t* ui_var = ui_proc->varA + j;
+          flow::ui_var_t* ui_var = ui_proc->varA + j;
+          unsigned var_mult_cnt = var_mult_count( ui_proc->proc, ui_var->label);
+          
+          // if the ui for this var is disabled via the 'no_ui' attribute in the var class description
+          if( ui_var->desc_flags & flow::kUiCreateVarDescFl )
+            continue;
+
+          
+
+          // BUG BUG BUG: these flags should come from the instance not the description
+          ui_var->disable_fl = ui_var->new_disable_fl = cwIsFlag(ui_var->desc_flags, flow::kUiDisableVarDescFl );
+          ui_var->hide_fl    = ui_var->new_hide_fl    = cwIsFlag(ui_var->desc_flags, flow::kUiHideVarDescFl );
 
           // only create controls for certain value types
           if( !(ui_var->value_tid & (flow::kBoolTFl | flow::kIntTFl | flow::kUIntTFl | flow::kFloatTFl | flow::kDoubleTFl | flow::kStringTFl )))
@@ -396,7 +413,10 @@ namespace caw {
           {
             if( ui_var->ch_idx == flow::kAnyChIdx )
             {
-              snprintf(label_buf,label_buf_charN,"%s:%i",ui_var->label,ui_var->label_sfx_id);
+              if( var_mult_cnt == 1 )
+                snprintf(label_buf,label_buf_charN,"%s",ui_var->label);
+              else
+                snprintf(label_buf,label_buf_charN,"%s:%i",ui_var->label,ui_var->label_sfx_id);
               if((rc = _create_var_label(p,varListUuId, ui_var, label_buf, j)) != kOkRC )
               {
                 goto errLabel;
@@ -454,6 +474,9 @@ namespace caw {
       unsigned       chanListUuId    = kInvalidId;
       const unsigned label_buf_charN = 127;
       char           label_buf[ label_buf_charN+1 ];
+
+      if( !p->ui_net->ui_create_fl && !(ui_proc->proc->flags & flow::kUiCreateProcFl) )
+        goto errLabel;
       
       if((rc = uiCreateFromRsrc(   p->ioH, "proc", parentListUuId, proc_idx )) != kOkRC )
       {
@@ -466,7 +489,7 @@ namespace caw {
       //printf("proc_idx: %i %i %i : %i %i\n",proc_idx, parentListUuId, procPanelUuId,chanPanelUuId,chanListUuId);
 
       // set the proc title
-      snprintf(label_buf,label_buf_charN,"%s:%i",ui_proc->label,ui_proc->label_sfx_id);      
+      snprintf(label_buf,label_buf_charN,"%s %s:%i",ui_proc->desc->label,ui_proc->label,ui_proc->label_sfx_id);      
       uiSendValue( p->ioH, uiFindElementUuId(p->ioH, procPanelUuId, kProcInstLabelId, kInvalidId), label_buf );
 
       //if((rc = _load_proc_presets(p,ui_proc,procPanelUuId)) != kOkRC )

src/caw/cawUiDecl.h

@@ -16,6 +16,7 @@ namespace caw {
       kPgmSelId,
       kPgmPresetSelId,
       kPgmLoadBtnId,
+      kPgmPrintBtnId,
       kRunCheckId,
     
       kRootNetPanelId,
@@ -37,6 +38,7 @@ namespace caw {
       kVarPanelId,
       kWidgetListId,
 
+      kButtonWidgetId,
       kCheckWidgetId,
       kIntWidgetId,
       kUIntWidgetId,

src/caw/cfg/io.cfg

@@ -14,7 +14,7 @@
                   xmtBufByteN: 2048,
                   fmtBufByteN: 4096,
                   //websockTimeOutMs: 25, // max time out while blocking for a websock event
-		  queueBlkCnt: 8,         // Initial count of websocket queue memory blocks See:cwNbMpScQueue.h
+		  queueBlkCnt: 64,         // Initial count of websocket queue memory blocks See:cwNbMpScQueue.h
 		  queueBlkByteCnt: 32768, // Size of each websocket queue memory block
 		  idleMsgPeriodMs: 50,    // period without messages before an idle message is generated
 		  extraLogsFl:false,      // enable the websock LLL_NOTICE logs        
@@ -83,11 +83,12 @@
                   {
 		    // System device name
 
-		    device: "sof-hda-dsp"
+		    //device: "sof-hda-dsp"
 		    //device: "HDA Intel PCH ALC1220 Analog"
-		    //device:       "Scarlett 18i20 USB USB Audio",
+		    device:       "Scarlett 18i20 USB USB Audio",
 		    //device:       "USB Audio CODEC USB Audio",
 		    //device:       "HDA Intel PCH CS4208 Analog",
+		    //device:       "MBox USB Audio",
 		    
                     activeFl:       true,   // (req)
 		    meterFl:        true,   // (opt)

src/caw/html/css/caw.css

@@ -33,8 +33,12 @@
 .varList {
      display: flex;
      flex-direction: column;
-     overflow-y: hidden;
-     
+     overflow-y: hidden;          
+}
+
+.varList > div {
+    padding-top: 3px;
+	    
 }
 
 .varPanel {

src/caw/html/css/ui.css

@@ -15,32 +15,25 @@ body {
 input, label, button, select {
     font-family: sans-serif;
     font-size: 10px;
-    height: 20px;
 }
 
 
 div {
-    /*border: 1px solid black;    */
     background-color: LightSteelBlue;
 }
 
 div p {
     font-family: sans-serif;
     font-size: 12px;
-    margin-top: 2px;
-    margin-bottom: 2px;
     background-color: LightSteelBlue;
 }
 
 label {
-    /*border: 1px solid red;*/
     width: 50px;
     padding-left: 10px;
-    margin-top: 3px;
+    height: 20px;
 }
 
-
-
 .uiCtlDiv {
     display: flex;
     flex-direction: row;
@@ -56,6 +49,12 @@ label {
     width: 50px;
 }
 
+.uiCheckDiv  input {
+}
+
+.uiStringDiv  input {
+}
+
 .uiPanel {
     background-color: LightBlue;
 }

src/caw/html/index.html

@@ -2,7 +2,7 @@
 <html>
   <head>
     <meta charset="utf-8">
-    <title>Preset Selection App</title>
+    <title>CAW</title>
     <script type="text/javascript" src="js/ui.js"></script>
     <link href="css/ui.css" rel="stylesheet">
     <link href="css/caw.css" rel="stylesheet">

src/caw/html/js/ui.js

@@ -382,7 +382,7 @@ function ui_create_select( parent_ele, d )
 {
     var ele = ui_create_ctl( parent_ele, "select", d.title, d, "uiSelect" );
     ele.onchange = function() { ui_on_select(this) }
-    ele.onclick  = function() { ui_on_select(this) }
+    //ele.onclick  = function() { ui_on_select(this) }
     
     if( !d.hasOwnProperty('value') )
     {

src/caw/html/ui.cfg

@@ -17,6 +17,7 @@
 		select:{ name: pgmSelId,        title:"Programs", children: {} },
 		select:{ name: pgmPresetSelId,  title:"Presets",  children: {}, enable:false },
 		button:{ name: pgmLoadBtnId,    title:"Load", enable:false },
+		button:{ name: pgmPrintBtnId,   title:"Print", enable:false },
 		check: { name: runCheckId,     title: "Run", enable:false },
 
 	    },

src/caw/main.cpp

@@ -74,6 +74,7 @@ ui::appIdMap_t  appIdMapA[] = {
   { kPanelDivId,     kPgmSelId,       "pgmSelId" },
   { kPanelDivId,     kPgmPresetSelId, "pgmPresetSelId" },
   { kPanelDivId,     kPgmLoadBtnId,   "pgmLoadBtnId" },
+  { kPanelDivId,     kPgmPrintBtnId,  "pgmPrintBtnId" },
   { kPanelDivId,     kRunCheckId,     "runCheckId" },
 
   { kPanelDivId,     kRootNetPanelId, "rootNetPanelId" },
@@ -168,6 +169,8 @@ rc_t _on_pgm_select(app_t* app, unsigned pgmSelOptId )
   unsigned pgm_idx          = kInvalidIdx;
   unsigned pgmPresetSelUuId = io::uiFindElementUuId( app->ioH, kPgmPresetSelId );
   unsigned pgmLoadBtnUuId   = io::uiFindElementUuId( app->ioH, kPgmLoadBtnId );
+  unsigned pgmPrintBtnUuId  = io::uiFindElementUuId( app->ioH, kPgmPrintBtnId );
+  unsigned runCheckUuId     = io::uiFindElementUuId( app->ioH, kRunCheckId );
   unsigned preset_cnt       = 0;
 
   if( !(kPgmBaseSelId <= pgmSelOptId && pgmSelOptId <= kPgmMaxSelId ) )
@@ -185,6 +188,8 @@ rc_t _on_pgm_select(app_t* app, unsigned pgmSelOptId )
 
   uiSetEnable( app->ioH, pgmPresetSelUuId, false );  // Disable the preset menu and load btn in anticipation of error.
   uiSetEnable( app->ioH, pgmLoadBtnUuId,   false );  //
+  uiSetEnable( app->ioH, pgmPrintBtnUuId,  false );  //
+  uiSetEnable( app->ioH, runCheckUuId,     false );  //
   app->pgm_preset_idx = kInvalidIdx;                 // The preset menu is empty and so there can be no valid preset selected.
   pgm_idx             = pgmSelOptId - kPgmBaseSelId; // Calc the ioFlowCtl preset index of the selected preset.
 
@@ -232,6 +237,13 @@ rc_t _on_pgm_preset_select( app_t* app, unsigned pgmPresetSelOptId )
 
   app->pgm_preset_idx = pgmPresetSelOptId - kPgmPresetBaseSelId;
 
+  if( program_is_initialized(app->ioFlowH) )
+    if((rc = program_apply_preset( app->ioFlowH, app->pgm_preset_idx )) == kOkRC )
+    {
+      // if the app isn't running then update the UI manually
+      if( !app->run_fl )
+        rc = send_ui_updates(app->ioFlowH);
+    }
 
 errLabel:
 
@@ -265,6 +277,7 @@ rc_t _on_pgm_load(app_t* app )
     }
 
     uiSetEnable(app->ioH, io::uiFindElementUuId( app->ioH, kRunCheckId ), true );
+    uiSetEnable(app->ioH, io::uiFindElementUuId( app->ioH, kPgmPrintBtnId ), true );
 
   }
   
@@ -273,12 +286,27 @@ errLabel:
   return rc;
 }
 
+rc_t _on_pgm_print( app_t* app )
+{
+  rc_t rc = kOkRC;
+  if( app->ioFlowH.isValid() )
+    print_network(app->ioFlowH);
+  
+  return rc;
+}
+
 rc_t _on_pgm_run( app_t* app, bool run_check_fl )
 {
   rc_t rc = kOkRC;
 
   app->run_fl = run_check_fl;
 
+  if( !run_check_fl )
+  {
+    midiDeviceAllNotesOff( app->ioH );
+
+  }
+
   return rc;
 }
 
@@ -327,6 +355,13 @@ rc_t _on_variable_value( app_t* app, const io::ui_msg_t& m, T value )
     rc = cwLogError(rc,"Unable to access variable value.");
     goto errLabel;
   }
+
+  // setting the variable value may have resulted flow -> ui messages
+  // having been queued - if the program isn't running these will
+  // have to be manually triggered
+  if( !app->run_fl )
+    rc = send_ui_updates(app->ioFlowH);
+
   
 errLabel:
   if( rc != kOkRC )
@@ -373,12 +408,20 @@ rc_t _ui_value_callback(app_t* app, const io::ui_msg_t& m )
     case kPgmLoadBtnId:
       _on_pgm_load(app);
       break;
+
+    case kPgmPrintBtnId:
+      _on_pgm_print(app);
+      break;
       
     case kRunCheckId:
       io::uiSetTitle(app->ioH,m.uuId,m.value->u.b ? "Off" : "On" );
       _on_pgm_run(app,m.value->u.b);
       break;
 
+    case kButtonWidgetId:
+      _on_variable_value(app,m,m.value->u.b);
+      break;
+      
     case kCheckWidgetId:
       rc = _on_variable_value(app,m,m.value->u.b);
       break;
@@ -727,8 +770,9 @@ void _test_stub( app_t& app )
 int main( int argc, char* argv[] )
 {
   rc_t  rc  = kOkRC;
-  app_t app = { .pgm_preset_idx=kInvalidIdx }; // all zero except ...
   bool exec_complete_fl = false;
+  app_t app = {}; // all zero
+  app.pgm_preset_idx = kInvalidIdx;
   
   cw::log::createGlobal();
 

src/caw/perf/perf_caw.cfg

@@ -0,0 +1,402 @@
+{
+  base_dir:    "~/src/caw/src/caw/perf/io",
+  io_dict:     "~/src/caw/src/caw/cfg/io.cfg"            // Runtime configuration file.
+  proc_dict:   "~/src/caw/src/libcw/flow/proc_dict.cfg", // Processor class definition file.
+  udp_dict:    "~/src/caw/src/libcw/flow/udp_dict.cfg",  // User defined proc files 
+    
+  programs: {
+
+
+   ex_00_mod_sine: {
+
+      dur_limit_secs:30.0,  // Run the network for 5 seconds
+      non_real_time_fl: true,
+      
+      network: {
+
+        procs: {
+          lfo:   { class: sine_tone, args:{ hz:3, dc:440, gain:110 }}
+          sh:    { class: sample_hold,            in:{ in:lfo.out } }
+          osc:   { class: sine_tone, preset:mono, in:{ hz:sh.out } },
+	  aout:  { class:audio_out, in:{ in:osc.out }, args:{ dev_label:"main"} }
+	  //af:  { class: audio_file_out, in: { in:osc.out } args:{  fname:"$/out.wav"} }
+        }
+      }
+    }
+
+    ex_01_score_player: {
+
+      network: {
+      
+        procs: {
+	  player: { class:score_player, args:{ fname:"$/score_20240504.csv" }},
+	  samp_vt:{ class: vel_table,  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"ivory" }},
+	  
+	  stop: { class: halt,     in:{ in:player.done_fl }}		       
+          vctl: { class: poly_voice_ctl, in:{ in:samp_vt.out }, args:{ voice_cnt:20  } },
+
+	  voice_poly: {
+	    class: poly,
+	    args: { count:20, parallel_fl:false }
+
+	    network: {
+	      procs: {
+	        voc: { class:piano_voice, in:{ _.in:_.vctl.out_ },
+		                          out:{ _.done_fl:_.vctl.done_fl_ },
+					  args:{ wtb_fname:"~/temp/wt6/wt_bank.json", wtb_instr:"piano" } },
+		//voc: { class:midi_voice, in:{_.in:_.vctl.out_ }, out:{ _.done_fl:_.vctl.done_fl_ }, args:{chCnt:2, gain:0.2 } },
+	      }
+	    }
+	  }
+
+	  amix: { class: audio_mix,   in:{ in_:voice_poly.voc_.out }     args:{ igain_:1.0 }},
+	  aout: { class: audio_out,   in:{ in:amix.out }, args:{ dev_label:"main"}}
+	  
+        }
+      }
+    }
+
+
+    ex_01a_score_player: {
+
+      network: {
+      
+        procs: {
+	  player: { class:score_player, args:{ fname:"$/score_20240504.csv" }},
+	  samp_vt:{ class: vel_table,  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"ivory" }},
+	  
+	  stop: { class: halt,     in:{ in:player.done_fl }}		       
+          vctl: { class: poly_voice_ctl, in:{ in:samp_vt.out }, args:{ voice_cnt:20  } },
+
+	  voice_poly: {
+	    class: poly,
+	    args: { count:20, parallel_fl:false }
+
+	    network: {
+	      procs: {
+		voc: { class:midi_voice, in:{_.in:_.vctl.out_ }, out:{ _.done_fl:_.vctl.done_fl_ }, args:{chCnt:2, gain:0.2 } },
+	      }
+	    }
+	  }
+
+
+	  xf_ctl: { class:poly_xform_ctl, in:{ in_:voice_poly.voc_.out,
+	                                       midi_:vctl.out_,
+					       donefl_:voice_poly.voc_.done_fl  }, args:{ out_ch_cnt:5 } }
+					       
+	  amix: { class: audio_mix,   in:{ in_:xf_ctl.out_ }     args:{ igain_:1.0 }},
+	  //amix: { class: audio_mix,   in:{ in_:voice_poly.voc_.out }     args:{ igain_:1.0 }},
+
+	  aout: { class: audio_out,   in:{ in:amix.out }, args:{ dev_label:"main"}}
+	  
+        }
+      }
+    }
+
+    ex_02_score_player: {
+
+      ui_create_fl: true,
+      
+      network: {
+      
+        procs: {
+	  //xform_igain:  { class: number,   args:{ in:1.0f }},
+	  player: { class:score_player, args:{ fname:"$/score_20240504.csv" }},
+
+	  pian_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"spirio" }},
+	  samp_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"ivory" }},
+
+
+	  stop:   { class: halt,                       in:{ in:player.done_fl }}
+	  
+	  //mout:   { class: midi_out,                   in:{ rin:pian_vt.out }, args:{ print_fl:false, dev_label:"Fastlane", port_label:"Fastlane MIDI A" } } 
+          vctl:   { class: poly_voice_ctl,             in:{ in:samp_vt.out },  args:{ voice_cnt:30  } },
+	  ps:     { class: preset_select, preset:init, in:{ in:player.out },  args:{ fname:"$/m1_458_trans_5.txt" } }
+	  
+	  voice_poly: {
+	    class: poly,
+	    in:   { count:vctl.voice_cnt }
+	    args: { parallel_fl:false }
+
+	    network: {
+	      procs: {
+	        voc: { class:piano_voice, in:{ _.in:_.vctl.out_ },
+		                          out:{ _.done_fl:_.vctl.done_fl_ },
+					  args:{ wtb_fname:"~/temp/wt6/wt_bank.json", wtb_instr:"piano" } },
+	      
+	        //voc: { class:midi_voice, in:{ _.in:_.vctl.out_ }, out:{ _.done_fl:_.vctl.done_fl_ }, args:{print_fl:false, chCnt:2, gain:0.2 } },
+	      }
+	    }
+	  }
+
+	  xf_ctl: { class:poly_xform_ctl, in:{ in_:voice_poly.voc_.out,
+	                                       midi_:vctl.out_,
+					       donefl_:voice_poly.voc_.done_fl,
+					       trig:ps.preset_label  }, args:{ out_ch_cnt:10 } } 
+
+	  xf_poly : {
+	    class: poly,
+	    
+	    in: { count:xf_ctl.out_ch_cnt,
+	          preset_sfx_id:xf_ctl.out_ch_idx,
+		  preset_label:ps.preset_label },
+	    
+	    args: { parallel_fl:true }
+	    
+	    network: {
+	      procs: {
+	        //igain: { class: audio_gain,       in:{ in:_.xf_ctl.out, gain:_.xform_igain.out }, },
+	        pva:   { class: pv_analysis,      in:{ in:_.xf_ctl.out },  args:{ wndSmpN:512, hopSmpN:128, hzFl:false  } },	       
+	        sd:    { class: spec_dist,        in:{ in:pva.out },  preset:kc, args:{ bypass:false }   },	       
+                pvs:   { class: pv_synthesis,     in:{ in:sd.out  }              },
+	        cmp:   { class: compressor,       in:{ in:pvs.out },  preset:kc, args:{ bypass:false }   },
+		ogain: { class: audio_gain,       in:{ in:cmp.out } },
+	      },
+	      
+	      presets: {
+	        dry:   { pva:dry,   sd:dry,   cmp:dry,   ogain:{ gain:0.0 } },
+	        a:     { pva:a,     sd:a,     cmp:a,     ogain:{ gain:1.0 } },
+	        b:     { pva:b,     sd:b,     cmp:b,     ogain:{ gain:1.0 } },
+	        c:     { pva:c,     sd:c,     cmp:c,     ogain:{ gain:1.0 } },
+	        d:     { pva:d,     sd:d,     cmp:d,     ogain:{ gain:1.0 } },
+	        f1:    { pva:f_1,   sd:f_1,   cmp:f_1,   ogain:{ gain:1.0 } },
+	        f2:    { pva:f_2,   sd:f_2,   cmp:f_2,   ogain:{ gain:1.0 } },
+	        f3:    { pva:f_3,   sd:f_3,   cmp:f_3,   ogain:{ gain:1.0 } },
+	        f4:    { pva:f_4,   sd:f_4,   cmp:f_4,   ogain:{ gain:1.0 } },
+	        g:     { pva:g,     sd:g,     cmp:g,     ogain:{ gain:1.0 } },
+	        ga:    { pva:g_a    sd:g_a,   cmp:g_a,   ogain:{ gain:1.0 } },
+	        g1a:   { pva:g_1_a  sd:g_1_a, cmp:g_1_a, ogain:{ gain:1.0 } },
+	        g1d:   { pva:g_1_d  sd:g_1_d, cmp:g_1_d, ogain:{ gain:1.0 } }
+	      }
+	    }
+	  }
+	  
+	  wet_poly_mix: { class: audio_mix,   in:{ in_:xf_poly.ogain_.out } args:{ igain_:1.0 }},
+	  dry_poly_mix: { class: audio_mix,   in:{ in_:voice_poly.voc_.out} args:{ igain_:1.0 }},
+	  
+	  //amix: { class: audio_mix,   in:{ in_:xf_ctl.out_ } args:{ igain_:1.0 }},
+	  //aout: { class: audio_out,   in:{ in:amix.out }, args:{ dev_label:"main"}}
+
+	  // apply the wet/dry gain balance
+	  wd_bal:       { class: balance, args{}},
+	  wet_bal_gain: { class: audio_gain, in:{ in:wet_poly_mix.out, gain:wd_bal.out }     },
+	  dry_bal_gain: { class: audio_gain, in:{ in:dry_poly_mix.out, gain:wd_bal.inv_out } },
+
+	  mstr_wet_out: { class: audio_gain, in:{ in:wet_bal_gain.out }, args:{ gain:0.5 } }
+	  mstr_dry_out: { class: audio_gain, in:{ in:dry_bal_gain.out }, args:{ gain:0.5 } },
+
+
+	  // merge the wet/dry signals into a single 4 channel signal
+	  merge: { class: audio_merge,   in:{ in0:mstr_wet_out.out, in1:mstr_dry_out.out }  },
+
+	  // delay the incoming signal to sync it with the piano
+	  sync_delay { class: audio_delay, in: { in:merge.out }, args:{ delayMs:400 }}
+
+          aout:  { class: audio_out,     in:{ in:sync_delay.out }, args:{ dev_label:"main" } },
+
+	  //sel_two: { class: audio_split, in:{ in:sync_delay.out } args:{ select[0,0,1,1]} } 
+	  //aout:  { class: audio_out,     in:{ in:sel_two.out0 }, args:{ dev_label:"main" } },
+
+	  
+        }
+      }
+    }
+
+
+   ex_03_preset_test: {
+
+      network: {
+
+        procs: {
+          lfo:   { class: sine_tone, args:{ hz:3, dc:440, gain:110 }}
+          sh:    { class: sample_hold,            in:{ in:lfo.out } }
+          osc:   { class: sine_tone,              in:{ hz:sh.out }, args:{ ch_cnt:2 } },
+	  gain:  { class: audio_gain, in:{ in:osc.out }, args:{ gain:0.3 } }
+	  aout:  { class: audio_out, in:{ in:gain.out }, args:{ dev_label:"main"} }
+        }
+	
+	presets:
+	{
+	  a: { gain:{ gain:0.2 } },
+	  b: { gain:{ gain:[0.1,0.3] } }
+	}
+
+      }
+    }
+  
+    ex_04_score_player: {
+    
+      ui_create_fl: true,
+      
+      dur_limit_secs:10.0,  // Run the network for 5 seconds
+      non_real_time_fl: true,
+
+      network: {
+      
+        procs: {
+	  player: { class:score_player, args:{ fname:"$/score_20240504.csv" }},
+
+	  pian_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"spirio" }},
+	  samp_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"ivory" }},
+	  
+	  stop:   { class: halt,                       in:{ in:player.done_fl }}
+
+          vctl:   { class: poly_voice_ctl,             in:{ in:samp_vt.out },  args:{ voice_cnt:25  } },
+	  ps:     { class: preset_select, preset:init, in:{ in:player.out },  args:{ fname:"$/m1_458_trans_5.txt" } }
+	  
+	  voice_poly: {
+	    class: poly,
+	    in:   {
+	            count:vctl.voice_cnt,
+		  }
+		  
+	    args: { parallel_fl:false }
+
+	    network: {
+	      procs: {
+	        voc: { class:piano_voice, in:{ _.in:_.vctl.out_ },
+		                          out:{ _.done_fl:_.vctl.done_fl_ },
+					  args:{ wtb_fname:"~/temp/wt6/wt_bank.json", wtb_instr:"piano" } },
+					  
+	        pva:   { class: pv_analysis,      in:{ in:voc.out },  args:{ wndSmpN:512, hopSmpN:128, hzFl:false  } },	       
+	        sd:    { class: spec_dist,        in:{ in:pva.out },  preset:kc, args:{ bypass:false }   },	       
+                pvs:   { class: pv_synthesis,     in:{ in:sd.out  }              },
+	        cmp:   { class: compressor,       in:{ in:pvs.out },  preset:kc, args:{ bypass:false }   },
+		ogain: { class: audio_gain,       in:{ in:cmp.out } },
+	      }
+
+	      presets: {
+	        dry:   { pva:dry,   sd:dry,   cmp:dry,   ogain:{ gain:0.0 } },
+	        a:     { pva:a,     sd:a,     cmp:a,     ogain:{ gain:1.0 } },
+	        b:     { pva:b,     sd:b,     cmp:b,     ogain:{ gain:1.0 } },
+	        c:     { pva:c,     sd:c,     cmp:c,     ogain:{ gain:1.0 } },
+	        d:     { pva:d,     sd:d,     cmp:d,     ogain:{ gain:1.0 } },
+	        f1:    { pva:f_1,   sd:f_1,   cmp:f_1,   ogain:{ gain:1.0 } },
+	        f2:    { pva:f_2,   sd:f_2,   cmp:f_2,   ogain:{ gain:1.0 } },
+	        f3:    { pva:f_3,   sd:f_3,   cmp:f_3,   ogain:{ gain:1.0 } },
+	        f4:    { pva:f_4,   sd:f_4,   cmp:f_4,   ogain:{ gain:1.0 } },
+	        g:     { pva:g,     sd:g,     cmp:g,     ogain:{ gain:1.0 } },
+	        ga:    { pva:g_a    sd:g_a,   cmp:g_a,   ogain:{ gain:1.0 } },
+	        g1a:   { pva:g_1_a  sd:g_1_a, cmp:g_1_a, ogain:{ gain:1.0 } },
+	        g1d:   { pva:g_1_d  sd:g_1_d, cmp:g_1_d, ogain:{ gain:1.0 } }
+	      }
+
+	    }
+	  }
+
+	  wet_poly_mix: { class: audio_mix,   in:{ in_:voice_poly.ogain_.out } args:{ igain_:1.0 }},
+	  dry_poly_mix: { class: audio_mix,   in:{ in_:voice_poly.voc_.out}    args:{ igain_:1.0 }},
+	  
+	  // apply the wet/dry gain balance
+	  wd_bal:       { class: balance, args{}},
+	  wet_bal_gain: { class: audio_gain, in:{ in:wet_poly_mix.out, gain:wd_bal.out }     },
+	  dry_bal_gain: { class: audio_gain, in:{ in:dry_poly_mix.out, gain:wd_bal.inv_out } },
+
+	  mstr_wet_out: { class: audio_gain, in:{ in:wet_bal_gain.out }, args:{ gain:0.5 } }
+	  mstr_dry_out: { class: audio_gain, in:{ in:dry_bal_gain.out }, args:{ gain:0.5 } },
+
+
+	  // merge the wet/dry signals into a single 4 channel signal
+	  merge: { class: audio_merge,   in:{ in0:mstr_wet_out.out, in1:mstr_dry_out.out }  },
+
+	  // delay the incoming signal to sync it with the piano
+	  sync_delay { class: audio_delay, in: { in:merge.out }, args:{ delayMs:400 }}
+
+          //aout:  { class: audio_out,     in:{ in:sync_delay.out }, args:{ dev_label:"main" } },
+
+	  sel_two: { class: audio_split, in:{ in:sync_delay.out } args:{ select[0,0,1,1]} } 
+	  //aout:  { class: audio_out,     in:{ in:sel_two.out0 }, args:{ dev_label:"main" } },
+	  af:  { class: audio_file_out, in: { in:sel_two.out0 }, args:{  fname:"$/out.wav"} }
+	  
+        }
+      }
+    }
+
+    ex_05_score_player: {
+    
+      ui_create_fl: false,
+      //dur_limit_secs:60.0,
+      //non_real_time_fl: true,
+      
+      network: {
+      
+        procs: {
+	  player: { class:score_player, args:{ fname:"$/score_20240504.csv" }, ui: { create_fl:true } },
+
+	  pian_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"spirio_1" }},
+	  samp_vt:{ class: vel_table,                  in:{ in:player.out }, args:{ vel_tbl_fname:"$/vel_table_perf.json", vel_tbl_label:"ivory" }},
+	  
+	  //stop:   { class: halt,                       in:{ in:player.done_fl }}
+
+	  //mout:   { class: midi_out,                   in:{ rin:pian_vt.out }, args:{ print_fl:false, dev_label:"Fastlane", port_label:"Fastlane MIDI A" } } 
+	  //mout:   { class: midi_out,                   in:{ rin:pian_vt.out }, args:{ print_fl:false, dev_label:"iRig MIDI 2", port_label:"iRig MIDI 2 MIDI 1" } } 
+
+          vctl:   { class: poly_voice_ctl,             in:{ in:samp_vt.out },  args:{ voice_cnt:25  } },
+	  ps:     { class: gutim_ps, preset:init,      in:{ in:player.out, midi_in_:vctl.out_, reset:player.start   },
+	                                               args:{ fname:"$/m1_458_trans_5.txt" },
+						       ui:  { create_fl:true } }
+	  
+	  voice_poly: {
+	    class: poly,
+	    in:   {
+	            count:vctl.voice_cnt,
+		  }
+		  
+	    args: { parallel_fl:true }
+
+	    network: {
+	      procs: {
+	        voc: { class:piano_voice, in:{ _.in:_.vctl.out_ },
+		                          out:{ _.done_fl:_.vctl.done_fl_ },
+					  args:{ wtb_fname:"~/temp/wt6/wt_bank.json", wtb_instr:"piano" } },
+	        pva:   { class: pv_analysis,      in:{ in:voc.out, _.wndSmpN:_.ps.wnd_smp_cnt_ },  args:{ wndSmpN:512, hopSmpN:128, hzFl:false  } },
+	        sd:    { class: spec_dist,        in:{ in:pva.out,
+		                                       _.ceiling:_.ps.ceiling_,
+						       _.expo:_.ps.expo_,
+						       _.thresh:_.ps.thresh_,
+						       _.upr:_.ps.upr_,
+						       _.lwr:_.ps.lwr_,
+						       _.mix:_.ps.mix_ },  preset:kc, args:{ bypass:false }   },
+		
+                pvs:   { class: pv_synthesis,     in:{ in:sd.out  }              },
+	        cmp:   { class: compressor,       in:{ in:pvs.out,
+		                                       _.igain:_.ps.c_igain_,
+						       _.ogain:_.ps.c_ogain_ }, preset:kc, args:{ bypass:false }   },
+						       
+		ogain: { class: audio_gain,       in:{ in:cmp.out, _.gain:_.ps.dry_gain_ } },
+	      }
+
+	    }
+	  }
+
+	  wet_poly_mix: { class: audio_mix,   in:{ in_:voice_poly.ogain_.out } args:{ igain_:1.0 }},
+	  dry_poly_mix: { class: audio_mix,   in:{ in_:voice_poly.voc_.out}    args:{ igain_:1.0 }},
+	  
+	  // apply the wet/dry gain balance
+	  wd_bal:       { class: balance, args{}},
+	  wet_bal_gain: { class: audio_gain, in:{ in:wet_poly_mix.out, gain:wd_bal.out }     },
+	  dry_bal_gain: { class: audio_gain, in:{ in:dry_poly_mix.out, gain:wd_bal.inv_out } },
+
+	  mstr_wet_out: { class: audio_gain, in:{ in:wet_bal_gain.out }, args:{ gain:0.5 } }
+	  mstr_dry_out: { class: audio_gain, in:{ in:dry_bal_gain.out }, args:{ gain:0.5 } },
+
+
+	  // merge the wet/dry signals into a single 4 channel signal
+	  merge: { class: audio_merge,   in:{ in0:mstr_wet_out.out, in1:mstr_dry_out.out }  },
+
+	  // delay the incoming signal to sync it with the piano
+	  sync_delay { class: audio_delay, in: { in:merge.out }, args:{ delayMs:400 }}
+
+          aout:  { class: audio_out,     in:{ in:sync_delay.out }, args:{ dev_label:"main" } },
+
+	  //sel_two: { class: audio_split, in:{ in:sync_delay.out } args:{ select[0,0,1,1]} } 
+	  //aout:  { class: audio_out,     in:{ in:sel_two.out0 }, args:{ dev_label:"main" } },
+	  //af:  { class: audio_file_out, in: { in:sync_delay.out }, args:{  fname:"$/out.wav"} }
+
+	  
+        }
+      }
+    }
+
+
+}

src/caw/preset/preset_caw.cfg

@@ -0,0 +1,196 @@
+
+{
+  base_dir:    "~/src/caw/src/caw/perf/io",
+  io_dict:     "~/src/caw/src/caw/cfg/io.cfg"            // Runtime configuration file.
+  proc_dict:   "~/src/caw/src/libcw/flow/proc_dict.cfg", // Processor class definition file.
+  udp_dict:    "~/src/caw/src/libcw/flow/udp_dict.cfg",  // User defined proc files 
+    
+  programs: {
+
+    example_00:
+    {
+
+      network: {
+
+        procs: {
+          lfo:   { class: sine_tone, args:{ hz:3, dc:440, gain:110 }
+	   presets: {
+	    a:{ hz:2 },
+	    b:{ hz:3 },
+	    c:{ hz:4 },
+	    d:{ hz:5 }
+	   }
+	  },
+	  
+          sh:    { class: sample_hold, in:{ in:lfo.out } }
+          osc:   { class: sine_tone,   in:{ hz:sh.out },   args:{ ch_cnt:2 } },
+          gain:  { class: audio_gain,  in:{ in:osc.out },  args:{ gain:0.3 } },
+          aout:  { class: audio_out,   in:{ in:gain.out }, args:{ dev_label:"main"} }
+        }
+	
+        presets:
+        {
+           a: { lfo:a, gain:{ gain:0.2 } },        //  One value sets both channels.
+           b: { lfo:b, gain:{ gain:[0.1,0.3] } },  //  Multi-channel preset.
+           c: { lfo:c, gain:mute_on  },            //  Apply a class preset
+           d: { lfo:d, gain:mute_off  },           //  Apply a class preset with an ignored 'init' variable.
+        }
+      }
+    }
+
+    example_01:
+    {
+
+      network: {
+
+        procs: {
+          osc:    { class: sine_tone, args: { ch_cnt:6, hz:[110,220,440,880,1760, 3520] }},
+          split:  { class: audio_split, in:{ in:osc.out }, args: { select:[ 0,0, 1,1, 2,2 ] } },
+
+          // Create three gain controls: g:0,g:1,g:2 using the processor label numeric suffix syntax.
+          g0: { class:audio_gain, in:{ in:split0.out0 }, args:{ gain:0.9} },
+          g1: { class:audio_gain, in:{ in:split0.out1 }, args:{ gain:0.5} },
+          g2: { class:audio_gain, in:{ in:split0.out2 }, args:{ gain:0.2} },
+                  
+          merge: { class: audio_merge, in:{ in_:g_.out } },
+          out:   { class: audio_out, in:{ in:merge.out },  args:{ dev_label:"main" }}
+        }
+	
+        presets:
+        {
+          a: { g_:   { gain:0.1 } }, // Use underscore notation to apply a preset value to g0,g1,g2.
+          b: { g0_2: { gain:0.2 } }, // Use underscore notation to apply a preset value to g0 and g1.
+          c: { g2:   { gain:0.3 } }, // Apply a preset value to g2 only.
+        }
+      }
+    }
+
+
+    example_02:
+    {
+
+      network: {
+
+        procs: {
+
+          // LFO gain parameters - one per poly voice
+          g_list:  { class: list, args: { in:0, list:[ 110f,220f,440f ]}},
+
+          // LFO DC offset parameters - one per poly voice
+          dc_list: { class: list, args: { in:0, list:[ 220f,440f,880f ]}},
+          
+          osc_poly: {
+            class: poly,
+            args: { count:3 },  // Create 3 instances of 'network'.
+           
+            network: {
+              procs: {
+                lfo:  { class: sine_tone,   in:{ _.dc:_.dc_list.value_, _.gain:_.g_list.value_ }  args: { ch_cnt:1, hz:3 }},
+                sh:   { class: sample_hold, in:{ in:lfo.out }},
+                osc:  { class: sine_tone,   in:{ hz: sh.out }},
+             },
+	 
+	     presets:
+	     {
+	       aa:{ osc:{ gain:0.3 }, lfo:lfo1 }, 
+	       bb:{ osc:{ gain:0.4 }, lfo:lfo2 },
+	       cc:{ osc2:{ gain:0.1 }, osc0_2: { gain:0.2 }, lfo:lfo3 },
+	       dd:{ osc0_2: { gain:0.5 } }
+	     }
+           }               
+         }
+
+         // Iterate over the instances of `osc_poly.osc_.out` to create one `audio_merge`
+         // input for every output from the polyphonic network.
+         merge: { class: audio_merge,    in:{ in_:osc_poly.osc_.out}, args:{ gain:1, out_gain:0.5 }},
+         aout:  { class: audio_out,      in:{ in:merge.out }          args:{ dev_label:"main"} }
+
+	}
+	
+	presets: {
+          a:{ osc_poly:aa, merge:{ out_gain:0.3 } },
+          b:{ osc_poly:bb, merge:{ out_gain:0.2 } },
+          c:{ osc_poly:cc, merge:{ out_gain:0.1 } },
+	  d:{ osc_poly:dd }
+	}
+      }
+    }   
+
+    example_03:
+    {
+      network: {
+
+        procs: {
+
+          osc_poly: {
+            class: poly,
+	    
+	    // For het-poly networks the 'count' value given
+	    // in the top level proc is the default value for
+	    // the poly-count for following networks.
+	    // This value may be overriden in the network
+	    // definition itself - as it is in this example.
+            args: { count:2, parallel_fl:true }, 
+           
+            network: {
+	      net_a: {
+	        count: 4,  // override higher level 'count'
+		
+                procs: {
+                  osc:  { class: sine_tone,   args:{ hz: 100 }},
+                },
+		
+		presets:
+		{
+		  a: { osc:{ hz:110 } },
+		  b: { osc:{ hz:120 } },
+		}
+	      },
+	      
+	      net_b: {
+	        count 3, // override higher level 'count'
+                procs: {
+                  osc:  { class: sine_tone,   args:{ hz: 200 }},
+                },
+		
+		presets:
+		{
+		  a: { osc:{hz:220} },
+		  b: { osc:{hz:230} }
+		}
+	      }
+            },
+
+            presets: {
+	      aa: { net_a:a, net_b:a },
+	      bb: { net_a:b, net_b:b },
+	    }
+           
+         }
+
+         // Iterate over the instances of `osc_poly.osc_.out` to create one `audio_merge`
+         // input for every output from the polyphonic network.
+         merge: { class: audio_merge,    in:{ in_:osc_poly.osc_.out}, args:{ gain:1, out_gain:0.5 }
+	   presets: {
+	     a:{ gain:0.3 }
+	     b:{ gain:0.2 }
+	   }
+	 },
+         aout:  { class: audio_out,      in:{ in:merge.out }          args:{ dev_label:"main"} }
+
+	}
+	
+	presets: {
+          a:{ osc_poly1:aa,   merge:a },
+          b:{ osc_poly0_2:bb, merge:b },
+          c:{ osc_poly:bb,    merge:{ out_gain:0.1 } },
+	  d:{ osc_poly0:bb,   merge:{ out_gain:0.05} }
+	}
+      }
+    }   
+
+
+
+
+  }
+}