Shock Play 2.3b Documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

[First public release.]


1. What is this?
~~~~~~~~~~~~~~~~

 Guess what... A shareware S3M player for Pmode/W, which currently supports
 only GUS as a wave device. I'm planning some AdLib support too, and if so-
 meone throws me an AWE32 or SB16, i'll support them too.

2. Why the hell should I use it?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Well, kinda obvious that a player must be fast. And this is FAST,  really,
 coz it contains no C routines as many others, like Midas and the rest. And
 the most useful function is memory doubling. I haven't  seen a  decent S3M
 player with memory doubling so far. I mean those ones which come w/ source
 too. I can't imagine that the authors of Midas and MikMod can't write some
 kind of memory-doubling feature! I hate when some  demos  just won't start
 because  I've got a  768K GUS (and more some got even 256K GUSes!).  Ok, I
 decided to code a player for those people. Maybe you need this too.

3. Why just only S3M?
~~~~~~~~~~~~~~~~~~~~~

 Ok, some XM support is on its way, but I  really like ST3,  coz I hate the
 mouse-driven interface of FT2.  I'm a (not-too-good)  musician too,  and I
 personally like ST3 for its ease of use.

4. Does it support all the S3M effects?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Basically all you need is here.  Ok,  for example Vibrato is not supported
 yet, but it will be in the next version, and  we really don't use it.  But
 who knows? Pattern jump is also not supported. Have you ever used it? ;-))

5. Is it easy to use?
~~~~~~~~~~~~~~~~~~~~~

 Of course!! ;-)  What you need is: load a S3M somewhere, and call SP_START
 given with the pointer which points to the loaded S3M. That's all.  If you
 want silence, just call SP_STOP.  How easy! No setup needed.  No  giggling
 with DMAs and IRQs. Full autodetect or what!

6. Ok, here is a list of the commonly used procedures and variables
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 SP_START(byte *modplace)             - starts playing
 SP_STOP()                            - stops playing
 SP_SETCALLBACK(dword whattocall())   - callback function (really useful!)
 SP_POLLMUSIC()                       - for debugging, manual call of player

 SP_ACTROW                            - which is the actual row
 SP_ACTORDER                          - which is the actual order

 If  you  need more, just have  a look  at the source.  It's  really  self-
 explanatory. Public and extern them, and be happy.

7. I'm lame! I still can't understand!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Have a look at the SP.C, and SP.H.  You should understand how it works, or
 gotta go to collect stamps or what!

8. But I need a MOD player (even a 16CH MOD player!)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 It's already done. If you really need that,  I'm  gonna  include it in the
 next version.

9. Can you send me a Realmode version?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Yes, of course. Some years ago I wrote a realmode player too (GUS/S3M). If
 you really need that, I can send it to you.

10. Will you convert it to plain PMODE?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Probably not. Do it yourself!

11. What will be in the next version? And when?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Dunno when. If I get reactions then SOON! Anyways:

 - SB16, AWE32 support
 - MOD 4-16 channels support (if someone needs it)
 - XM support
 - full set of commands

12. Good! But does this cost me money? Or can I use it freely?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 It's totally free. Do what you want, but please don't spread the  modified
 versions. Only the original.

13. I discovered that if I press F1 in the player interface, I can see that
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
some CyberDancer wrote it, not TSC! Are you a ripper?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Noo... Just it was my previous handle. And since  the  original   ansi was
 lost, I can't redraw it anymore  (ok, ok,  i  could  someway, but I simply
 don't care. This player is just a simple example. Understood?!)

14. I've got no more questions!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Good... At last!

15. Ooops. I've almost forgotten: How can I reach you!??
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 Fuck. Call me:  +36-62-341850 (ask G bor)

       Write me: tsc@master.fok.hu
                 szabogab@gandalf.gamf.hu

       Irc:      #magyar, #teensex ;-)

       Snailmail: Szab˘ G bor
                  6800 H˘dmez“v s rhely
                  Somogyi B‚la u. 26.
                  Hungary

       BBS:       Write to tsc on: JunkDrome, Dune][, Scenet, Da Lost Grid
                                   Brain Core Revolvator, Apocalyptic Raids,
                                   Electric Ladyland
       Or find me
       on:        FidoNet/RetteNet/Erratic CyberWorld

16. That's enough... Stop it now!!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Go to the hell...