<- C I ->

kdump, kdump2, kdump3, kdump4

        kdump   ksig, ifilname, iformat, iprd
        kdump2  ksig1, ksig2, ifilname, iformat, iprd
        kdump3  ksig1, ksig2, ksig3, ifilname, iformat, iprd
        kdump4  ksig1, ksig2, ksig3, ksig4, ifilname, iformat, iprd
Periodically write orchestra control-signal values to a named external file in a specific format.

INITIALISATION

ifilname - character string(in double quotes, saces ermitted ) denoting the external file name. May either be a full path name with target directory specified or a simple filename to be created within the current directory

iformat - specifies the output data format: 1 = 8-bit signed char(high order 8 bits of a 16-bit integer, 4 = 16-bit short integers, 5 = 32bit long integers, 6 = 32-bit floats, 7=ASCII long integers, 8=ASCII floats (2 decimal places). Note that A-law and U-law ouput are not availble,and that all formats except the lsat two are binary. The outpu file contains no header information.

iprd - the period of ksig output i seconds, rounded to the nearest orchestra control period. A value of 0 implies one control period (the enforced minimum), which will create an ouput file sampled at the orchestra control rate.

PERFORMANCE

These units allow up to four generated control signal values to be saved in a named external file. The file contains no sef-defining header information, but there is a regularly sampled time series, suitable for later input or analysis. There may be a number of kdump units in an instrument or orchestra.

Example:

knum   =         knum+1                                               ; at each k-perio
ktemp  tempest   krms, .02, .1, 3, 2, 800, .005, 0, 60, 4, .1, .995   ;estimate the tempo
koct   specptrk  wsig, 6, .9, 0                                       ;and the pitch
       kdump3    knum, ktemp, cpsoct(koct), "what happened when", 8 0 ;& save them
<- C I ->
Prepared from the MIT Media Lab Csound Manual, PJN, Nov 1994.