**** Documentation for Paladin / Proteus ****

Software and documentation Copyright (c) 1993-1994 John Dunn.
All Rights Reserved.


Hardware required: 

8086/286/386/486 IBM-compatible PC,  
Microsoft compatible mouse,  
EGA or VGA color display,  
1 or more Emu Proteus modules,
MPU-401 compatible MIDI interface, 
     or Key Serial MIDI interface.

Fully supports Wave Blaster and Vintage Keys variations. 

Operating under Windows:

Paladin is a DOS program.  It is not fully compatible with Windows. 
While it may appear to function properly when running in a DOS box
under Windows, there is a conflict with the MIDI input interrupt that
can cause errors when receiving MIDI data.  If read errors do occur,
the read countdown number will flash red.  Normally this is self
correcting, but if it persists you will get an error message.

After the initial download, Paladin no longer reads data from the
Proteus unless you select one of the download options in Create. 
The intent of this is to allow you to control multiple Proteus
modules without having to constantly switch MIDI inputs.  

This also allows you to run under Windows if you prefer,  after the
first time setup in has been done under DOS for each Proteus module,
and as long as you are not downloading from the Proteus. The
exception to this is the Wave Blaster, which must be downloaded
whenever the computer has been reset.   

Command line option:  PAL /reset 

This resets Paladin and gives you a chance to change the MIDI interface
and other setup options.  The existing DEFAULT files are renamed to
"PREVIOUS," and new DEFAULT files are built from a fresh download.

Overview:

Paladin is set up to manage up to 16 Proteus modules in a single
configuration.  Once a Proteus module is registered with Paladin (see
below), you can freely switch between Proteus modules or between
sound sets ("Setups").  Proteus modules are identified by the unique
Proteus ID number, which is set from the Proteus Global menu.  Setup
files may have the same name if you are running with multiple Proteus
modules and types; Paladin will manage the details.

Paladin is organized as six pages, each immediately accessible from a
top line menu.  The opening page is "SYSTEM" which roughly
corresponds to the Global menu of the Proteus module.  In addition to
Global Proteus settings, the SYSTEM page also has tools to change
Proteus preset files, to manage multiple Proteus synths, and to exit.

"TEXTURE," "CONTROLS," and "PATCHES," are groups of Proteus Edit menu
functions.  "TEXTURE" contains the most often used functions that
control sound texture: sample sources, envelope settings, LFO control
and volume.  "CONTROLS" contains the less often used settings such as
controller amounts, keyboard ranges, etc.  "PATCHES" contains the
various routings available.  

"LIBRARY" is the setup manager for both the Proteus user setup area
and for disk based libraries.  The full set of presets, both RAM and
ROM, are automatically setup as the default library; you may add to
that and modify it however you wish.  

"PROGMAP" gives you an easy way to do MIDI Program Change to Proteus
preset mapping.  It allows you to quickly arrange and rearrange the
preset mappings; it also makes it easy to audition the preset as you
select them.


Using the Mouse:

Virtually all Paladin functions are done by placing the mouse cursor
over the area of interest and depressing the left mouse button. 
Functions that have several possible values (more than three), are
set by holding the button down and moving the mouse left or right. 
For three or fewer choices, a single click will increment the
selection.  If you click on a function and it changes immediately, it
is a click-action function; if it does not change it is a
slide-action function.  

Action areas that you can select or change with the mouse are color
coded: commands are green and number values are white.  Other colors
are inactive information labels, etc.  Exceptions to this are the
sliders, which are sensitive throughout their range.

Automatic online help is available for all active functions.  If
"Help" in the center top of the SYSTEM page is on (the default), the
bottom of the screen will display a box with up to four lines of help
text as you move the cursor over active areas.  Non active areas are
commented simply as "Not an active area."

All input is with the left mouse button.  The right mouse button is
used only to play notes.  The Note Play mini-sequencer gives you
several optional methods of playing single notes or groups of notes
or note patterns.


Getting Started:

The first time you run Paladin you should have at least one of your
Proteus modules configured in a two-way link with the computer. That
is, the output of the Proteus should be connected to the input of the
MIDI interface, and the output of the MIDI interface should be
connected to the input of the Proteus.  This is automatic for the
Wave Blaster.  This two way connection is required only the first
time you register a Proteus module with Paladin.  After that you can
run Paladin without the MIDI input connection.
 
When Paladin first runs it tries to identify a connected Proteus
module.  If one is found, Paladin does the initial setup
automatically.  For additional modules, or if you first attempt to
run Paladin without a Proteus output connected to the MIDI interface
input, you can run "New ID" in the Files Box in the SYSTEM page. 
Paladin will look for new, unregistered modules, and will register
any it finds.

You can make additional Setups and Libraries with the "Create"
command, also in the Files Box.  You can download from any bank of
your Proteus (including ROM banks), or you can clone an existing
Library or Setup.  

Mini Sequencer:

