                       Diversi-Tune(tm)
                        By Bill Basham
                         Instructions
                   Version 0.1 (Preliminary)
                           5/20/88

DEMO DISK 

The purpose of this demo disk is to convince you that Diversi-Tune
is the fantastic program I said it was in my ads.  You can use it
to play the song, "Grand Old Flag", and as a live MIDI synthesizer.
When you send in your $55 for the program disk, you'll get a 3.5
Diversi-Tune disk with the latest program update, and with all
the powerful features of Diversi-Tune working.  You'll also be
on our mailing list for updates, and there are a lot of great
new sounds and features on the way for Diversi-Tune!  Here's
a short version of the documentation you will get with Diversi-Tune:

*****
Introduction
*****

The Diversi-Tune program is like a videocassette recorder (VCR).
Most people will use Diversi-Tune to play back pre-recorded songs,
just like most people use their video recorders to watch pre-recorded
movies.  You'll be able to buy Diversi-Tune pre-recorded song disks
from a variety of sources, just like you can buy video movies by mail
or at the local video store.  Using Diversi-Tune to play back
pre-recorded songs is just as simple as putting a video cassette in
your recorder and playing it.  The first part of these instructions
describes how to do this.

A few people actually use the record button on their video recorder.
This takes a little more effort, but you can then record movies off 
the air when you're not home, fast-forward through commercials, and 
do all kinds of fun things.

Diversi-Tune also has a record button, and fast-forward, rewind, etc.
You'll notice the Diversi-Tune tape recorder controls are always
present at the bottom of the screen.  The second part of these
instructions describes how to use some of these more advanced
features of Diversi-Tune.

Finally, some people buy video cameras and use their VCR to make 
their own home "movies".  These may not look or sound as good as 
pre-recorded cassettes, but they're much more meaningful to the 
person who made them.

With Diversi-Tune, you can buy a "MIDI" music keyboard and interface, 
and connect it to your Apple //gs.  This will allow you to record 
your own songs.  The third part of these instructions describes how 
to do this.

*****
Hardware Requirements
*****

                  512K Apple //gs

Diversi-Tune requires a 512K Apple //gs, which is the standard memory
configuration currently shipped by Apple.  Diversi-Tune will use more 
memory to be able to load longer songs, but I haven't seen a song 
that doesn't fit into 512K, so far.

*****
Hardware Options
*****

                  External Speakers

To fully appreciate the incredible sound quality of Diversi-Tune, 
you have to connect it to a set of external speakers.  Your Apple
dealer can sell you a pair of amplified Bose Roommate speakers, which
match the Apple //gs, and sound great.  Alternatively, if you already
have a stereo system near your computer, you can just buy a
mini-stereo to RCA phone plug adapter cable and connect your Apple
//gs to the "aux" input of your amplifier.

                     Stereo Card

Another hardware option I highly recommend is a stereo card.  These
cards cost around $50, and will let you hear the incredible stereo
effects produced by Diversi-Tune.  Here are the 3 cards I recommend, 
along with their advantages and disadvantages.

Applied Visions (G Stereo) 800-346-0811 or 818-960-1485
 Good physical construction. Very nice people own this small company.
 Poorly shielded audio cable produces some hum when next to my
  RGB monitor.  Input digitizer under development.

MDIdeas (Supersonic) 415 573-0580
 Good sound quality. Input digitizer available (I used it to input
  the Diversi-Tune sounds).
 Poor physical construction.  My connector cables broke off the card
  and I had to re-solder them.

Applied Engineering (card announced, not shipping yet) 214-241-6060
 Good company reputation for quality and support.
 May have a volume control option, which I'll have to add support
   for, in the next update.
 Digitizer input promised.

                  MIDI Interface and Keyboard

MIDI stands for "Musical Instrument Digital Interface".  The best 
place to learn about MIDI is a music store, not a computer store.  
Ask a music salesman to explain MIDI, and buy an introductory book on 
MIDI from him.

A MIDI interface allows you to connect the Apple //gs to an external
music keyboard.  You'll need this combination if you want to record
your own music into Diversi-Tune.  Also, most music keyboards can 
generate their own sounds.  You can play these sounds with 
Diversi-Tune as well.

Diversi-Tune supports two types of MIDI interfaces.  I recommend you 
buy the one from Apple, called the Apple MIDI Interface, available 
from your Apple dealer.  It lists for $100, and plugs into the modem 
or printer port in the back of the //gs.  With Diversi-Tune, you can 
actually connect and use two interfaces at once, one to the printer 
port, and the other to the modem port of your //gs.

If you've got a modem and printer connected to your ports, you'll 
need a switch to avoid having to unplug the modem every time you want 
to use your MIDI keyboard.  Under these circumstances, your best bet 
may be to buy the Opcode Studio Plus Two Interface, which lists for 
$275 (Opcode Systems 415-321-8977).  It was designed for the
Macintosh+, but works great with the //gs.  It has two MIDI
interfaces, which connect to the modem and printer ports, with front
panel switches so you can use your modem and printer, too.  It's all
the interface you'll ever need!

