an open-source digital signal processing and sound synthesis language
about · links · contact
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 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)

   ampenv = maketable("line", 1000, 0,0, 1,1, 2,0)
   DUMP(0, 2, ampenv)

more advanced:
   rtsetparams(44100, 1)


   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