======================================================================
Installation Guide

	Cakewalk Pro Audio DEMO

======================================================================

$Date:   21 Sep 1995 12:10:44  $

Information in this document is subject to change without notice and
does not represent a commitment on the part of Cakewalk Music Software

Copyright (c) 1991-1995 by Twelve Tone Systems.  All rights reserved.

Program Copyright (c) 1991-1995 by Twelve Tone Systems.  All rights
reserved.

Cakewalk, Cakewalk Express, Cakewalk Home Studio, 
Cakewalk Professional, Cakewalk Pro Audio, Musician's Toolbox,
Virtual Piano, Cakewalk Music Software and Cakewalk Music Software
are trademarks of Twelve Tone Systems, Inc.

Microsoft, the Microsoft Logo, and MS-DOS are registered trademarks
of Microsoft Corporation.  Windows is a trademark of Microsoft
Corporation.

Other names are trademarks or registered trademarks of their
respective owners.

Mailing address:
  Cakewalk Music Software
  P.O. Box 760
  Watertown, MA 02272-0760
  U.S.A.

Phone numbers:
                   Sales: (800)234-1171, 24 hours
            Dealer Sales: (800)887-6434, 9 AM to 6 PM EST, M-F
   FAX-BACK Info Service: (800)370-6912, 24 hours
  International FAX-BACK: (617)431-9412, 24 hours
        FAX registration: (800)760-1605, 24 hours
                Business: (617)926-2480, 9 AM to 5 PM EST, M-F
       Technical Support: (617)924-6275, 10 AM to 6 PM EST, M-F
   Technical Support FAX: (617)924-6657, 24 hours

Computer net forums:
              CompuServe: MIDIAVEN
                Internet: 74774.1773@CompuServe.com
        WWW (unofficial): http//www.isvr.soton.ac.uk/people/ccb/cakewalk

======================================================================
****************************** IMPORTANT *****************************

This file is for users downloading the Cakewalk Demo from a BBS.

To use the demo, you must have an MPU-401 compatible or other MIDI
interface or sound card with a Windows Multimedia Extensions MIDI
driver.

To use the audio features of this demo, you must have sound card that
is compatible with the Windows Multimedia Extensions, or a Digidesign
Session8 system.

The demo requires Windows 3.1x or Windows 95. If you are planning to
record digital audio, a 486/33 with 8 MB RAM is required. A 486DX/66
with 16 MB RAM is recommended.

The demo lets you load and play files, but is limited in that you
may not save or print files.

THE DEMO MAY BE COPIED AND DISTRIBUTED FOR FREE, BUT NOT RESOLD.
THIS DEMO SOFTWARE IS PROVIDED FOR PROMOTIONAL PURPOSES ONLY, AND
UNDER NO WARRANTY OF ANY KIND.


======================================================================
PREPARING A TEMPORARY INSTALLATION DIRECTORY FROM THE .ZIP FILE

To make downloading easier and faster, all of the installation files
are packed in a single .ZIP file.  Use PKUNZIP to unpack the files to
a temporary directory on your hard drive.

IMPORTANT: The temporary directory will contain the SETUP program
and a variety of compressed installation files.  These files are
useless by themselves.  You must run SETUP so that it can uncompress
the files, copy them to the correct locations on your hard drive, and
perform other important installation tasks.  Please do not try to
uncompress or copy files yourself; let SETUP do this.

You will want to delete the directory after you are done, because you
won't want the installation files and SETUP lying around.

So, to summarize:

	(1) Make a new, temporary directory on your hard drive.
	(2) Unzip the .ZIP file to that directory.
	(3) Be sure to tell SETUP to install to a DIFFERENT directory --
	not the temporary directory where you unzipped the files.
	(4) Delete the temporary directory when done.
	
Step (3) is important because you don't want to end up with the
uncompressed files and the compressed installation files all mixed
up together.  SETUP proposes that the demo be installed in a specific
directory, so if that's fine with you, create your temporary installation
directory (with a name like C:\TEMP or some other name) and you'll be
all set.

======================================================================
INSTALLATION

Installing and setting up the Cakewalk Demo is easy, but it is
important that you follow these instructions completely or the
program may not operate correctly.

Please print these instructions so that you may more easily perform
the installation.


=== 1.  INSTALL WINDOWS CORRECTLY

Before installing Cakewalk, you should make sure that you've
correctly installed Windows 3.1x or Windows 95.

Try some of the sample programs that come with Windows.  If you
experience any problems, try to resolve them through Microsoft
Technical Support before proceeding to install Cakewalk.
Generally, it is easier for you to solve one problem at a time, and
it will be much easier for us to help you if you have a reliable
Windows installation.

