This file documents ptreplay, a librarybased systemfriendly PT/NT/ST-replayer. Copyright (c) 1994-1996 Mattias Karlsson (BetaSoft) Copyright (c) 1996 Andreas P�lsson (Pucko/Digital Dreams) PTREPLAY.LIBRARY 6.6 ptreplay.library v6.6 is released under the concept of freeware. This means that it is freely distributable as long as following conditions are fulfilled: �The archive may not be sold, but inclusion in a PD-library is permitted as long as only a SMALL fee is charged to cover the costs of copying and distribution. The Fred Fish Library is the perfect example. �Programs and documentations must be distributed together in their unmodified form. �Concerning the library itself, programs using ptreplay.library may include it in their distribution packages as long as this file follows as 'ptreplay.readme'. Of course the program using it must be freeware to. For inclusion in a shareware or commercial software package, please contact the author. - - - ptreplay.library (from now on ptreplay) is a standard Amiga shared library, capable of playing music files with the well known 'M.K.' sign inside. Some of PtReplay features: � System friendly, uses CIA-timing for smooth playing � Except for the ordinary Play, Pause, Resume and Stop there are fading volumechanging, ability to specify postition, turn on/off channels. � Load modules via PTReplay. No need to open Dos. Use this library as you would use any normal Amiga library. Included in this package is include files for Assembler and C. - - - A few weeks ago Mattias Karlsson (Betasoft) decided to pass the development on because of lack of time. I volunteered to continue the development since I've been using it myself alot and my interest in music and programming. Some word from Mattias Karlsson concerning the birth of ptreplay. I wrote this library because I was unable to find a _good_ and system- friendly replay routine for ProTracker. I based this loosely on the example sources that accompany ProTracker, but these were pretty badly written, and sparsly commented, and the CIA routines did never work on my machine. A job worth doing well is worth doing yourself, I though and went to work. This is what emerged, a small library. Notice that it is just about 8k, and still contains all needed to play good music (and it has a lot of features too) - - - Changes from 6.5 to 6.6 by Andreas P�lsson ------------------------------------------ * FIXED: Closelibrary()() wouldn't return. Reported by Michael Stoehr. * CHANGE: Betasoft turns over the development to Andreas P�lsson. Changes from 5.14 to 6.5 by Mattias Karlsson -------------------------------------------- * Horror, the clean up routines clears some signals on the task that closes the library (maybe this is what caused the spurius GURUs?). (6.5) * If you are to quick to start playing after the library has been opened it produced 4 hits and no sound since it checked the IORequesters before PTReplay_ctrltask has time to allocate them. (6.4) * Now it only trigger ModuleRestart when you do a positionjump in the last position instead of everytime. (6.3) * Now frees all channel on LibClose instead of libExpunge. (6.2) * Sometimes ptreplay_ctrltask (See FAQ) "hangs" and starts busylooping when you did a DisplayBeep() with a sample. (6.1) * New functions for reading the owned channels and sampledata. (6.0) * A channel that is turned of was not left alone. (5.16) * All channels were turned on at playtime, instead of only those that ptreplay owns. (5.15) - - - My addresses: URL: http://www.algonet.se/~did/ E-Mail: did@algonet.se Fidonet: Andreas Palsson 2:200/628.0 <- recommended Mail: Andreas P�lsson Trolle Ljungby S-290 34 Fj�lkinge SWEDEN or call my bbs at +46-(0)44-55031 The former author can be reached at: URL: http://www.algonet.se/~betasoft/ E-Mail: betasoft@algonet.se FIDO: Mattias Karlsson@2:200/502.3 <EOD>