readme

用于TM1300/PNX1300系列DSP（主要用于视频处理）的各种滤波器源码

TC README (05/14/2000)

This is the first version of the Transform Calculator.

Commands
--------

	! command		call shell
	" ...			comment
	let e<n> <expr>		Assigns variable number <n> 
	DUMP "filename" <expr>	Write to file
	<expr>			Evaluate expression, assign to next
				numbered variable
	print			Print state information
	set <option> <value> 	Set state value
				 "-scale" <n> multiply factor
				 "-blocks" <n> number of blocks for IEEE test
				 "-verbose" <n> output level (0-2)
				 "-width" <n>  number of digits for output
				 "-clip" <n> limit DCT value to +/- n
	reset			* Reset state to default values
				 -scale 0 -width 8 -verbose 0 -nblocks 100
				  -range 255
				* Reset random number generator seed

	ieee1180 <options>	IEEE-1180 random # test, inverse DCT
				  "-lwb" <n>	Lower bound for random #'s
				  "-upb" <m>	Upper bound of random #'s
				  "-sgn" <m>	positive <m> = 1,
						negative <m> = -1 
Expressions
-----------

	DC	<n>		<n> element vector of 1's
	<n> DC  <m>		<n> by <m> element array of 1's
	<n> AC  <m>		<n> by <m> element array of 0's and 1's
	TRANSPOSE <expr>	Vector transpose
	INTEGERS n		INTEGERS from 0 .. n -1
	<expr> ROWS <n>	transform vector to 2-D array, 1st dimension is <n>
	<expr> COLS <m>	transform vector to 2-D array, 2nd dimension is <m>
	DATA	"filename"	Read array/vector from file
	<expr> MIN   <value>	Element by element Clip (value = lower bound)
	<expr> MAX   <value>	Element by element Clip (value = upper bound)
	<expr> MOD   <value>    Element by Element Modulus (value = rounding)
	<expr>  <<   <value>	Rotate vector left n  positions
	<expr>  >>   <value>	Rotate vector right n positions		
	<expr> +     <value>	Addition of vector and scalar
	<expr> -     <value> 	Subtraction of vector and scalar
	<expr> *     <value>	Product of vector and scalar
	<expr> /     <value> 	Divide vector and scalar
	<expr> * <expr>		Element by element multiply, vector/array
	{ e1 e2 e3 ... }     	Define vector of constant values
	<n> RANDOM <m>		8 by 8 element array, random values,
	  			range from <n> to <m>
	( expr )	
	

IEEE 1180 conformance test
--------------------------

Use the following input:

	begin "ieee1180.sh"

	This executes 6 IDCTs on different ranges and signs.

	The TriMedia IDCT is compared with a reference IDCT
	on 10000 random inputs

	All six should comply with the conformance test.

Producing a DCT test matrix
---------------------------

	A 8 x 8 DCT input array can be produced as follows. Variables
	are assumed as marked

	integers 64					(e1)
	e1 rows 8					(e2)


DCT commands
------------

	dct e2						(e3)
	inv dct e3					(e4)
	sep dct e2					(e5)
	8pt inv dct e2					(e6)

The separable DCT uses 2 1 D transforms back to back.
	

Comparing individual DCT outputs
--------------------------------

	data "../idct/data/test2d.2"

	inv dct e1

	set -clip 10000
	8pt inv e1

Comparing first pass outputs

	data "../idct/data/test2d.2"

	

Compiling
---------

The Transform Calculator needs to be compiled on Windows 95.