PATCHWORK Ver. 1.13
-------------------

PATCHWORK is capable of creating synthetic instruments (patches) for the
Gravis Ultrasound card. It is not a very user friendly or nice-looking
program, I admit, and therefore I am planning a "lite" Windows-version of
it, but it may take a while to put this together.

These are some of the features of the DOS-version:
- Triangle, square and sawtooth modulation with the ability of mixing these.
- Sinemodulation with up to 20 overtones.
- White noise modulation.
- Special effects including copy, move, exchange and erase features.
- Mixing or appending patches.
- and much more....

PATCHWORK is FREEWARE. You are encouraged to distribute it to anyone, that
might be interested and it is allowed to put this program on any BBS or CD-ROM
(shareware/freeware), as long as all the files listed in the file list below
are distributed. The patches created with this program are, of course, also
free to use for anyone.

This program is specially made for VGA. If you have another type of screen,
the graphic output might look strange, and "Userdefinable patch" may not work.

FILE LIST
---------
PATCHWRK.EXE  The main program.
PWNONE.BAT    Starts the program with no release and no vibrato as default.
PWVIB.BAT     Starts the program with vibrato, but no release as default.
PWREL.BAT     Starts the program with release, but no vibrato as default.
PWVIBREL.BAT  Starts the program with both release and vibrato as default.
PWLONG.BAT    Starts the program with release. Makes long patches.
PW.BAT        Same as PWREL.BAT . Try changing the 19 parameters in this
              file to figure out, what possibilities that will be revealed
              then. The first three are vibrato parameters, the next three
              tremolo parameters and the last twelve are attack, decay,
              sustain and release parameters. (The format of these are not
              fully uncovered, but try them out).
*.BGI         Graphic drivers (from Turbo Pascal 5.5).
PATCHWRK.ENG  English help file with instructions.
PATCHWRK.TXT  Danish help file with instructions.
README.TXT    This file.
LAESMIG.TXT   The danish version of this file.
PATCHWRK.COL  Colour setup. (See PATCHWRK.ENG for details).
PATCHWRK.MID  Midi-file to be used to hear the created patch.
PATCHWRK.CFG  Configuration file for PATCHWRK.MID.
PATCHWRK.DEF  Temporary file that PATCHWORK is using.
PW-SCALE.MID  Tone scale Midi-file. (Could replace PATCHWRK.MID, when this
              starts getting at your nerves).
PATCHWRK.PAT  This is a temporary patch file, that is created by PATCHWORK,
              when you do not enter a patch name. It is only used to permit
              playing a demo midi-file with the last created patch.
PWDEMO.MID    A little demo file using the following seven patches created
              with PATCHWORK. (All the demo patches have been created using
              the default length, 1, except for PWDEMO7+8.PAT, which have
              been created using the lengde 24).
