
  ########################################
  SOUNDEffect Version 1.30 - November 1992    (c) Sven Bhling - Shareware
  ########################################

  English documentation

****************************************************************************

  ----------------------
  Temporary buffers (ZS)
  ----------------------

The gadgets for these buffers are situated on the left border of the screen.
There are eight eqal groups of these. Each group consists of:
  - a gadget looking either like a chip (that means, the ZS is in ram -
    fast-ram if possible) or like a disk (ZS is on disk - directory is
    entered in the Misc-panel)
  - a LED, wich shows you if the ZS is used
  - a button to select this ZS
  - a string-gaget in which the programm writes the name of the sample. You
    can change this name for example to make notes.

Above them there are three gadgets looking like |-->|, |<--| and | X |.
|-->| load the ZS in the main buffer. |<--| saves the main buffer to the
selected ZS. | X | will delete the ZS.

  ----------------
  Graphic-displays
  ----------------

There are two graphic-displays on the screen. The upper one shows the sample
or a part of it. The other display can be used for freehand-editing or
drawing curves, envelop waveforms etc.
Between them is a status-line on wich you always should have a look.

  ----------------------------
  Drawing in the lower display
  ----------------------------

The lower display can be used to create envelop waveforms for frequency and
amplitude modulation. It's also possible to paint there diagramms for |Echo1|
with is a special reverb effect of this program. Another use of the lower
display is freehand editing of the sample.
You can draw there with the left mousebutton. To select the paint-mode
(draw-mode or point-mode) use the two gadgets left of the status line. In
draw-mode you can paint normal curves. In point-mode appear no points
because this routine always draws a continuous line from the left to the
right border. With the gadgets on the right side of the status line you can
delete the lower display in two different ways. (Use always the right
delete-gadget together with point-mode if you want to start |Echo1|!)

There are also three gadgets left-hand to the lower display. The two upper
ones can be used to load and save the contents of the lower display. You
should enter directory and file name in the Disk I/O-Panel (see below). Both
gadget can be activated by double click.
With the lowest of these three gadgets you can toggle between two buffers.

You can mark a range in the lower display with the right mouse button. The
range functions are described in the Edit-Panel (follows later).

  -----------------
  The upper display
  -----------------

A loaded sample will be displayed here. You can modify the display
parameters in the MISC-Panel (see below).

The values on the top have follwing meaning:
   L   - length of the sample
   RB  - beginning of the range
   RL  - length of the range
   DB  - beginning of the displayed part of the sample
   DL  - length

You can mark a range with the right mouse button.

Left of the display there is again a tier of gadgets:
  (pocket-lens)     - show range
      <->           - zoom out
       X            - remove range
      <-            - scroll left
      ->            - scroll right
(crossed out lense) - show the whole sample

WARNING: Many functions of SOUNDEffect work only with the selected part of the
         sample if a range is marked (f.e. filter or echo). If you don't need
         the range anymore you should remove it because other function could
         be influenced by the range.

  -------------
  The play rate
  -------------

The play rate gadgets are located under the two graphic displays. There is
not only a proportional and a numeric gadget also input of notes is
supported. Use capital letters, f.e.: C-3, D#4, Ab5, Bb2.
If the entered note is not the same as the played your sample is not
correctly "tuned". Use the |Ch. Pitch| function of the Others-Panel to
correct it.

  ----------
  The panels
  ----------

There are no pull down menus in this version of SOUNDEffect. Also keyboard
shortcuts are not supported yet (because I use to forget them always). All
functions of the program can and must be started by gadgets which are ordered
in some panels.

  -------------
  The DIO-panel
  -------------

