DUMP -- print PField variable data (utility instrument)
in RTcmix/insts/std
quick syntax:
DUMP(outsk, dur, AMP[, TABLE])
CAPITALIZED parameters are
pfield-enabled
for table or dynamic control (see the
maketable
or
makeconnection
or the other "make*"-pfield
scorefile commands). Parameters after the [bracket] are optional and
default to 0 unless otherwise noted.
p0 = output start time
p1 = duration
p2 = amp
p3 = fixed table [optional]
p2 (amplitude) can receive dynamic updates from a table or real-time
control source. This is the parameter whose values will print (unless
the optional p3 parameter is present).
DUMP
is a "utility" instrument that can be used to debug PField variables
representing table data or control input streams. If p3 is not present,
the values coming through the "amp" PField (p2) will be printed.
How often printing occurs is determined by the
control_rate
setting in the scorefile. If p3 is present, all of the values
in the table represented by p3 will print at each
control_rate
interval.
Usage Notes
This can generate a huge amount of printed data. It is best
when debugging table values (p3) to use small table sizes, since the
entire table is printed at each interval.
Sample Scores
very basic:
rtsetparams(44100, 1)
load("DUMP")
ampenv = maketable("line", 1000, 0,0, 1,1, 2,0)
DUMP(0, 2, ampenv)
more advanced:
rtsetparams(44100, 1)
load("DUMP")
control_rate(100)
amp = maketable("line", 1000, 0,0, 1,1, 2,0)
amp = makefilter(amp, "fitrange", -100, 300)
DUMP(0, dur, amp)
See Also
maketable,
makemonitor,
dumptable,
plottable,
control_rate,
print,
printf