Press on the dots to the left of the sliders to disable the slider
and give the function to the mouse position.  Left-right arrows give
horizontal mouse position control, up down give vertical.


The Edit Buffer:

The Proteus Synth module has a temporary "edit buffer" that is
essentially a nameless preset.  Any changes to the edit buffer are
lost whenever a MIDI Program Change command changes the current
preset.  Paladin makes use of this temporary buffer to allow you
to audition the changes you make to your Setup without actually
changing the presets in the Proteus until you really want to.

None of the editing changes you make with Paladin are actually sent
to the Proteus until you see the message box asking you if you want
to "Save, Discard, or Cancel."  Then, only when you select "Save,"
will a permanent change be made to the Proteus.  At that point, the
presets you have changed (and those only) are uploaded to the synth.

The main exception to this is "Keep" on the top right of the TEXTURE,
CONTROLS and PATCHES pages.  This is a single-preset Save.  Like
Save, it also asks for confirmation.  If you choose "OK," the current
preset (only) is sent out to the Proteus and the Setup file is
updated, turning off the highlighting that marks a changed preset.

Other exceptions are the Global settings, the User Tune Map, and the
Preset to MIDI Program Change map.  In the case of Global settings,
there are only a few and you generally want them to happen when
selected.  These are items such as channel enable and mix output, all
found on the SYSTEM page.  The User Tuning and Program Change maps are
sent as changed, but there is a Redo and a Reset function, so you
can't go far wrong.


ROM and RAM Preset Banks:

Proteus presets are arranged in banks of 64 each, any of which may be
writable RAM (Random Access Memory), or ROM (Read Only Memory).  Paladin
allows you to manipulate the ROM banks just as you would the RAM banks.
This is useful for examining the action of a ROM preset or for transferring
it to RAM so you can change an otherwise unchangeable parameter.

ROM presets can not be saved, therefore when you exit Paladin no warning
will be given asking you if you want to save a changed ROM preset.

Paladin indicates ROM presets in two ways.  First, the preset name
boxes in TEXTURE, CONTROLS, and PATCHES will be bright blue if the
preset is RAM and it will be magenta if the preset is ROM.  Second,
the LIBRARY page shows all the preset banks together as green or
white numbers.  Green are RAM banks and can be saved back to the
Proteus, white are ROM banks and cannot.

If you are using a Wave Blaster you can ignore the preceding.  The
Wave Blaster uses only RAM banks, so every preset can be saved.


Uploading Presets to Proteus:

After the first time you run Paladin, it will assume that you have
not changed the presets in your Proteus since the last time you ran
the program.  This is a great time saver because it doesn't have to
keep doing those redundant uploads.  If you have changed your
Proteus, simply click on the name of the Setup (in the Setup box) you
want to work with and Paladin will upload it to the Proteus.  If you
want to first save the changed presets use the "Create" function in
the Files box to "Download from Proteus" to a new Setup file.

The Wave Blaster is handled a little differently because it resets
all its presets to the default General Midi group whenever the
computer is restarted.  For the Wave Blaster only, Paladin
automatically uploads the most recent Setup whenever it detects a
"foreign" change in the Wave Blaster presets.  Generally you will get
a reload the first time you run Paladin after you have started your
computer, but not again for as long as the computer is on.


SYSTEM Page:

Proteus ID:

Grey= unregistered 
Green= registered
Yellow= current

Dots under indicate detected 2-way connections with Proteus.  Not
necessary but sometimes convenient.  A yellow uparrow indicates the
currently selected module has an input connection.

The main use for this area, once you have registered your module, is
to switch between modules.  Simply click on the ID of the module you
want to make current.  If you have made modifications to the current
setup, you will be given the choice of saving or discarding before
switching over to the selected module.

In addition to ID numbers, the there is a name that is common to
all of a particular Proteus module.  Proteus/1 is called PROT1,
Wave Blaster is called WBLST, etc.  The module names allow multiple
synths of the same type to share common library files.  Additionally,
each ID has an associated file extension that uniquely identifies
it.  This allows multiple synths, even of the same type, to have the
same Setup name.  The ID number, module name and setup file extension
are all displayed at the top right of the screen.

Library files (but not Setup files)	are stored in standard MIDI dump
format.  Commercial preset files, preset files available on the
various BBS's and the MIDI forum on CompuServe, normally will be
directly readable by Paladin.  All you need to do is to put them into
the Paladin Setups directory and rename them with the Setup extension
as described above, except use an "L" for the last character in the
extension to indicate to Paladin it is a library file.  A Proteus/1
library file would be named something like "NEWSTUFF.P1L" - such a
file would show up in the Library box in all Proteus/1 Setups.

Wave Blaster Library files are the exception.  They are given the
extension ".CBK" so they are directly compatible with the bank files
that come with the Wave Blaster.  Also if you have installed your
Wave Blaster Software and Paladin on the same hard disk, Paladin will
use the \WAVEBLST\WBPANEL directory for its Wave Blaster (only)
Library directory, otherwise it will use its own SETUPS directory.