This panel is a simpel file requester (it's not really a requester). There
should be no problem in handling. With the gadget under |^| you can choose
whether the sample should be saved in RAW- or IFF-format. The obsolete
future-sound-format can also be loaded but not saved. (SOUNDEffect examins if
the loaded sample is in IFF- or future-sound-format; if not it is supposed to
be a RAW-sample.) The |Delete|-gadget must be doubleclicked to delete the
selected file.

  --------------
  The Play-panel
  --------------

SOUNDEffect now uses a DMA-play-routine. There are gadgets to play the whole
sample, the marked range and the displayed part of the sample. With |Repeat|
you can start an non-stop output. |Use loop| is usefull to select if a loop
(if marked) shell be ignored. There's also a gadget to switch the hardware
filter on and off.

  ---------------
  The Range-panel
  ---------------

Here are a lot of gadgets for work in the upper display where the sample is
displayed.
|Copy| copies a range (if selected) into the copy buffer. |Paste| copies the
contents of this copy buffer into the sample beginning at left border of the
range. |Cut| cuts the marked range out of the sample. So the sample gets
shorter (|Copy| and |Paste| don't change the length of the sample).
With the gadgets in the second row you can shift the range borders. With |St|
and |End| you can select if the left or rigth border will be affected. |<-|
and |->| shift for one byte. |0<-| and |->0| shift to the next zero in the
sample (quite useful if you want to mark a loop).
With |Ins| you can insert the copy buffer on the selected place (left range
border) into the sample. The sample gets longer. |S<->B| exchanges sample and
copy buffer. |Rem| removes the copy buffer (only usefull if you don't have
enough memory). With |Add| and |Mix| you can mix the copy beginning from the
left range border into the sample. The difference between both is that |Mix|
reduces the amplitude of sample and copy buffer to the half. If you use
|Add| SOUNDEffect will warn you if distortions occure while mixing (in the
status line). Using |Mix| distortions are impossible.
With |Append| you can make your sample longer. Enter the value into the
LONGINT-gadget. |Sw| will swap the range (there's no really use). For
example -5 will be transformed to 5, 28 to -28 and so on. |Rev| reverses the
range. (Try it with drum samples!)
With Shift |up| |down| the range can be shifted up and down. (Useful if your
digitizer is not correctly adjusted.) The value must be in percent! The |Amp|
gadget can be used to "turn" your sample louder or fainter. Value in percent.

  ----------
  Edit-panel
  ----------

With the edit-panel you can edit the lower display.
The gadgets in the upper two rows are similar with the range-panel. The only
differece is that they affect the lower display or the range marked in the
lower display.
With Shift |X| |Y| you can shift the contents of the range left, right, up
and down. The value (|Y|: from -27 to 27, from -418 to 418) should be entered
into the LONGINT-gadget. |Multi| multiplies the contents of the range. For
instance: If you paint a sine waveform and mark it and enter 3 into the
LONGINT gadget you'll get 3 sine waveforms in the range after clicking on
|Multi|.
Expand |X| |Y| make it possible to expand or shrink the contents of the
range. Enter the value in percents. |Sw| and |Rev| we allready know from the
range-panel.
The four graphic-gadgets will bring the four most used standard waveforms
into the lower display or if selected into the range. With |Backup| you can
make a copy of the lower display for security (in RAM). |Undo| will bring
back this copy.

  ----------
  MISC-panel
  ----------

In the string gadget you can enter into wich path the disk-ZS shell be saved.
DON'T FORGET THE '/' AT THE END! |Info| displays an info text. With the
gadgets left from |Info| you can change the graphics quality and speed. Try
it out!
|Quit| is only useful if you want to quit the programm. |Iconify| keeps the
programm code in memory but all buffers will be DELETED (!!!).

  --------------------
  Modulation-Mix-panel
  --------------------

|AM| starts a amplitude modulation. Before you click |AM| you should draw the
envelop waveform into the lower display. If Y-Range is 100 % the middle line
of the lower display matches the original amplitude. If you change Y-Range to
50% it's impossible to distort the sample. If any distortions occur the
program will warn you in the status-line.
|FM| is good to start a frequeny modulation. The result depends from the
contents of the |Strength| gadget AND from the current record rate. (You can
modify the record rate with the gadgets under the lower display.) Into the
|Strength| gadget you can enter the maximum change of rate. The bigger the
value the stronger the modulation. Of course you should not enter any value
witch is bigger than the current record rate.
Under that you can see an 8 channel mono mixer. Here you can mix the 8 ZS
together. But don't forget that the rates of all ZS are constant while
mixing. So if you want to make an chord sample you should use the |Ch. Pitch|
function of Others-panel. (After pitch-changing put the samples into ZS and
then mix everything together.)
The right proportional gadget is the main volume for the mixer. If any
distortion occurs the programm will inform you.
If you want to make vibrato or tremollo effects use the |Multi| function of
the Range-panel.

  ----------
  Echo-panel
  ----------

There are two Echo-functions implemented. The first one can be started with
|Echo1|. This one is very useful to make good reverb effects. This
funtions gets echo-delay and -strength from the lower display. At first you
should delete the lower display with the RIGHT delete gadget. The line
MUST be on the bottom. NEVER use the other delete gadget before |Echo1|. Then
you should switch to POINT-mode (left from the status-line). Now you can click
into the lower display whereever you want to have an echo.  If X-Range is 100%
and you click in the middle of the lower display, the echo will beginn in the
middle of the sample. If Strength is 50% and the line goes from the bottom to
the middle of the lower display, the echo has the half volume. If no range is
marked |Echo1| will take the whole sample to make the echo. If you selected a
range it will take only the the contents of the range.
If you want to get good reverb effects you should select |fromCB| before
echoing. Then |Echo1| will take the contents of the copybuffer to make the
echo. But before you can do that you have to copy a part of the sample into
the copybuffer. Then use |S<->B| and make a amplitudemodulation with an
envelop waveform like a half circle. Then click |S<->B| again and return to
echo-panel.
|Echo2| is the other way to make Echos. Here you can enter delay, strength
and the number of echos directly into LongInt-gadgets. If Strength is 50%,
the first echo will have 50%, the second 25% and so on.
Before you use echo effects you should append workspace onto your sample. Use
the |Append| function in the range-panel.

  ------------
  Chorus-panel
  ------------

The chorus effect detunes and mixes upto four voices of the sample.
The vertical prop-gadgets can be used like a mixer. The left one is the
mix-volume of the original sample. The right gaddget is a master volume. With
the other four gadgets you can change the mix-volume of the four detuned
voices.
With the four horizonal prop-gadgets you can change the strength and
direction of detuning. In Range you can enter the Range in wich you can
detune with the prop-gadgets. If the Range is 2000 and your Record-Rate 10000
the detuned voices can have rates from 8000 upto 12000.
Don't forget to make a copy of your sample to one of the ZS (temperary
buffers) before you start the chorus-effect.

  -------------
  Special-panel
  -------------

At first there are low and high pass filters. You can adjust the
cut-off-frequency by entering the value (in Hz) into the numeric gadget. You
should take into consideration that the topical play rate of the sample
influences the result of this function.
|Compr|, |Limiter| and |Expand| influence only the amplitude of the sample.
|Compr| compresses the sample. Faint parts of the sample become louder and
loud parts softer. |Expand| does the opposite. |Limiter| lets the amplitude of
loud parts constant. The rest becomes louder.
|Dist1| and |Dist2| distort the sample.
All these functions affect the range if marked - else the whole sample.
|Noise| generates noise. Enter the strength into the numeric gadget.
|Shorten| searches beginning at the and of the sample for the first value
wich is bigger than the entered one. The part behind this value will be cut
off.

  ----------
  MISC-Panel
  ----------

The |Ch. Pitch| function can be used to tune ore detune a sample. Enter the
new play rate (or period or note) and click on |Ch. Pitch|. |Oct up| and |Oct
down| change the pitch in octave steps.
|Range=loop| shows the loop of the sample (if set). |Loop=range| is useful to
set and remove a loop. (To remove a loop remove the range with the gadget
left of the upper display an click on |Loop=range|.)
The gadgets |Range->Edit| and |Edit->Range| transfer the selected part into
the lower display or back to the range. You can edit the sample in the lower
display by drawing with the mouse. Pay attention whether draw-mode or
point-mode is selected.

***************************************************************************

In the german doc-file I described many examples of using the functions. If
you know a little bit german you should have a look at this. Else you should
try out if you didn't understand something. It's quite difficult to explain
in a foreign language.

  Plans for future
  ----------------
- Stereo effects
- new user interface
- ARRex-Port

...and much more

The unregistered version of SOUNDEffect ony displays samples which are
shorter than 10K. Pay the Share to get a full working version. The future of
this program depends on you.