Avoid old Windows video and printer drivers:  Third party hardware
manufacturers are constantly updating and improving their Windows
drivers.  Older drivers may be less efficient or may have problems.
This is especially true for many of the drivers included with the
original version of Windows 3.1.  Often, what appears to be a
problem with Cakewalk is traced to a Windows driver.  Contact the
manufacturers directly for information on their latest Windows
drivers.


=== 2.  RUN CAKEWALK DEMO SETUP

1. Start Windows.

2. If you are installing from a diskette (not from .ZIP file),
insert the Cakewalk disk 1 in the drive, and close the drive
door.

3. From Windows Program Manager, open the File menu and select the
Run command.

4. In the dialog box, type A:SETUP, and press ENTER.

Note: If you put the installation disk in drive B:, then of course
you need to enter "B:SETUP".  Or, if you made a directory on your
hard drive for the installation files, enter the pathname to SETUP.
For example, if you made a C:\INSTALL directory for SETUP and the
other installation files, enter "C:\INSTALL\SETUP".

Note: The SETUP program may take up to two or three minutes to load
from the floppy disk.

5. Follow the instructions on the screen.


=== 3.  READ README.WRI

Cakewalk SETUP installs an icon for the README.WRI file.
Double-click on this icon to run Windows Write and load the Cakewalk
README.WRI file.  This file contains important information about
changes or additions after the documentation went to press.

Please read it!



=== 4.  INSTALL A DRIVER

If you've already installed Windows 3.1 multimedia MIDI or sound card
drivers, you may skip this section.

Cakewalk uses the Multimedia Extensions in Windows 3.1 to talk to MIDI
interfaces and sound cards.  The Multimedia Extensions provide a way
for applications to talk to different kinds of MIDI interfaces and
sound cards through drivers.  For Cakewalk to work with your device,
you must install a driver.

Use one of the drivers that is included with Windows 3.1 (for
example, MPU-401 or Sound Blaster), or, install a driver that is
provided by the manufacturer.

1. Run the Windows Control Panel program.

2. Double-click on the "Drivers" icon.

3. Press the Add button.

4. Select a driver from the list.  If your MIDI or sound card device
came with a diskette containing a Multimedia Extensions driver,
select "Unlisted or Updated Driver" and insert the driver diskette
when prompted.

Note: The Cakewalk diskette may include one or more drivers.  Please
see README.WRI for up-to-date information.  (README.WRI was just
discussed in the previous section.)

5. The driver will probably present you with a dialog box in which
you need to give it information about how you've installed the
device.  (This is the same dialog box that you can access in
"Drivers" by selecting the driver and pressing the Setup button.)
Please consult the manufacturer's manual for the correct device
settings.  If you haven't changed the factory-default settings on the
device, then you probably don't need to change the default values
proposed in the dialog box.

6. Press OK to finish configuring the driver.  At this point, you
should restart Windows for your changes to take effect.



=== 5.  CONNECT YOUR MIDI EQUIPMENT

If you are using a MIDI interface (like an MPU-401 or Sound Blaster
MIDI option) with an external MIDI keyboard, then you need to connect
the equipment using MIDI cables.

It is possible to connect your equipment in some pretty complex ways
that may cause problems.  We recommend the following methods, which
are simple.  In fact, if you call for technical support with a
problem where equipment doesn't seem to be responding, most likely
we'll suggest that you reconnect things this way before exploring the
problem further.

There are two basic methods.  Pick one depending on whether your
keyboard has:

 - all three MIDI jacks: IN, OUT and THRU.

 or
 
 - only two MIDI jacks: IN and OUT.

IF YOUR KEYBOARD HAS A MIDI THRU JACK

If your keyboard has three MIDI jacks - IN, OUT and THRU -- then use
the following check-list:

Connect this             to this
----------------------   --------------------------------
Master keyboard OUT      MIDI interface IN
MIDI interface OUT       master keyboard IN
Master keyboard THRU     another MIDI module's IN
that MIDI module's THRU  yet another MIDI module's IN

and so on, repeating the last connection for each of your sound modules.

If you are a more-advanced user working with a synchronization device
that needs to be connected to the MIDI interface's In jack, then you
should follow the instructions included with the synchronization
device.

Note: If your master keyboard now seems to double notes (they sound
"thicker" or you can only play half as many at once) see
"Trouble-shooting" later in this Installation Guide.

IF YOUR KEYBOARD DOESN'T HAVE A MIDI THRU JACK

If your keyboard has only two MIDI jacks -- IN and OUT -- use the
following check-list instead:

Connect this             to this
----------------------   --------------------------------
Master keyboard OUT      MIDI interface IN
MIDI interface OUT       sound module IN
sound module THRU        master keyboard IN

