SampleUtility Documentation
----------------------------------------------------------------------------
                              SampleUtility
                               v95.Jan.25

   Description 

   Requirements 

   Shareware 

   Development and Testing 

   Installing 
   Starting   

   Configuration 

   Future Enhancements 
   Known BUGS          

                                         Legalness  
                                         Thank Yous 
   New in this version 
   Previous versions                                  Locating The Author 


   SampleUtility is a disk imager and waveform conversion utility for
                       Professional Audio Samplers
============================================================================
Description
----------------------------------------------------------------------------
Description
-----------

SampleUtility is a disk imager and waveform conversion utility for
Professional Audio Samplers.

There are three versions of SampleUtility.  This is the UnRegistered
Release.  It is the only version released publicly.

All versions provide the capability to READ and WRITE full disk images,
in both double density (DD) and high density (HD) formats.  A disk image
is a conversion of a full disk in to a single file.  This is a good way
to keep backups and to distribute disks through EMail/FTP/BBS.

Most IBM based formats are supported: This includes the Roland series of
samplers.  Additional format support is currently under development.



UnRegistered Release
--------------------

This is the basic no-frills release.  READ/WRITE of disk images is
supported, but no FORMATing or INFO is available.  This release is hard
coded to use drive 0 and the Topaz font.



Registered Version
------------------

This version includes the FORMAT and INFO gadgets and Workbench ToolTypes
support.

The FORMAT gadget provides a way to create formatted disks from any disk
image file.  This is very time saving if you like to have certain
parameters setup a specific way most of the time.  Several disk images
can be used for different default setups.

The INFO gadget will read label, patch, tone, etc. information from a
disk or disk image.  Currently, the Roland series of samplers are
supported.  Additional support is under development.

Workbench ToolTypes are supported to set the default disk drive, default
directories, file extensions, font, and more...



Enhanced Registered Version
---------------------------

This version includes additional support for translation from many sound
formats.  The following are currently under development: Yamaha TX16W,
Sample Dump Standard (SDX), Roland series samplers, Kurzweil K2000,
Ensoniq series samplers, E-mu EMax, SampleVision (SMP), and many more.
============================================================================
Requirements
----------------------------------------------------------------------------
Requirements
------------

SampleUtility currently requires the MFM.device included with WB2.1+ and
available with Consultron's CrossDOS.

The following system libraries and devices are used:

                         dos.library
                         graphics.library
                         intuition.library
                         asl.library
                         diskfont.library
                         exec.library
                         gadtools.library
                         locale.library
                         workbench.library
                         mathieeedoubbas.library

                         trackdisk.device
                         mfm.device
                         timer.device
============================================================================
Shareware
----------------------------------------------------------------------------
Shareware
---------

A great deal of time has been spent in the development of SampleUtility.
You are required to pay a Shareware fee if you continue to use this
software beyond a trial period of 10 days.

If you wish to receive a Registered version of SampleUtility, a Shareware
fee is required to be paid.  See:  Locating The Author 

Your shareware payment helps to insure continued development of
SampleUtility. See:  Future Enhancements 


UnRegistered Public Release
---------------------------
The shareware fee for this version is $5.00 (or more).


Registered Version
------------------
The shareware fee for this version is $15.00 (or more).


Enhanced Registered Version
---------------------------
The shareware fee for this version is $40.00 (or more).
============================================================================
Development and Testing
----------------------------------------------------------------------------
Development and Testing
-----------------------

SampleUtility was developed on an Amiga 3000T/25MHz with 2 Meg CHIP / 10
Meg FAST memory.

SampleUtility has been tested under Kickstart version 37.175, Workbench
version 38.12.
============================================================================
Installing
----------------------------------------------------------------------------
Installing
----------

The following files should be contained in the same directory:

                            SampleUtility
                            SampleUtility.info
============================================================================
Starting
----------------------------------------------------------------------------
Starting
--------

From Workbench, double-click on the SampleUtility icon.
============================================================================
Configuration
----------------------------------------------------------------------------
Configuration
-------------

Registered versions of SampleUtility support configuration through use of
Workbench ToolTypes.
============================================================================
Legalness
----------------------------------------------------------------------------
Legalness
---------

SampleUtility is copyright ©1995 by scott dhomas trenn.  The files
included with this distribution may not be altered in any way.
SampleUtility is released as Shareware - You are required to pay a
 Shareware  fee if you continue to use this software beyond a trial period
of 10 days.

The software concept and design remain the property of the author,
scott dhomas trenn and Scotware\Software.

Permission is granted for this program to appear in any public domain
software archives.

Permission is granted for this program to appear on any commercial disks
or CDROMs, provided that a single copy of the product, containing this
version of this progam, is sent to the author.

The author is in no way liable for any damage resulting from the use of
this program.
============================================================================
Future Enhancements
----------------------------------------------------------------------------
Future Enhancements
-------------------

Future public releases will only contain bug fixes (if any) and changes
to the workings of the software.  Support for additional disk formats
will also be added.

Further development beyond this will only be done with the Registered
versions.
============================================================================
Known BUGS
----------------------------------------------------------------------------
Known BUGS
----------
- Disk busying is not completed.
============================================================================
Locating The Author
----------------------------------------------------------------------------
Locating The Author
-------------------

If you like this program and would like to register, reward me for my
efforts, or for bug reports, program ideas, or questions, or just to tell
me about where you live.

I can be contacted through INTERNET EMAIL at:

                              dhomas@unb.ca

Or by MAIL at:
                            scott dhomas trenn
                           797 Mitchell Street
                             Fredericton, NB
                             CANADA  E3B 3S8


Registered users may send me $5.00 for the latest release.  I prefer to
send updates through EMail so be sure to send me your EMail address.  If
you do not have EMail access enclose a disk and your full mailing address
with your payment.

Be sure to include the version number you are currently using, and the
name of the program you want, so I do not send you a version you already
have or a program you do not want.  The version number can be found in the
titlebar, at the top of this documentation file, or by typing:

                          Version SampleUtility

at a shell prompt.  It looks similar to     95.Jan.16

When reporting bugs or errors generated when you run SampleUtility,
please include any error messages given by SampleUtility and also the
version number you are using.  This will aid me in tracking down the
problem. Thank-you.

If you have an EMAIL address please include that with your letter.
============================================================================
Thank Yous
----------------------------------------------------------------------------
Thank Yous
----------
Rod Lemcke               Beta Tester

Nic Grant                S770 DD/HD disk images
John Hamilton Kimble     DJ70 DD disk image
Thomas Hammer            GKH information
Timo Rossi               Yamaha EPS information
Marc Resibois            Roland W30 structure
Jon Jenssen              Roland S550 information
Kurt George Gjerde       SDX, SMP, WAV, AIFF information
Arnim Laeuger            trackdisk.device
Telford Tendys           trackdisk.device
Ralph Siemsen            trackdisk.device
Jim Norman (Roland)      Roland series library disk images

                                                            - dhomas trenn
============================================================================
New in this version
----------------------------------------------------------------------------
New In This Version
-------------------

- First Release
============================================================================
Previous versions
----------------------------------------------------------------------------
New In Version 95.Jan.25
------------------------

- First Release
============================================================================
