Are you updating the manual sources in CVS? If you do, then as we rebuild 
the manual relatively frequently, your changes will be reflected there.

----- Original Message ----- 
From: "Istvan Varga" 
To: 
Sent: Wednesday, February 16, 2005 5:49 PM
Subject: [Cs-dev] CVS changes: new opcodes and bug fixes


> 2005-02-16      Istvan Varga    
>         * InOut/libsnd.c:
>           print correct audio block sizes
>           audrecv/rtrecord returns the number of bytes read
>         * InOut/rtjack.c:
>           do not connect to JACK server if real time audio is not used
>         * InOut/rtpa.c:
>           audrecv/rtrecord returns the number of bytes read
>         * Opcodes/deps:
>           removed unused file
>         * Opcodes/oscbnk.c:
>         * Opcodes/oscbnk.h:
>           added new opcodes from 4.24.1 (denorm, delayk, vdel_k, and 
> rbjeq)
>           a-rate rnd31 was made faster
>           improved seeding from time
>           removed all static variables (hopefully did not break 
> anything...)
>         * Top/argdecode.c:
>           fixed output to raw sound files (set O.filetyp = TYP_RAW)
>         * Top/csound.c:
>           print newline at end of various "early return" error messages
>           more error checking in dummy rtaudio functions; 
> allow -+rtaudio=null
>           audrecv/rtrecord returns the number of bytes read
>           fixed return value in csoundAppendOpcode (should be zero on 
> success)
>
> Opcode manuals are attached, except for 'denorm', which is very simple:
>
> denorm a1[, a2[, a3[, ... ]]]
>         * mixes low level (~1e-20 for floats, and ~1e-56 for doubles)
>           noise to a list of a-rate signals.
>


--------------------------------------------------------------------------------


