UGRW2.DOC


A description of the new k rate filter unit generators and the limit 
and ilimit ugens in UGRW2.C and UGRW2.H.

9 September 1995

Robin Whittle   firstpr@ozemail.com.au  rwhittle@ozonline.com.au
                http://www.ozemail.com.au/~firstpr

For Csound users and C programmers.


Short description 
=================

kport 
-----
        is like port, except the half time can be controlled at k 
        rate.

ktone, katone, kreson and kareson 
---------------------------------


        are like tone, atone, reson and areson except:

        1 -     They work with k rate signals instead of a rate.

        2 -     For kreson and kareson, the default for iscl is 1.


limit ilimit
------------

        These set upper and lower limits on i, k or a rate variables.




Full descriptions:
==================

kport, ktone, katone, kreson and kareson 
========================================

Please refer to the Csound manual for details of the original versions 
of these unit generators.


kr      kport   ksig, khtime [,isig]

    
    ksig    k rate output.

    khtime  k rate time for output ot reach halfway to input.

    isig    i time, initialisation for internal state.


kr      ktone   ksig, khp [,istor]
kr      katone  ksig, khp [,istor]

    ksig    k rate output.

    khp     k rate frequency at which half power is reached.

    istor   i time, initialise internal state. Default 0 = clear.
 


kr      kreson  ksig, kcf, kbw [, iscl] [,istor] 
kr      kareson ksig, kcf, kbw [, iscl] [,istor] 

    ksig    k rate output.

    kcf     k rate centre frequency.

    kbw     k rate bandwidth - between lower and upper half power points.

    iscl    i time, 0 = no gain change (default fr a rate reson, areson
                                        but leads to huge signals.)     

                    1 = gain at centre frequency = 1 (default)

                    2 = overal RMS gain = 1 (What exactly does this mean?)
 
   istor    i time, initialise internal state. Default 0 = clear.
 


I have not exhaustively tested these ugens, but they seem to work 
fine.



limit and ilimit
================

ir      ilimit  isig, ilow, ihigh

kr      limit   ksig, klow, khigh
ar      limit   asig, klow, khigh

These set lower and upper limits on the xsig value they process. If 
xhigh is lower than xlow, then the output will be the average of the 
two - it will not be affected by xsig.

i rate variables control ilimit.  k rate variables control the a or k 
rate limit ugen.