The other type of interface plugs into a slot inside the //gs, and 
was designed for the old Apple //e.  If you've already got one, you 
can configure Diversi-Tune to use it.  I don't recommend buying this 
type of interface, however.

*****
Playing Pre-recorded Songs
*****

It takes 3 steps to play a song with Diversi-Tune.

                    Step 1.  Load The Song

Choose menu option #1 from the Diversi-Tune main menu to choose which
song you want to load.  You should see a list of the available songs
which you may choose.  If you see the song you want in the list, use
the arrow keys, or move the mouse, until the song is highlighted.
Then, press <return> or the mouse button to load the song.

Some of the entries in the song list may look like this:

--> SONGS

If you select this type of entry, and press <return>, you should see
a new "sub-list" of songs (actually a ProDOS sub-directory).

Finally, the first entry of each song list looks something like this:

<-- DSR6
 or
<-- (New Disk)

Select this first entry to go back to a previous song list, or to 
load a song from a different disk.

To play a song on a different disk, remove the Diversi-Tune program 
disk and insert your song disk.  Then, choose the "<--New Disk"
entry.  You should see a list of all the disks connected to your
system.  Choose the song disk you inserted, and you will see a new
list of the songs on that disk.

Note: After you boot the Diversi-Tune program disk, you can 
immediately remove it and insert a new song disk, if desired.
Diversi-Tune is a "single-load" program, which allows you to use it 
easily on a one-drive system.

                Step 2.  Choose a Screen Display

Actually, you could skip this step, but you probably want to watch 
something more interesting than the main menu, while your song is 
playing.  Select option #2 (Display Options), from the main menu.  
Then, select one of the screen displays listed.  You can change 
displays while a song is playing, so try all the display types 
whenever you feel like it.

                     Step 3.  Play The Song!

