Description

Scales incoming value to user-definable range. Similar to scale object found in popular dataflow languages.

Syntax

kscl scale2 kinput, kmin, kmax[, kimin, kimax][ihtime]

Initialisation

ihtime -- Optional; Half time value for internal port filter for smoothing. Default is no smoothing.

Performance

kin -- Input value. Can originate from any k-rate source and should be in the range kimin to kimax. If it is larger than kimax it is treated as kimax, and if less than kimin then it is treated as kimin.

kmin -- Minimum value of the resultant scale operation.

kmax -- Maximum value of the resultant scale operation.

kimin -- Optional; Minimum of the incoming value range, defaulting to zero.

kimax -- Optional; Maximum of the incoming value range, defaulting to one.

	Warning
	The argument order is minimum before maximum, which differs from scale but it consistent with other opcodes that use a range.

Examples

Here is an example of the scale2 opcode. It uses the file scale2.csd.

<CsoundSynthesizer>
<CsOptions>
; Select audio/midi flags here according to platform
; Audio out   Audio in    Silent
-odac           -iadc     -d    ;;;realtime output
</CsOptions>
<CsInstruments>

sr	=	44100
ksmps	=	10
nchnls	=	2

/*--- ---*/

	instr	1	; scale test

kmod	ctrl7	1, 1, 0, 1
	printk2	kmod

kout	scale2	kmod, -127, 0
	printk2	kout

	endin

/*--- ---*/
</CsInstruments>
<CsScore>

i1	0	8888

e
</CsScore>
</CsoundSynthesizer>

See Also

gainslider, logcurve, expcurve scale

Credits