If you have more than one sound module, connect the additional sound
modules in between the MIDI interface OUT and the master keyboard IN.

Note: If your master keyboard now seems to double notes (they sound
"thicker" or you can only play half as many at once) see
"Trouble-shooting" later in this Installation Guide.


=== 6.  CONFIGURE YOUR AUDIO HARDWARE

=== CONFIGURING A SOUND CARD

(If you are using the Session8, you should skip this step, and instead
follow the directions listed below, CONFIGURING THE SESSION8.)

If you are using a sound card, you should run Wave Profiler before
running Cakewalk Pro Audio Demo for the first time.  Double-click on
the Wave Profiler icon, and follow the instructions.

Special Note for Windows 95
---------------------------
In some situations, Windows 95 will install an extra SoundBlaster
Compatible wave driver.  This extra driver will prevent the Cakewalk
Pro Audio Demo from working properly, and must be disabled.  To
disable it, do the following steps.

  1. Click on the Multimedia icon in the Control Panel.
  2. Select the Advanced tab in the dialog box.  You should see a tree
     view of all the multimedia devices that are installed in your system.
  3. Expand the line labeled Audio Devices.  If doing this does not
     reveal a line named something like SoundBlaster Compatible, you've
     nothing more to do.
  4. Select the SoundBlaster line.
  5. Click on the Properties button.
  6. Click on Do not use audio features on this device, and press [OK].
  7. Exit Control Panel, and restart your machine.

=== CONFIGURING THE SESSION8

(If you are using a sound card, you should skip this step, and instead
follow the directions listed above, CONFIGURING A SOUND CARD.)

To use Cakewalk Pro Audio with the Session8, you must first copy
SCSI_DSP.DLL (which comes with the Session8 software) into your
Cakewalk Pro Audio directory.

Next, you must make some changes to Cakewalk's configuration file
WINCAKE.INI.  Make sure the Cakewalk Pro Audio Demo is not running.
Run Notepad, and open WINCAKE.INI  Locate the following line:

    [Wincake]
    AudExtDLL=C:\CAKEAUD\TTSAUDMM.DLL

Your path may be something other than C:\CAKEAUD.  Also, the line
may not be there at all.  Change (or add) the line as follows:

    [Wincake]
    AudExtDLL=C:\CAKEAUD\TTSAUDS8.DLL

Currently, Cakewalk Pro Audio has no built-in support for Session8
patchbay routing or input-level control. This functionality is
provided by the Session8 application.  Start the Session8 application
after launching Cakewalk Pro Audio, and then make your patching or
volume adjustments from within the Session8 application.


=== 7.  START THE CAKEWALK DEMO

Cakewalk SETUP installs a Program Manager icon for the program.
To run Cakewalk Demo, double-click on the icon.

The first time you run Cakewalk, you must make sure to enable your
MIDI input and MIDI output ports in Cakewalk.  Do this by running
Settings | MIDI Devices, i.e. by choosing "MIDI Devices" from the
Settings pull-down menu.  This selects which MIDI In and MIDI Out
devices you want Cakewalk to use.  Each item in the list is a driver
that you've installed using Windows Control Panel (as explained
previously).

- You don't have to pick any MIDI Out devices.  But of course, if you
don't pick any, Cakewalk won't be able to play anything.

- You don't have to pick any MIDI In devices.  But of course, if you
don't pick any, Cakewalk won't be able to record anything you play
on your MIDI keyboard, which comes to the MIDI In port of the MIDI
interface.  So if your device has a MIDI In port, you probably do
want to pick it.

If you later add or remove drivers using the "Drivers" icon of the
Windows Control Panel, you will have to run Settings | MIDI Devices
again if you want to change these Cakewalk settings.

REMEMBER THAT AFTER YOU ADD OR REMOVE A DRIVER IN CONTROL PANEL, YOU
MUST RESTART WINDOWS FOR THE CHANGE TO TAKE EFFECT.



======================================================================
TROUBLE-SHOOTING

=== IRQ CONFLICTS

SYMPTOMS: Cakewalk does not seem to record notes from your keyboard,
even though you've double-checked your connections as described
earlier.  Or, the system locks when Windows starts (in Windows 386
Enhanced Mode) or when Cakewalk starts (in Windows Standard Mode).

CAUSES: This may be due to a conflict over the IRQ that the MIDI
interface uses to alert the computer when incoming data arrives.  The
MIDI interface may be set to use the same IRQ number as some other
device in your computer.  Example of other things that may conflict
with the MIDI interface include:

 - A bus mouse.  (A bus mouse comes with a card that you insert in an
expansion slot of your computer, in contrast to a serial mouse which
simply plugs into an existing serial port of the computer.)

 - An EGA or VGA card set to generate IRQ 2.

