Programmer Guide/SPU Reference/UCONV

UCONV - amp/frq value conversions

Usage:

UCONV x type a b

Inputs:

x	number or vector to be converted
type	type of conversion
a	conversion parameter a
b	conversion parameter b

Outputs:

y	converted number or vector (same type as x)

Function:

This atom performs a conversion of the vector x (containing physical data) into another unit or domain. The type of conversion is controlled by the selection input type and the parameter inputs a and b. The input data can be stored in a number or vector. If the input is a vector, the conversion is applied to all elements.

Conversion type selected by input type

value of type	default values	applied transformation /conversion
a	b
0 or LINEAR	1	0	Linear transformation. Parameter a is used as slope and parameter b as offset: y=a.x+b
1 or HZ2CENT	1	0	Convert frequency from Hertz to Cents. Parameter a is used as reference frequency and b as offset in Cents:y=1200.log2(x/a)+b
2 or CENT2HZ	1	0	Convert frequency from Cents to Hertz. Parameter a is used as reference frequency and b as offset in Cents: y=a.2(x-b)/1200
3 or HZ2BARK	-	-	Convert frequency from Hertz to Barks. Uses the transformation published by Zwicker and Fastl (1990). The parameters a and b are ignored.
4 or BARK2HZ	-	-	Convert frequency from Barks to Hertz. Uses an iteration method that minimizes the distance to the forward conversion algorithm. The parameters a and b are ignored.
5 or LIN2LOG	1	20	Convert from linear to logarithmic scale. Parameter a is used as reference value and b as factor: y=b.log10(x/a)
6 or LOG2LIN	1	20	Convert from logarithmic to linear scale. Parameter a is used as reference value and b as factor: y=a.10x/b
7 or HZ2MEL	-	-	Convert from Hertz to Mel.The parameters a and b are ignored.
8 or MEL2HZ	-	-	Convert from Mel to Hertz.The parameters a and b are ignored.
9 or HZ2ERB	-	-	Convert from Hertz to ERB (Equivalent Rectangular Bandwidth).The parameters a and b are ignored.
10 or ERB2HZ	-	-	Convert from ERB (Equivalent Rectangular Bandwidth) to Hertz.The parameters a and b are ignored.