Start the song by pressing the "*" key on the keypad.  That was
simple!  You can stop the song any time, by pressing the keypad "/" 
key (I can't keep my 3-year-old son away from this key!).

The bottom screen line shows the status of the Diversi-Tune tape 
recorder controls.  To control the tape recorder, you hold down the 
open-apple key and press one of the arrow keys.  To avoid having to 
hold down the open-apple key, I duplicated the tape recorder controls 
on the KEYPAD.  The top 4 keys on the keypad correspond to the 4 
open-apple arrow keys.  Here are the open apple keys, and their 
keypad equivalents:

Open-Apple      Keypad          Function
----------      ------          --------
<--             <clear>         Rewind 1.28 seconds
-->             =               Fast forward
<down>          /               Stop
<up>            *               Play
 -              -               Pause (Play to re-start)

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

All those "+++" signs mean I'm about to shift gears and talk a little 
more technically.  If you're content just to play back pre-recorded 
songs (and you'll be like most people, I suspect), please stop 
reading here.  To get a lot more out of Diversi-Tune takes a 
little more effort, but I think you'll find it worth it!

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

          Diversi-Tune      Special Playback Features

*****
Pause
*****

Press the keypad "-" key, or open-apple "-" on the keyboard to pause. 
This key is the "Pause Button".  To start again, press the "play" 
button (keypad "*").

To advance one note at a time, press the pause button again.  Each 
time you press pause, you'll go to the next note in the song.

You can modify the pause action by pressing open-apple-W, for "Word 
Pause".  Now, pressing pause will advance one word in the song.  Try 
this while viewing the words display.  To go back to "Note Pause", 
press open-apple-N.

*****
Fast Forward
*****

This is the keypad "=", or open-apple -->.  Press this key to double 
the speed of playback.  Press it again for 4 times speed, and so on.  
Press the play button to go back to normal speed.

*****
Rewind
*****

Rewind is the keypad <clear> or open-apple <--.  Each time you press 
this key, you'll go back 1.28 seconds in the song, and enter pause 
mode.  Press play to re-start the song, or press rewind again to go 
back another 1.28 seconds.  If you hold down the rewind key, it will 
repeat and you'll continue going back in the song.  This works faster 
if you increase the key repeat speed to maximum in the //gs control
panel before running Diversi-Tune.

You can use fast-forward and rewind to find any spot in a song very 
quickly.  You'll notice that the time in seconds from the start of 
the song is always displayed in the lower left of the screen, to help 
you tell where in the song you are.

*****
Tempo Changes
*****

To change the tempo any time, press open-apple-T.  The bottom line
shows you what keys you can press after that, to vary the tempo.  The
<-- and --> keys decrease and increase the tempo.  The up and down
arrows give a more coarse adjustment.  Press <return> when you get to
the desired tempo.

The tempo value is shown in the bottom right corner of the screen
during tempo changes.  This is a relative tempo value.  A value of 
1.0000 means you're playing the song back at the same speed the 
musician recorded it.  A value of 0.5000 means you're playing at 1/2
the original speed, and 2.000 means your going twice the original
speed.  This is equivalent to having a variable speed tape recorder
(where the pitch doesn't change).  That is, the Diversi-Tune tempo
control is really a "playback speed" control.  The musician sets the
tempo of the song when he records it.  Diversi-Tune lets you speed up
or slow down the playback, while keeping the tempo variations
recorded into the song intact.

*****
Key Changes
*****

Oops, I didn't finish this one yet!  It will be in version 1.0, so 
keep the faith.  You'll press open-apple "K", and use the arrows to 
go up or down one half-step at a time.  This will help you to sing 
with any song, without straining your voice trying to hit notes that 
are too high (or too low)!

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Sorry! There's no room on the demo disk to put any more of the
documentation.  Take my word for it, the Diversi-Tune MIDI recorder
and bouncing ball recorder are fantastic!  The real disk also has a
more pre-recorded songs on it, including:

Give My Regards to Broadway
He's Got the Whole World in His Hands
Over the River and Through The Woods
Turkey in the Straw
I've Been Working on the Railroad
La Cucaracha
Deck the Halls
Havah Nagilah
Bicycle Built for Two

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
               Diversi-Tune Ordering Information
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

To order Diversi-Tune, send $55 to:

 DSR, Inc.
 34880 Bunker Hill
 Farmington, MI 48331-3236     (our zip code was changed recently)

We accept personal checks, company or school purchase orders, and
Visa or Mastercard with expiration date (sorry no C.O.D.).  You can
also call our toll-free number to order:  1-800-835-2246 ext.  127

The price includes first class or foreign airmail shipping.

The site-license fee is $550.  That is, for $550 you can use 
Diversi-Tune on all computers in a local school district, or owned by
a single company, within a 50-mile radius.

                       Diversi-Tune(tm)
                   Copyright 1988  DSR, Inc.
            All Songs Phonocopyright 1988 DSR, Inc.
                      All Rights Reserved

Unlike some of our other programs, Diversi-Tune is not a "shareware"
program, and may not be copied except for back-up use by the original
purchaser.  We do sell a demo disk for $2 (or $5.00 by phone or
foreign), which includes the full documentation, and will play one of
the songs on the program disk.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

      Other Apple //gs Programs Available From DSR, Inc.

*** Diversi-Cache ***

The Diversi-Tune program disk contains our disk speed-up program, 
Diversi-Cache.  When you exit Diversi-Tune, Diversi-Cache will remain 
active until you turn the power off on your computer.  Try booting 
the //gs system disk after running Diversi-Tune, and you'll notice 
the improvement.  To legally use Diversi-Cache with other programs, 
besides Diversi-Tune, please send $35 payment.

Diversi-Cache dramatically increases the I/O speed of the Apple Disk
3.5, under any operating system (ProDOS, Pascal, DOS 3.3).
Diversi-Cache speeds up the Disk 3.5 in two ways.  First of all,
whenever the system reads a block, Diversi-Cache actually reads an
entire track.  This triples the speed of disk reads, and doubles the
speed of ProDOS writes.

Secondly, Diversi-Cache allows you to allocate a cache memory buffer
from 0 to 800K in size.  Whenever the system reads a block,
Diversi-Cache saves it in the cache buffer.  If the system asks for
this block again, it comes out of memory at "Ramdisk" speed.
Diversi-Cache only speeds up the Apple Disk 3.5 designed for the
Apple //gs, and will not affect the speed of the older Apple //c
compatible UniDisk 3.5.

*** Diversi-Copy ***

Diversi-Copy(tm) is the fastest and easiest way to make back-up
copies of your 3.5 and 5.25 disks.  Diversi-Copy will use all
available memory in an Apple //gs, //e, //c, or II+ compatible to
allow 1-pass copying with a single drive.

Diversi-Copy was chosen as inCider magazine's "Editors' Choice".  It
is the best copy program available, for both 5.25 and 3.25 drive
copying.

*** Diversi-Key ***

Diversi-Key is a keyboard macro program for the Apple //GS that will
work with any program that allows interrupts.  This includes programs
that run under Pascal, ProDOS, or DOS 3.3.  Diversi-Key works with
Appleworks 2.0, as well as most other programs.

Diversi-Key sends macro keystrokes as if you had typed them at the
keyboard, so you don't need to modify your programs to work with
Diversi-Key.  Diversi-Key allows you to add an almost unlimited
number of custom functions to any program.

Diversi-Key includes a flexible way to program the mouse to work with
any program, as well as date and time macros, nested macro calls,
nested repeat, IF, and WHILE conditional loops, and much much more.

*** How to Order ***

To order, please send your check to:

DSR, Inc.
34880 Bunker Hill
Farmington, MI 48331-3236

The cost of our programs is as follows:

Diversi-Copy    $30
Diversi-Cache   $35
Diversi-Key     $45
Diversi-Tune    $55