TEST: If possible, remove the other device that may be causing the
conflict, for example the bus mouse card.  Try running Cakewalk
again.  If the problem has disappeared, we're on the
right track.

SOLUTION: The solution is to change the IRQ number of either the MIDI
interface or the other device.

If you change the IRQ of the MIDI interface, be sure to run Windows
Control Panel, select the driver for the device, and press the Setup
button.  In the dialog box, enter a number to match the new IRQ
number you have set on the MIDI interface.  You need to restart
Windows for your change to take effect.

If you are confused about which IRQ numbers might be appropriate for
your MIDI interface, the manufacturer of the device can provide
suggestions.  Please consult their documentation or call their
technical support.


=== MASTER KEYBOARD NOTE DOUBLING

SYMPTOMS: When you play the keyboard, you can play only half as many
notes at once as you can when you're not using Cakewalk and have the
computer turned off.  Or, even if you seem to be able to play as many
notes at once, each note seems "heavier" or "thicker" than usual, as
if two notes of the same pitch were turned on when you press the key.

CAUSES: Cakewalk provides a MIDI Thru capability: the data arriving
at the MIDI In of the MIDI interface is echoed to the MIDI Out.  This
makes it easy to control many sound modules from a single master
keyboard.  The "Connecting your MIDI equipment" section earlier
recommended a system that works well with this.

However, if the MIDI Thru is enabled, the master keyboard might turn
on two notes for every key you press on its keyboard.  One note comes
from the keyboard itself when you press the key.  The other note goes
out the keyboard, through the MIDI interface, and back to the MIDI In
of the master keyboard.  In other words, there is an "echo."

Various keyboards react to this echo in various ways: starting
another note of the same pitch, re-triggering the original note, or
something new and completely different.

SOLUTIONS: Eliminate the doubling by removing one of the two sources.
Choose one of the following:

1. Disable the master keyboard's control of its own sound circuitry.
This is called turning "Local Control Off".

Cakewalk tries to do this automatically when it starts by sending a
special message to the keyboard.  If this doesn't seem to work, make
sure you turned on the keyboard before starting Cakewalk.  If it
still doesn't work, consult the keyboard documentation about how to
set Local Control Off manually.

The result is that, when you press a key, the keyboard sends that
note message to its MIDI Out jack but doesn't start the note itself.
However, the note message is passed through the MIDI interface and
back to the MIDI In jack, at which point the keyboard turns on the
note.  You can think of this as splitting your keyboard into two
distinct parts: (1) a keyboard controller that doesn't make any
sound, and (2) a sound producing module, just like sound modules that
don't have a keyboard.

2. Disable Cakewalk's MIDI Thru feature: Choose the
"Settings | MIDI Thru" command and pick "None".

RECOMMENDED SOLUTION: If you have just one keyboard in your setup,
the second solution is fine.  But if you have one or more sound
modules in addition to a keyboard, the first solution is much better.


=== "SLOPPY" AUDIO SYNCHRONIZATION

SYMPTOMS: MIDI notes seem to speed up or slow down while playing in
audio-sync mode (i.e., with the clock source set to audio).

CAUSE: The DMA settings for your sound card have not been correctly
configured.  These settings are critical for Cakewalk's audio timing
determination.

TESTS: First, listen to the MIDI notes as playback begins.  Do they
seem to start out playing smoothly?  If not, then your "DMA Offset"
value in Settings | Audio | Advanced is probably incorrect.  The
most common DMA Offset value is "0 buffers".  "-1 buffers" is also
a very common settings.

Next, listen to the MIDI notes as playback continues onward.  Do they
play smoothly?  If not, then you "DMA Size" value in Settings | Audio |
Advanced is probably incorrect.  If some MIDI notes are "rushed", then
you must increase the DMA Size.  If some MIDI notes are "late", then you
must decrease the DMA Size.

SOLUTIONS:

1. Re-run Wave Profiler.  This should fix the majority of cases.

2. If your card is listed in the following table, manually enter its
settings into Settings | Audio | Advanced.

                            DMA size (bytes)        
Product                   11kHz  22kHz   44kHz    DMA Offset(buffers)
-------                   -----  -----   -----    -------------------																  
Windows Sound System	     5512   11024   16384    0
Ensoniq Soundscape        2756   5512    11024    0
Creative Labs SB16, AWE32 5512   11024   16368    0
Media Vision ProAudio     2048   2048    16384    0
Digital Audio Labs CardD  1024   2048    4096     0
Turtle Beach              4608   9216    18432   -1
Roland RAP-10             4096   8192    16384    0
Gravis Ultrasound         4096   4096    4096     0
ESS AudioDrive            2760   5520    11044    0
Crystal CS4231            8820   17640   35280   -1
