SYNTAX

program = [plugindirs] { channels | effectloops | ctrls };

plugindirs = { 'plugindir' dirname }

channels = 'chans' '{' channellist '}';
channellist = channel
    | channel ',' channellist;

effectloops = 'fx' '{'  effectlooplist '}';
effectlooplist = effectloop
    | effectlooplist ',' effectloop;
    

ctrls  =  'ctrl' '{' ctrllist  '}';
ctrllist = ctrl
    | ctrl ',' ctrllist;


# channel is name, default value (control name) and optional send
# default channel is stereo

channel = ident ': ' 
    [returninfo] # if it's a return it won't get a JACK port.
    'gain' value
    'pan' value 
    ['mono'|'stereo'] [sendinfo];

# name of an fx chain    
returninfo = 'return' ident


# value here is the gain. Post or pre indicates post- or pre-fader,
# default is post.

sendinfo = 'send' ident ('post'|'pre') value;


# if DB is present, the value is a log scale value in decibels
# and is converted to a ratio on get. It should be -60:0.
# If smooth is present, the default smoothing factor is changed.
# The default is 0.5 - the closer to 1, the slower the value changes
# are tracked. 0 is no smoothing, 0.99 takes a few seconds.
# Default range is 0-1, unless DB is set when it is -60 to 0.
# 'default' is used in effects only, and sets the default value.
# In effects, 'range' is not permitted.

value = [{valopt}]  (number|'default') [ '(' ctrlname ')' ];
valopt = 'db' | ('smooth' float) | ('range' number ',' number)


ctrl = ident ':' sourcespec [noconvert] [inrangespec] ;
sourcespec = string;
inrangespec = 'in' number ': number;




effectloop = TBD