******************************************************************************
           JiNX Sound System for Windows - Code release 1.0f
******************************************************************************

The JiNX Sound System (JSS) for Windows is a port to Windows of the JiNX 
Sound System, originally written for DOS.  It's underlying implementation uses
Direct Sound, but can also run without sound hardware.

The original DOS JSS was written by Mark Hodson (Hex/JiNX), with additional
programming by Chris Bevan (Marvin/JiNX) and Jeffrey Lim (Pulse/PoP).  The
Windows port of the JSS was written by Saxon Druce (Penfold/JiNX), with final
bug-fixes again by Mark Hodson (Hex/JiNX).

This package is the JSSwin code library, containing libraries for Visual C
5.0 or 6.0, or Watcom C 11.0.  A demo programme and the source for the demo 
programme (as an example) are also included.

This package can be downloaded from the JiNX Coders Page.  For more
information on the general capabilities of the JSS, you should visit the page,
at http://www.adelaide.net.au/~mjhodson.

------------
File Listing
------------

readme.txt             - this file

JSSwin_demo.exe        - the demo programme
readme_demo.txt        - a readme file on how to use the demo programme

JSSwin_10f_vc5.lib     - library for use with Visual C 5.0 (or 6.0)
JSSwin_10f_wr.lib      - library for use with Watcom C 11.0 (register)
JSSwin_10f_ws.lib      - library for use with Watcom C 11.0 (stack)

jss_win.h              - header files required to use the libraries
Jss_com.h
jss_comp.h
Itstruct.h

JSS_Interface_Rev9.txt - description of the JSS (DOS) interface
Interface.txt          - description of the differences between the original
                         JSS (DOS) interface and the JSSwin interface

jss_wdem.c             - source files for the demo programme
jss_wdem.rc
resource.h

------------
Requirements
------------

The Windows port of the JSS was designed and built using Visual C 5.0.  The
library for Visual C 5.0 will however also work with Visual C 6.0.  Also
included are libraries for use with Watcom C 11.0, with versions which can
be used with a register-based or a stack-based calling convention.  Other
compilers or versions of compilers have not been tested.

As well as an appropritate compiler, you'll also need the Direct X SDK,
version 5.0 or newer, for the Direct Sound libraries.

------------------
Compiling The Demo
------------------

To compile the demo for yourself, using your compiler of choice create a
project which contains the files jss_wdem.c and jss_wdem.rc.  Make sure
that all of the .h files are somewhere in your project's include path.

Also add to your project the appropriate JSS library, depending on your
choice of compiler and (for Watcom C) calling convention.  From the DirectX
SDK you'll also need to include dsound.lib and dxguid.lib.  You're then
ready to build away...

The demo programme was written with and compiled under Visual C 5.0, although
the file jss_wdem.rc had to be modified so that the demo would compile
under Watcom C.  Note that if you compile the demo using Watcom C, due to what
appears to be differences in Watcom's dialog handling, the demo programme
compiled may appear slightly different from that provided.

-------------------------------------
Using The JSS For Your Own Programmes
-------------------------------------

See the interface.txt file for a description of the functions provided by
JSSwin, which you can use to create your own programmes with JSSwin.

-------------------
Licensing Agreement
-------------------

The Windows Port of the JiNX Sound System is currently covered by a two-part
licensing agreement.

For commercial use:

  Commercial users must pay a negotiable licensing fee to the author(s) of the
  JiNX Sound System.  This can be arranged by contacting Mark Hodson at
  mjhodson@camtech.net.au.  Commercial licensing can include the provision for
  receiving and modifying the source code.

  Commercial use is defined by the incorporation of the JSS into a programme
  which is to be sold by a company for the purpose of making profit.

For freeware use:

  Users producing freeware, which includes but is not restricted to, demos
  created for the demo-scene, can use the JiNX Sound System for free, so long
  as "JiNX Sound System" appears in the programme's credits.  It would also
  be nice if you contact the author(s) at mjhodson@camtech.net.au to signify
  your intention to use the JSS.

  Freeware use is defined by the incorporation of the JSS into a programme
  which is NOT being produced for the purpose of making profit.  Such a
  programme using the JSS may never be sold for any price during its life-
  time.  Prize money received by a demo group for their production which used
  the JSS is not considered as profit, nor are donations to an author of a
  completely freeware production.  Shareware is not freeware :).

The freeware use license also applies to the older DOS ports of the JSS.

----------------
Revision history
----------------

- version 1.0f (28-2-99)

The first revision of the JSS which included windows support.

-------
Contact
-------

If you experience any bugs, or have any comments or suggestions, either
contact Saxon Druce (if it's related to the Windows port) or Mark Hodson (if
it's related to the JSS in general).

The emails are:
Saxon Druce    saxon@camtech.net.au,
Mark Hodson    mjhodson@camtech.net.au.

*****************************************************************************

The JiNX Sound System and related materials are Copyright (C) 1997-1999 Mark 
Hodson.  The Windows Port of the JiNX Sound System and related materials are
Copyright (C) 1998-1999 Saxon Druce.

DISCLAIMER:

Any demo programmes or code libraries from JiNX carry no warranty either 
expressed or implied.  The authors are not responsible for any damages caused 
by their use or misuse.  You are NOT PERMITTED to decompile, disassemble or 
in any way reverse-engineer any of the demo programmes or source libraries. 

*****************************************************************************
