JustPlay v1.1

                             by Grzegorz Calkowski

                           © 1995 The Beet Research

                             --- PUBLIC DOMAIN ---

===============================================================================


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
                                 UPDATE! WOW!
Finally, after one year I've decided to release first update of JustPlay!!!!
Ha, was JustPort so perfect that it didn't need any updates???  Well, almost...
JustPlay v1.0 was designed to work only from Workbench...  this one is usable
form CLI as well...  Also powerpacked modules are now decrunched, not only
XPK-ed. Have fun.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


ONLY SHORT DESCRIPRION HERE.

     I'm fanatic workbench user so I wanted possibility to play a music module
by double-clicking on its icon.  Yes, nothing simplier :-).  But I hadn't
appropirate player to use in such way.  There is a lot of complicated, complex
players with GUIs (and fountains...), but I hadn't such player, which name I
could simply type into Default Tool field in icon.  So...

Here it is. JustPlay :-). Nothing more...

     It's very simple player based on ProTracker 2.1 cia-replay routine.  Can
be used from Workbench in its usual ways:

     1. By putting JustPlay as a default tool.

     2. By selecting JustPlay icon and a module icon. 
	(No doubt, never will be used 8)

And also from Shell: ---NEW v1.1---

     3. By passing module filepath as argument.


     When you launch JustPlay from Workbench, an appicon will be created Note:
icon image isn't bulti-in, it's taken from program icon, so DO NOT delete this
icon (of course you can change it).  Double-click on it to stop the music and
exit.  JustPlay can play modules crunched with a XPK compressor.  Just make
sure xpkmaster.library and the compressors libs are available.

     When you run JustPlay while another one is running (playing) then it will
signal the previous one to stop playing.  In such case you can pass no module
what will be considerd as stop command. (---NEW v1.1---)

     JustPlay recognizes following ToolTypes:

	DMAWAIT=n 	: Value for dma-wait. Suggested values for following
			  machines:

			  A500/A600.................... 300
			  A1200 (no fast).............. 600
			  A1200 (fast)................. 800 <- default
			  A3000,A4000-30.............. 1100

                          ---NEW v1.1---
                          A4000-40....................>2000
                          (: Yeah, I've got one...! :)


	ICONTEXT=<text>	: Title for the appicon.

	ICONXPOS=n	
        ICONYPOS=n	: coordinates for the appicon.


     And Shell template looks like:

        MODULE/A,DMAWAIT/K/N

     where:

        MODULE <path>   : Module filepath to play
                          (note that MODULE keyword can be omitted)

        DMAWAIT=n       : See above


     I include source code.  Do with it whatever you want.


		      Hope you find it useful....

					Signed: GC/TBR 8-)

===============================================================================

Feel free to contact me for any reason (pity, only Snail-mail available):

					Grzegorz Calkowski
					Rzedowice
					ul.Dobrodzienska 8
					42-780 Dobrodzien
					POLAND

                                        phone: +48(0)34-575875

					E-mail: calkowsk@us.edu.pl


                                Brief history:
                                --------------


v1.0 (03.08.94)

    · First release of this one-day production.


v1.1 (08.07.95)

    · Yeah, finally!

    · Now works also from Shell.

    · Running it second time will signal the previous one to quit.

    · NOICON tooltype no longer supported (thus you can't stop module by
      both-buttons-click)

    · Added some bugs (no doubt - said Murphy ;).

    · Now also decrunches PowerPacked modules (via XPK, of course)
      if powerpacker.library is available.

    · Fixed a Mungwall hit.


       NO FURTHER UPDATES ARE BEING TAKEN INTO CONSIDERATION.... SORRY.
               (Well, maybe somewhere in the middle of '96  ;-)