
---------------------------------------------------------------------------
NewPlay 1.0
---------------------------------------------------------------------------

Created by Kenneth "Kenny" Nilsen (kenny@bgnett.no)
Copyright (C) 1998 by Digital Surface.

This document also contains description on the patch SuperModel.


WHAT IS NEWPLAY ?
-----------------

NewPlay is a tool that can play Studio 16 samples, both mono and stereo,
through the AD516/AD1012 cards. It uses the Studio 16 V3 environment.

NewPlay consist of a GUI which allow you to select sample, play and stop.
NewPlay does not require Studio 16 to run.


USAGE
-----

You can start NewPlay before and after you start Studio 16. Studio 16 do
not need to run in order to have NewPlay to function. However, pleaee note
the following situations:

a) If you start NewPlay before Studio 16, Studio 16 can't start. You will
need to quit NewPlay and then start Studio 16. This is because NewPlay
allocates Studio 16's resources which again set the handler to be "busy".
NewPlay will free the resources it uses when it quits if Studio 16 was not
started.

b) If you start NewPlay after Studio 16 you MUST remember to quit NewPlay
before Studio 16. This is because Studio 16 doesn't care about programs
using its resources as long as they're not a Module. NewPlay will not free
any resources if started after Studio 16.


The GUI
-------

You will find to versions of NewPlay in this archive. The "NewPlay" version
is enhanced for Workbenches that uses Magic WB style. It uses some of the
fixed colors to create visual effects. The "NewPlay_plain" version uses
only standard pens. Both GUI are the same in size and button placements.

-- Buttons

You will find three buttons in the GUI, and two in the window bar.

The little button with a disk image allow you to select a sample. You don't
need to worry about if the sample belongs in a sample pair to make stereo.
NewPlay will figure out this by its self. If the sample doesn't end with
either "L" or "R" it assume the file to be a mono file. Note that the files
settings such as pan, rate, volume and size will be loaded and used.

NewPlay will preload the sample(s) so when you press 'Play' button it will
start ASAP. Press 'Stop' to stop a sample in progress. You cannot select a
new sample during play nor can you quit.

To quit you must Stop any sample beeing played. Then press the window's
closegadget (upperleft).

You can play sound from Studio 16 at the same time, just note that using
the 'Stop' button will also stop any sample beeing played in Studio 16 and
vica verca.

-- Hotkeys

NewPlay provides a set of hotkeys you can use instead of the buttons.

To Load a sample you can press the keys 'l' or 'f'.
To Play press 'p'.
To Stop press 's', 'RETURN' or 'SPACE'
To Quit press 'q' or 'ESC'


NOTE: NewPlay is in a BETA state. That means you should consider NewPlay to
be unstable as it is not fully tested under every condition. So far NewPlay
is stable enough for general usage.

NOTE: NewPlay requires the library 'dfunc.library'. use the supplied
installer script to install the library.

---------------------------------------------------------------------------
SuperModel - The Studio 16 GUI enhancer
---------------------------------------------------------------------------

SuperModel is a patch that patches some functions in the gadlib.library.
This will result in that the Studio 16 windows will get thin edges in the
window top (gadgets and titlebar), and also text gadgets and some visual
borders. It also speeds up the drawing a tiny bit.

To install SuperModel:

Open a CLI or Shell window from Workbench:

- Type the following at CLI prompt:

1> cd <where you have unpacked NewPlay>/NewPlay/

- To copy it:

1> Copy SuperModel C:

- Now you must edit your user-startup, to do that you type:

1> ed s:user-startup

- Add a line at bottom of that file which says:

Run >nil: SuperModel

Save the file and quit. With Commodores editor you press ESC and press 'x'
pluss return.

That's it. Next time you boot and start Studio 16 it will have its GUI
enhanced. If you don't like it just remove the line you added in the
user-startup file.
