TITLE

     DES-Tracker2.00 - Release 2.00 of the DES-Tracker library system


VERSION

     Distribution version 2.00 (released December 18, 1993)


AUTHOR

     Darren Schebek

     E-mail address: dschebek@outb.wimsey.bc.ca


DESCRIPTION

     DES-Tracker is a library system used for the playing
     of tracker song modules.  It is geared mainly towards
     use in multi-media applications, but can be used in
     virtually any type of application.  DES-Tracker is
     easy to install, easy to use, and includes lots of
     example programs (with source code) that show how to
     use the library to build applications on top of
     DES-Tracker.

     DES-Tracker works with all versions of the operating
     system.  It allocates audio channels using the audio
     device, and tries to obtain the best possible CIA
     interrupt timer.

FEATURES

     1. DES-Tracker can load, save and convert between the
        following tracker module file formats:

            NoiseTracker v2.0
            Protracker v1.1a
            SoundTracker v2.6
            DES-Tracker v1.0

     2. Forty library functions that allow you to have
        total control of the playing of a tracker module.

     3. Complete signalling system for syncing music events
        to application-related events.  The DES-Tracker
        library can signal an application whenever any of the
        following events occur:

            - A play sequence starts
            - A play sequence ends
            - The song is paused
            - The song is un-paused
            - A play sequence is aborted
            - An iteration of the song completes
            - A pattern finishes playing
            - A volume fade operation completes
            - A new song module is loaded
            - The current song module is unloaded
            - An application locks the library for
              private use
            - An application unlocks the library
            - Each minute of play time elapses
            - Each second of play time elapses

     4. Over forty ARexx functions.

     5. Allows you to specify start and end positions
        within a song module either based on song position
        or based on play time.  Utilizes tempo and command
        operand tracking to make sure that tempo is correct
        no matter where in the song you start playing from.

     6. Capable of calculating how long a song (or any part
        of a song) will take to play.  Can also calculate how
        long a volume fade will take to complete.

     7. Can load songs from disk or install songs from memory.

     8. Includes a micro-jukebox program (with source code)
        called "mJuke" that runs from the command line and can
        play all songs in a specified directory.  Can also
        parse script files.

     9. Includes a realtime scope program (with source code)
        called "LScope" that monitors the player library and
        produces a visual display with *proper* scopes, real
        peak meters and lots of realtime information about a
        playing song.

    10. Includes a tracker module info program (with source
        code) called "MODInfo" that displays all kinds of
        statistics about any given tracker module (provided the
        tracker module uses a file format that DES-Tracker
        understands).  This program is installed on the Wizard
        Online BBS so that users can get all kinds of information
        about a tracker module *before* they download (including
        how long the song takes to play).  MODInfo can also
        detect and display sampletexts stored within a tracker
        module.

    11. Includes a CLI-based commander program (with source
        code) called "DTC" that allows you to invoke almost all
        player library functions from the command line.  This
        program also allows you to use DES-Tracker from within
        Director II scripts.

    12. Comes with include files for C and assembly language.
        Also comes with pragmas and prototype files for SAS C.

    13. DES-Tracker's library base structure contains lots of
        useful information about the currently loaded song and
        its instruments, as well as tons of realtime play info.
        (Everything that the LScope program displays is done
        solely by examining the library base structure).

    14. DES-Tracker is freeware.  This means that it is freely
        distributable, but is *not* public domain.  DES-Tracker
        is copyright (c)1993 by Darren Schebek.  Conditions
        apply for use of DES-Tracker in commercial applications.
        Please read the documentation included with DES-Tracker
        for further details.

OTHER

     E-mail address for questions/bug reports:

     dschebek@outb.wimsey.bc.ca

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 3160    5688  55.6% -lh5- 4ebd Dec 17  1993 DTL/c/DTC
[generic]                 7991   25516  31.3% -lh5- 6fb1 Dec 17  1993 DTL/c/LScope
[generic]                  249     862  28.9% -lh5- 5a22 May 22  1992 DTL/c/LScope.info
[generic]                 2239    3640  61.5% -lh5- 6f68 Dec 17  1993 DTL/c/mJuke
[generic]                 2437    4012  60.7% -lh5- dc87 Dec 17  1993 DTL/c/MODInfo
[generic]                10564   35967  29.4% -lh5- ce7c Dec 17  1993 DTL/code/DTC.S
[generic]                  580    1160  50.0% -lh5- c0d2 Dec 17  1993 DTL/code/JukeScript
[generic]                29499  100374  29.4% -lh5- 146a Dec 17  1993 DTL/code/LScope.S
[generic]                 2326   10008  23.2% -lh5- 764e Dec 17  1993 DTL/code/LScopePic.O
[generic]                17165   53742  31.9% -lh5- 1aa6 Dec 17  1993 DTL/code/mJuke.S
[generic]                 8513   28625  29.7% -lh5- 991f Dec 17  1993 DTL/code/MODInfo.S
[generic]                21428   73543  29.1% -lh5- 1350 Dec 17  1993 DTL/docs/LibFuncs.DOC
[generic]                11435   38557  29.7% -lh5- 135a Dec 17  1993 DTL/docs/RexxFuncs.DOC
[generic]                13372   41647  32.1% -lh5- b2b4 Dec 17  1993 DTL/docs/Structures.DOC
[generic]                 2840    8402  33.8% -lh5- 4e73 Dec 17  1993 DTL/DTL0-Format.TXT
[generic]                14047   37331  37.6% -lh5- 7cd8 Dec 17  1993 DTL/DTLib.ReadMe
[generic]                 1773    3772  47.0% -lh5- b718 Dec 17  1993 dtl/faq.txt
[generic]                13731   36040  38.1% -lh5- 0e0a Dec 17  1993 DTL/History.TXT
[generic]                  547    1823  30.0% -lh5- a159 Dec 17  1993 DTL/include/clib/dtlib_protos.h
[generic]                  525    1437  36.5% -lh5- 2571 Dec 17  1993 DTL/include/fd/dtlib.fd
[generic]                 5057   16084  31.4% -lh5- 8398 Dec 17  1993 DTL/include/libraries/dtlib.h
[generic]                 5769   17976  32.1% -lh5- cb03 Dec 17  1993 DTL/include/libraries/dtlib.i
[generic]                  468    2131  22.0% -lh5- c54b Dec 17  1993 DTL/include/pragmas/dtlib_pragmas.h
[generic]                  100     131  76.3% -lh5- 0e56 Dec 17  1993 DTL/include/proto/dtlib.h
[generic]                14725   25652  57.4% -lh5- 8280 Dec 17  1993 DTL/libs/destracker.library
[generic]                12162   18436  66.0% -lh5- e50e Sep  4  1992 DTL/libs/req.library
[generic]                 2042    4991  40.9% -lh5- 900a Dec 17  1993 DTL/ReadMe.Install
[generic]                 1678    4566  36.7% -lh5- 649c Dec 17  1993 DTL/rexx/JukeBox.Rexx
[generic]                  541    1468  36.9% -lh5- 05e7 Dec 17  1993 DTL/rexx/Play.rexx
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        29 files  206963  603581  34.3%            Dec 22  1993