DSP effects with WinRec
-----------------------

WinRec is able of using DSP sound effects during playing and/or recording.
The DSP program must be available as a .LOD file. The date must be recieved
and transmitted via the DMA matrix without handshake.
Some effects are included into the WinRec package. For the DSP effect
NOTHING.LOD the source code is also included to show you how to transmit the
sound and parameter data. You can use this source as a base for your own
programs. Look at it and try it. You can't destroy your Falcon - only your
ears :-)

The effects
	GR_EQU.LOD
 and
 	HALL.LOD (only WinRec Pro)
are based on free source codes of Motorola. I have take this sources and adapt
them to the FALCON.

To every .LOD file there may exist a .PAR file. This file contains
information about the parameter that can be used to modify the DSP effect.
Using the information in this file you can modify the effect by sliders in
WinRec.

The structure of a PAR file:
----------------------------

TITLE [Effect name]
DECPARA/HEXPARA [Parameter no.],[Minimal value],[Maximal value],[Default value],
[Parameter name max 3. chars]


DECPARA = All values decimal (24 Bit)
HEXPARA = Alle values hexa decimal (24 Bit)

example:
---------

TITLE Karaoke
HEXPARA 0,0,7fffff,599999,BAS
HEXPARA 1,0,7fffff,7fffff,VOI

The parameters are sent to the DSP via 'Dsp_BlkUnpacked()'. At first the
number of the parameter to be changed and then it's new value.

Since WinRec V1.33:
-------------------

With the command 'EFFMODE D2D' you can use D2D effects.
Please read the 'CHANGES.TXT'.

Since WinRec V1.37
------------------

The extension 'LINK xx' at the end of a PARA line, links the correspondending parameter
with the parameter 'xx'. Using a slider such a parameter in WinRec while holding down
the CONTROL key, both parameter are changed.

example:
DECPARA 0,0,31,16,BAS LINK 10


Now you can create tables:

example:
BEGINTABLE x
-0.200,-0.187,-0.171,-0.160,-0.150,-0.137,-0.114,-0.103,-0.092
-0.080,-0.067,-0.051,-0.039,-0.027,-0.015,0.000,0.000,0.030
0.060,0.090,0.120,0.150,0.180,0.210,0.250,0.290,0.340,0.380,0.460
0.540,0.750,0.999
ENDTABLE

'x' is the number of the following table. You can use this values with the new 'TABLEPARA'
command:

TABLEPARA [table],[parameter no.],[lowest index],[highest index],[default index],
[parameter name]

example:
TABLEPARA 0,0,0,31,16,BAS


If the effect stores internally the highest sample value, you can tell this WinRec with the

PEAK YES

line. WinRec load periodically (using 'Dsp_BlkUnpacked') two DSP words and shows the value
in the info line of the main dialog. The DSP Interrupt $13 should clear the intern peak
level variables.



Andreas Binner