PWDEMO1.PAT   Created with PWREL.BAT:
              This patch has been created by appending five patches.
              X1.PAT  Sine   Overtone : 1    ...  Power : -2
              X2.PAT  Sine   Overtone : 1    ...  Power : -1.75
              X3.PAT  Sine   Overtone : 1    ...  Power : -1.5
              X4.PAT  Sine   Overtone : 1    ...  Power : -1.25
              X5.PAT  Sine   Overtone : 1    ...  Power : 1  (same as -1)
              These have then been appended by using "User definable patch":
              File name - out : Y1       File name - in : X1 X2 +
              File name - out : Y2       File name - in : Y1 X3 +
              File name - out : Y3       File name - in : Y2 X4 +
              File name - out : PWDEMO1  File name - in : Y3 X5 +
              Before saving PWDEMO1, the last page of the patch is
              chosen using <END>, the line cursor is moved to the first
              X-position of this page using <CTRL><Arrow Left> and <Enter>
              is pressed to set the beginning of the period of this patch
              to this place. The patch is then saved using <Esc>.
              (The X?.PAT's could be erased afterwards).
              This patch gives a very rough (guitar-like) attack because
              of the double modulated patches (the first four). The last
              patch is the most harmonic of them all : A sine wave, which
              ends the patch (here the release part) very harmonic.
PWDEMO2.PAT   Created with PWVIB.BAT:
              This patch has been created by appending nine (!) patches.
              X1.PAT  Triangle  Symmetry : 90    Power : 5
              X2.PAT  Triangle  Symmetry : 80    Power : 3
              X3.PAT  Triangle  Symmetry : 70    Power : 2
              X4.PAT  Triangle  Symmetry : 60    Power : 1.5
              X5.PAT  Triangle  Symmetry : 50    Power : 1
              X6.PAT  Triangle  Symmetry : 40    Power : 0.8
              X7.PAT  Triangle  Symmetry : 30    Power : 0.6
              X8.PAT  Triangle  Symmetry : 20    Power : 0.4
              X9.PAT  Triangle  Symmetry : 10    Power : 0.2
              The patches are appended just as PWDEMO1.PAT .
              Period is also here set to the last page of the patch.
              Before saving the vertical cursor (the arrow at the left of
              the graphic screen) is set to 20. Then <F2> is pressed. This
              effect is using a sine function to double modulate the patch,
              and the level 20 gives some extra amplitudes in the sound,
              which is then made a little rougher than it would have been.
              The last patches have more volume than the first. Therefore
              a tone played with this patch will start at a lower volume
              and this will increase (in this case almost unhearable).
              The instrument will then give a more harmonic impression.
PWDEMO3.PAT   Created with PWREL.BAT:
              This one is a little easier than the first two patches.
              PWDEMO3  Sine  Overtone : 1  ...   Power : -0.5 2
              This patch is put together by two different powers giving
              a almost harpsicord-like instrument sound.
PWDEMO4.PAT   Created with PWREL.BAT:
              PWDEMO4  Sine  Overtone : 1  ...   Power :      ( -> 1 )
                             Overtone : 2  ...   Power : 0.8
                             Overtone : 3  ...   Power : 0.6
                             Overtone : 4  ...   Power : 0.4
                             Overtone : 5  ...   Power : 0.2
              Creates a patch having a sound characteristics as a hammond
              organ. (This patch is although created with "release").
PWDEMO5.PAT   Created with PWREL.BAT:
              PWDEMO5  Triangle  Symmetry : 20 40   Power : -0.4 2
              Symmetry 20 40 means that this patch is put together using
              two different symmetries. Power -0.4 2 means that also two
              different powers are used. The sign preceding 0.4 tells that
              the powers will be toggled every 1/4 period. You ought to look
              at the sound characteristics using "User definable...". This
              tells a lot more than my descriptions.
PWDEMO6.PAT   Created with PWVIBREL.BAT:
              TEST1  Triangle  Symmetry : <50   Power : 0
              User definable ... TEST1 - 30 2
              This affords some explanation, I bet!!!
              At first a patch, TEST1.PAT, is created. This patch is a
              square wave patch, that has an offset of 1/4 period. (The
              < -sign means this). This has meaning because we intend to
              mix this sound with itself and so we do using "user definable".
              TEST1 is the name of the first patch.  -  means that we would
              like the same patch as second patch. It would have been the
              same, if we had written TEST1 twice, but why tap more than
              necessarily. 30 means that the second patch is mixed with an
              influence of 30 (percent), which leaves the rest (70) to the
              first patch. 2 means that we are mixing the 2nd overtone
              of the last patch into the first.
              The result is a stair-like sound characteristics. (See for
              yourself in "User definable..."). It is good for a very raw
              bass.
PWDEMO7.PAT   PWLONG.BAT is used for this one.
              This startup-file sets the length parameter to 24, giving a
              patch length of 10135 bytes. This is necessary when (almost)
              real white noise is wanted.
              Some white noise is created to a patch file called TESTNOIZ.
              Then this file is edited in "User definable..." to PWDEMO7
              by decreasing y-level to -70 using <Del>. Then <F1> is pressed
              raising this sound to a power much lesser than 1. When doing
              this with white noise, it becomes more dynamic. Afterwards
              increase y-level to -1 and press <Ctrl><F11>. Then a frequency
              related Tremolo-effect is added. Volume is increased and
              decreased repeatedly. This is the very synthetic drum patch
              in the demofile PWDEMO.MID .
PWDEMO8.PAT   Not used in PWDEMO.MID - created with PWLONG.BAT :
              PWDEMO8  Sine  Overtone : 1    ...   Power :   (default : 1)
                             Overtone : 1.25 ...   Power :
                             Overtone : 1.5  ...   Power :
                             Overtone : 2    ...   Power :
              Gives a major chord, because of the relationsship between the
              overtones.
PWDEMO9.PAT   Not used in PWDEMO.MID - created with PWVIBREL.BAT :
              PWDEMO9  Triangle  Symmetry : -20   Power : 0.6
              A very harmonic synth-piano with vibrato is the result.

Hopefully you will like PATCHWORK...

If you have any comments on this program, you are very welcome to contact
me in one of the following ways:

Internet: husted@login.dknet.dk               Michael Husted
Fidonet:  2:236/78.58 (probably won't work)   Hjagerparken 95, 2.
                                              DK-2750 Ballerup
Phone:    +45 44 68 30 08                     Denmark