Launch Box:

Allows you to register a program for launching from Paladin.  Useful
for rapidly switching between your favorite sequencer program and
Paladin, to fine tune your sounds as you work out the music.

Setup Box:

Click on the setup you wish to become current.  Paladin will save the
current setup and then load the new.  It takes a little while for the
MIDI upload, but it is all automatic.

Library Box:

Click on the Library file you wish to become current.  


Remarks Box:

Click on the green "Remarks" on the lower right corner to activate. 
Click again to protect the text.

Type to enter text.  
Del and Back arrow to erase. 
Home to go to upper left.
Ctl-Home to erase entire area.
Ctl-PgDn to insert a line. 
Ctl-PgUp to delete a line.
Ins key to switch between insert & overwrite.


Note Play Sequencer:

Change the 8 notes below the Remarks box by click & slide.
Right mouse button plays according to the setting list:

Actions:

on/off  Click to start playing (hold for continuous note), 
        click again to stop.
while   Plays as long as right button is depressed.
cycle   Cycles through the note pattern one time and stops.
single  Plays one note and stops.

Patterns:

random	Selects one of the 8 notes at random.
next    Select the next sequential note to play.
first   Only plays the first note.  When this option is selected
        while in the User Tuning Map (in "CONTROLS"), the note is
        automatically changed to whichever note you are tuning.
chords  Plays a major chord (3rd, 5th, & 8ve) with the note.

Other:

extrn   Switches to external midi, so you can use your keys.
        Anything that generates MIDI key data can be used, keyboard,
        sequencer, whatever.  Just connect it to the MIDI input of
        your MIDI interface.

All-Notes-Off
        All notes off on all channels, for those moments of panic.


TEXTURE Page:

Instrument name:  Type to change name.  Ins & Del, Left & right
arrow; ctrl-home clears all text.

Mouse:  Click & slide to change inst number.  Click on top and bottom
of box to increment, decrement.  Click on right edge to insert next
sequential number to the rightmost part of name, left edge to remove
the number.
    

Pri & Sec Instrument: 

Click on left edge to turn off the instrument, again to return
to it.


CONTROLS Page:

Click on left edge of Preset Links to switch between current link and
no link.

PATCHES Page:

The top part of the PATCHES page is a diagram of the Proteus Synth
functions.  The bottom part of the page contains the three groups of
patch connections.  As you make patch changes the diagram labels will
highlight to show you their position in the Proteus.  This is
especially useful for helping to understand how a preset has been
patched and what the patches can be expected to do.



LIBRARY Page:

To change Preset banks, click on the bank number.  RAM presets
are colored green, ROM presets are white.

To move the window into the Library file, slide on the smiley at the
bottom of the screen or click on the arrows on the bottom left and
right of the smiley line.  Arrows will adjust the window to steps of
16 presets to make visual scanning easier.

When Action is "Safe:"

Click on any name to make it the current sound source.

When Action is "Edit:"

Click on the number, or the left edge of the box to make a preset the
current sound source.

Click on a name, or click and drag for multiple names, to make them
the source of an edit operation.  Click on the place you want them to
go to and they will.

You can freely select source and destination from anywhere to
anywhere.  If source and destination are the same area, the
Insert/Overwrite Mode is ignored, and a lossless rotate/move is done.

If you select an area in the Library box, you have the option to
Insert or Delete the space in the file.  This actually makes the
Library file shrink or grow.


PROGMAP Page:

This page manages the Proteus preset to MIDI Program Change mapping. 
To remap a function you can either dial it in or you can click (or
click and drag for multiple selections) on the name you want to
remap, then click on where you want it to go.

The highlighted number is the current preset that will be played when
you click on the right mouse button.

Reset From:

Will sequentially reset all presets starting from the one in the box,
which is always the last one you selected.  This function is handy
for doing a top-to-bottom remap.  


Save Fetch 1234:

Any changes you make to the Preset Map will automatically be saved as
part of your current setup.  Although the Proteus only allows one 
map, Paladin maintains four.  To make a map current, simply click on
one of the four numbers.

Save and Fetch use an unnamed file to allow the maps to be transferred
from one location to another, to another Setup, or even to another
Proteus of the same type. Save sends the map to the file, Fetch reads
from the file.  The current map is overwritten but may be restored
with "Redo."  Since all Setups use the same unnamed file, you should
not use it for permanent storage.

DISCLAIMER OF WARRANTY:

THIS SOFTWARE IS SOLD "AS IS" AND WITHOUT WARRANTIES AS TO
PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER
EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE
ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF
FITNESS FOR A PARTICULAR PURPOSE IS OFFERED.  THE USER MUST ASSUME
THE ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER
WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
PURCHASE PRICE.

Copyright Notice:

Paladin is Copyright (c) 1993-1994 by John Dunn.  All Rights Reserved.
Forth nucleus Copyright 1989 LMI.

[end of document]