>
> ar      rbjeq   asig, kfco, klvl, kQ, kS[, imode]
>
> DESCRIPTION
> -----------
>
> Parametric equalizer and filter opcode with 7 filter types, based on
> algorithm by Robert Bristow-Johnson.
>
> INITIALIZATION
> --------------
>
> imode (optional, defaults to zero) - sum of:
>
>    1: skip initialization (should be used in tied, or re-initialized
>       notes only).
>
>  and exactly one of the following values to select filter type:
>
>    0: resonant lowpass filter. kQ controls the resonance: at the
>       cutoff frequency (kfco), the amplitude gain is kQ (e.g. 20 dB
>       for kQ = 10), and higher kQ values result in a narrower
>       resonance peak. If kQ is set to sqrt(0.5) (about 0.7071),
>       there is no resonance, and the filter has a response that is
>       very similar to that of butterlp. If kQ is less than sqrt(0.5),
>       there is no resonance, and the filter has a -6 dB / octave
>       response from about kfco * kQ to kfco. Above kfco, there is
>       always a -12 dB / octave cutoff.
>
>       NOTE: the rbjeq lowpass filter is basically the same as
>         ar     pareq   asig, kfco, 0, kQ, 2
>       but is faster to calculate.
>
>    2: resonant highpass filter. The parameters are the same as for
>       the lowpass filter, but the equivalent filter is butterhp if
>       kQ is 0.7071, and "ar pareq asig, kfco, 0, kQ, 1" in other
>       cases.
>
>    4: bandpass filter. kQ controls the bandwidth, which is kfco / kQ,
>       and must be always less than sr / 2. The bandwidth is measured
>       between -3 dB points (i.e. amplitude gain = 0.7071), beyond
>       which there is a +/- 6 dB / octave slope.
>       This filter type is very similar to
>         ar     butterbp asig, kfco, kfco / kQ
>
>    6: band-reject filter, with the same parameters as the bandpass
>       filter, and a response similar to that of butterbr.
>
>    8: peaking EQ. It has an amplitude gain of 1 (0 dB) at 0 Hz and
>       sr / 2, and klvl at the center frequency (kfco). Thus, klvl
>       controls the amount of boost (if it is greater than 1), or
>       cut (if it is less than 1). Setting klvl to 1 results in a
>       flat response. Similarly to the bandpass and band-reject
>       filters, the bandwidth is determined by kfco / kQ (which must
>       be less than sr / 2 again); however, this time it is between
>       sqrt(klvl) points (or, in other words, half the boost or cut
>       in decibels).
>       NOTE: excessively low or high values of klvl should be avoided
>       (especially with 32-bit floats), though the opcode was tested
>       with klvl = 0.01 and klvl = 100. klvl = 0 is always an error,
>       unlike in the case of pareq, which does allow a zero level.
>
>   10: low shelf EQ, controlled by klvl and kS (kQ is ignored by this
>       filter type). There is an amplitude gain of klvl at zero
>       frequency, while the level of high frequencies (around sr / 2)
>       is not changed. At the corner frequency (kfco), the gain is
>       sqrt(klvl) (half the boost or cut in decibels). The kS
>       parameter controls the steepness of the slope of the frequency
>       response (see below).
>
>   12: high shelf EQ. Very similar to the low shelf EQ, but affects
>       the high frequency range.
>
>  the default value for imode is zero (lowpass filter, initialization
>  not skipped).
>
> PERFORMANCE
> -----------
>
> ar - the output signal.
>
> asig - the input signal.
>  NOTE: if the input contains silent sections, on Intel CPUs a
>  significant slowdown can occur due to denormals. In such cases, it
>  is recommended to process the input signal with "denorm" opcode
>  before filtering it with rbjeq (and actually many other filters).
>
> kfco - cutoff, corner, or center frequency, depending on filter type,
>  in Hz. It must be greater than zero, and less than sr / 2 (the range
>  of about sr * 0.0002 to sr * 0.49 should be safe).
>
> klvl - level (amount of boost or cut), as amplitude gain (e.g. 1: flat
>  response, 4: 12 dB boost, 0.1: 20 dB cut); zero or negative values
>  are not allowed. It is recognized by the peaking and shelving EQ
>  types (8, 10, 12) only, and is ignored by other filters.
>
> kQ - resonance (also kfco / bandwidth in many filter types). Not used
>  by the shelving EQs (imode = 10 and 12). The exact meaning of this
>  parameter depends on the filter type (see above), but it should be
>  always greater than zero, and usually (kfco / kQ) less than sr / 2.
>
> kS - shelf slope parameter for shelving filters. Must be greater than
>  zero; a higher value means a steeper slope, with resonance if
>  kS > 1 (however, a too high kS value may make the filter unstable).
>  If kS is set to exactly 1, the shelf slope is as steep as possible
>  without a resonance. Note that the effect of kS - especially if it
>  is greater than 1 - also depends on klvl, and it does not have any
>  well defined unit.
>
> EXAMPLE
> -------
>
> ; ---- orchestra ----
>
> sr      =  44100
> ksmps   =  10
> nchnls  =  1
>
>        instr 1
>
> a1      vco2    10000, 155.6            ; sawtooth wave
> kfco    expon   8000, p3, 200           ; filter frequency
> a1      rbjeq   a1, kfco, 1, kfco * 0.005, 1, 0 ; resonant lowpass
>        out a1
>
>        endin
>
> ; ---- score ----
>
> i 1 0 5
> e
>
> AUTHORS
> -------
>
> Original algorithm by Robert Bristow-Johnson
> Csound orchestra version by Josep M Comajuncosas, Aug 1999
> Converted to C (with optimizations and bug fixes) by Istvan Varga,
> Dec 2002
>
> ========================================================================
>
> kr      delayk  ksig, idel[, imode]
> kr      vdel_k  ksig, kdel, imdel[, imode]
>
> DESCRIPTION
> -----------
>
> k-rate delay opcodes.
>
> INITIALIZATION
> --------------
>
> idel - delay time (in seconds) for delayk. It is rounded to the
>  nearest integer multiple of a k-cycle (i.e. 1/kr).
>
> imode - sum of:
>  1: skip initialization (e.g. in tied notes)
>  2: hold the first input value during the initial delay, instead of
>     outputting zero. This is mainly of use when delaying envelopes
>     that do not start at zero.
>
>        ^__          imode = 0   ^   ___
>        |  \                     |   |  \
>        |   \            =>      |   |   \
>        |    \                   |   |    \
>       -+------------>          -+------------>
>        |                        |
>
>        ^__          imode = 2   ^______
>        |  \                     |      \
>        |   \            =>      |       \
>        |    \                   |        \
>       -+------------>          -+------------>
>        |                        |
>
> imdel - maximum delay time for vdel_k, in seconds.
>
> PERFORMANCE
> -----------
>
> kr - the output signal. Note: none of the opcodes interpolate the
>  output.
>
> ksig - the input signal.
>
> kdel - delay time (in seconds) for vdel_k. It is rounded to the
>  nearest integer multiple of a k-cycle (i.e. 1/kr).
>
> AUTHOR
> ------
>
> Istvan Varga
> Dec 2002
>
> 




-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

Michael Gogins wrote:

> Are you updating the manual sources in CVS? If you do, then as we 
> rebuild the manual relatively frequently, your changes will be reflected 
> there.

No I do not, I am not very familiar with the manual sources.


-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net