Short:    Library to play THX and THX2 modules
Author:   Dexter/Abyss, Kyzer/CSG
Uploader: Kyzer/CSG <kyzer@4u.net>
Type:     dev/misc
Replaces: dev/e/PlayTHX.lha

NOTE: This archive is for developers, if you just want the library
and a player, get mus/play/PlayTHX.lha instead.


This is a lovely interface to the replayer binary of THX2.
- use generic 68000 version or 68020 optimised version.
- use either shared library, C linklibrary, or E module.
- comes with full autodocs and development materials.

Changes since previous release:
- fixed internal documentation.
- C pragma/protos/linklibrary etc.
- now uses different conditionals in the source.
- shared lib now checks for 020 processor.
- patched some player bugs (yes, Dexter has already been informed)
- removed the 3rd result of thxPlaytime(), as it annoys C users.
- seperated from PlayTHX archive.

Functions in the interface:
  thxInit -- initialise player and module.
  thxFree -- free resources held by player.

  thxPlay -- start playing the song.
  thxPause -- pause play of a song.
  thxStop -- stop playing a song/module.
  thxWind -- wind the song forward or back.

  thxGetNumSongs -- get number of subsongs.
  thxSetSong -- set song to be played.

  thxGetVolume -- get master volume.
  thxSetVolume -- set master volume.

  thxPlayNote -- start playing a user-specified note.
  thxStopNote -- stop playing user-specified note.
  thxNoteFX -- perform FX command on user-specified note.

  thxSyncByte -- get sync byte value.
  thxSignalEnd -- Signal() when song ends.
  thxSongEnded -- detect if song has ended.
  thxPlaytime -- get current playtime of song.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    1627     808 50.3% 16-Jun-98 21:37:58  thxplay_lib.readme
     841     475 43.5% 05-Jun-98 20:12:20 +thxplay.i
     705     227 67.8% 19-Jun-98 10:08:36 +thxplay_lib.i
     933     402 56.9% 05-Jun-98 20:28:20 +thxplay_protos.h
    1847     522 71.7% 19-Jun-98 10:08:38 +thxplay.h
    1023     464 54.6% 05-Jun-98 20:07:34 +thxplay.h
    2137     515 75.9% 19-Jun-98 10:08:40 +thxplay_lib.h
     362     201 44.4% 19-Jun-98 10:08:40 +thxplay.h
     700     408 41.7% 05-Jun-98 19:04:36 +thxplay.e
     192     118 38.5% 19-Jun-98 10:08:44 +thxplay.m
     239     151 36.8% 19-Jun-98 10:08:42 +thxplay.m
     380     191 49.7% 19-Jun-98 10:08:42 +thxplay_lvo.m
   13894    8314 40.1% 19-Jun-98 10:06:54 +thx-play.m
   13734    8234 40.0% 19-Jun-98 10:07:06 +thx-play_020.m
   13792    8300 39.8% 19-Jun-98 10:07:40 +thxplay.o
   13632    8218 39.7% 19-Jun-98 10:07:52 +thxplay_020.o
     695     295 57.5% 18-Jun-98 00:20:18 +makefile
   17545    5502 68.6% 19-Jun-98 10:08:00 +thxplay.doc
     664     338 49.0% 10-May-98 22:18:24 +thxplay_lib.fd
    1984     732 63.1% 21-Apr-98 09:11:48 +THX-Bang.doc
     914     691 24.3% 21-Apr-98 09:11:48 +THX-Bang000.BIN
     908     685 24.5% 21-Apr-98 09:11:48 +THX-Bang020.BIN
    1352     536 60.3% 27-Apr-98 01:53:48 +THX-Offsets.I
    6176    2320 62.4% 21-Apr-98 09:11:50 +THX-Replayer.doc
   11596    7339 36.7% 16-Jun-98 22:16:16 +THX-Replayer000.BIN
   11440    7253 36.5% 16-Jun-98 22:29:08 +THX-Replayer020.BIN
    4950    1795 63.7% 10-May-98 23:06:22 +init.asm
    1936     796 58.8% 10-May-98 23:02:36 +interrupt.asm
    3615    1373 62.0% 11-May-98 07:33:08 +library.asm
    1515     573 62.1% 18-Jun-98 00:22:46 +makefile
    4975    1722 65.3% 16-Jun-98 21:51:00 +misc.asm
    2479     943 61.9% 10-May-98 23:09:10 +multisong.asm
    5485    1856 66.1% 10-May-98 23:09:52 +note.asm
    3512    1158 67.0% 11-May-98 07:32:08 +song.asm
    1010     562 44.3% 17-Jun-98 00:37:50 +BangTest.e
    5218    1819 65.1% 17-Jun-98 00:33:30 +thxplay.asm
     246     133 45.9% 19-Jun-98 10:03:46 +thxplay.library_rev.i
       2       2  0.0% 19-Jun-98 10:04:08 +thxplay.library_rev.rev
    1566     522 66.6% 11-May-98 07:29:34 +volume.asm
    1971    1035 47.4% 19-Jun-98 10:04:28 +thxplay.faq
   19769    5841 70.4% 19-Jun-98 10:08:10 +thxplay.guide
   13904    8419 39.4% 19-Jun-98 10:07:18 +thxplay.library
   13772    8360 39.2% 19-Jun-98 10:07:30 +thxplay.library.020
-------- ------- ----- --------- --------
  205237  100148 51.2% 21-Jun-98 05:00:34   43 files
