Win32 for OS/2 Quake 2 demo distribution (28-2-'98)

NOTE: This is an early alpha and for that reason has no
      fancy install program. So RTFM.

------------>>DO NOT EMAIL US DIRECTLY WITH QUESTIONS/REQUESTS<<----------------
------------>>  Read the 'Problems/Bug reports' section below <<----------------

********************************************************************************
** Requirements for Quake 2
********************************************************************************
- Legal copy of Quake 2
- Warp 4 (preferably FP5), do not use FP3
- Warp 3:
	- FP26 or higher
	- MPTS fixpack wr08415 or higher (for winsock)
- MMPM/2 installed with wave and RTMIDI support

********************************************************************************
** How to get Quake 2 up and running
********************************************************************************
- Install Quake 2 in windows 95 or NT (if you haven't already) on a
  partition that's accessible from OS/2 (no FAT32 (without OS/2 FAT32 ifs), 
  NTFS or hidden partition)
  If you haven't installed Quake 2 and can't (since you don't have win95 or
  NT on your system) do the following:
	- manually copy the needed files to your harddisk (complete
	  install\data directory, except install\data\baseq2\video)
	- copy the included config.cfg to the baseq2 dir
	- Quake 2 is now configured for 320x200 in software mode	
	- The only things missing are the fancy intro animations
	  (don't know why)
	  
- Copy PE2LX.EXE to a directory in your PATH, and the remaining files to a
  directory in your LIBPATH.
  NOTE: Lotus SmartSuite comes with it's own version of ole32.dll, which
        is incompatible with ours. Take special care if you have Smartsuite
	installed! (so don't put our ole32.dll in the libpath)

- Now there are two options for people 
	- With a 3Dfx Voodoo card
	  Add xf86sup.sys to your config.sys:
		DEVICE=DRIVE:PATH\XF86SUP.SYS (drive:path is the path
	        where you copied the driver to)
	- Reboot
		
	- Download or copy the NT Glide dll (glide2x.dll)
	  in/to your quake2 directory. (NOTE: NT version, 
	  NOT the windows 95 version of Glide)
	  (http://www.3dfx.com/software/download_glidert.html)
	- Copy q2os23d.cmd to your quake2 directory and
	  execute it

	- Without one
	  Copy q2os2.cmd to your quake2 directory and
	  execute it
	  You'll need to run OS/2 at 16 bits colors or
	  better for Quake 2.

	  Quake 2 will ONLY run in a window, so make
	  sure you have selected this option in win95/NT
	  or change it manually in baseq2\config.cfg:
		set vid_fullscreen "1"
	    to
		set vid_fullscreen "0"

- Never select fullscreen mode *and* software rendering.
  This uses DirectDraw which, at the moment, does not work!

- Quake 2 is now ready to be run in OS/2; just execute q2nolog.cmd (logging off)
  or quake2.exe (logging on)

- The included q2win.cmd & q2win3d.cmd are meant to restore Quake 2 to
  it's original form. 

Some remarks:
	- The crash at exit in Voodoo mode is a known problem
	- Quake 2 is slower in OS/2 than in NT when you're using
	  software rendering. (640x480 is playable on my P200 MMX)
	  On a Voodoo card it's as fast as in NT.
	- Due to a key mapping problem of Open32, the standard cursor
	  keys don't work in Quake 2.
	  Use the arrow keys on the numeric keypad instead or reconfigure
	  the keyboard settings.
	- Game saving isn't working very reliably. You can't load games
	  from a previous Quake session due to what looks like an
	  assumption on Id's part that isn't true in OS/2.
	- Multiplayer over TCP/IP doesn't work (yet)
	- Running timedemo twice hangs Quake.
	- Sound distortion when running the intro with software rendering
	  (runs perfectly on a Voodoo card)
	- Sound hickups (depending on the system, occasionally or often
	  enough to make the game unplayable) with Quake version 3.12 & 3.13.
	  Use an older version instead. (3.10 works fine)

Remember, this is an alpha version so problems like those mentioned above
are to be expected. (and probably more)

Enjoy,

The Win32 for OS/2 team

********************************************************************************
** glQuake
********************************************************************************
glQuake can be converted too. (for use with a 3Dfx Voodoo card only)
I can't get it running though. It always returns the following error:
	miptex >= loadmodel->numtextures
(right after switching to 640x480 and showing a bit of the intro)
But then again, the same happens on my system in Windows 95 or NT.

You'll need to convert glquake.exe and opengl32.dll and make sure the
(converted) Glide for NT dll (glide2x.dll) is present in the Quake 
directory.

Should anybody be able to run it in OS/2, please notify me. (sandervl@xs4all.nl)

********************************************************************************
** PE2LX: The executable converter.
********************************************************************************
PE2LX converts (as the name implies) win32 executables or dlls into
OS/2 exe/dlls.
Command line syntax:
	  pe2lx win32file os2file > outputfile
win32file: 	Windows 95/NT exe or dll name
os2file:   	OS/2 exe or dll name
outputfile: 	name of the file which will contain some debug information
		from pe2lx afterwards.

********************************************************************************
** How to disable logging
********************************************************************************
Although the output generated in win32os2.log very useful for debugging,
it slows things down quite a bit.
You can disable it by adding the following variable to your environment:
  SET NOWIN32LOG=ANY VALUE
You can do this either in config.sys or in a batch file which is used
to start the converted win32 app.
This environment variable must not exist to enable logging.

********************************************************************************
** Converting other win32 applications
********************************************************************************
This distribution can also be used to convert any win32 program you have.
We don't guarantee this will work (actually, the chance is rather high that
it won't).
A lot of win32 apps need comctl32.dll (dll for the common GUI controls).
We haven't implemented it, so you'll need to convert the one
from your Windows 95 or NT installation with pe2lx.

In order to get a complete win32 app converted, you must convert all the
executables and dlls it uses. (check in the output from pe2lx to look
at the modules from which it imports functions)
This is quite a tedious job, but we'll change this in a future release.

********************************************************************************
** Problems/Bug reports
********************************************************************************
When something doesn't work, DO NOT EMAIL US DIRECTLY; YOU WILL BE IGNORED!
Use the newsgroup comp.os.os2.bugs instead.
And only when you're not trying to convert large apps like MS Office,
AutoCAD, Corel Draw etc etc. 
We know that those large apps don't work correctly or at all.

When you post an article to comp.os.os2.bugs, always mention your OS/2
version, FP level, video & sound card model and Quake 2 version. 
(last two obviously not needed for non-Quake related questions/remarks)

We will monitor this newsgroup for articles about Win32 for OS/2.
To make it easier for us to spot such articles, include 'Win32 for OS/2'
in the subject line.

********************************************************************************
** Updates or News
********************************************************************************
Any changes will be reported on our webpage:
	http://www.io.com/~timur/win32os2.html
Don't bother asking us directly; visit the page.

********************************************************************************
** Copyright for XF86SUP.SYS
********************************************************************************
	Copyright (c) 1995, 1996 by Holger Veit (Holger.Veit@gmd.de)

This driver comes with XFree86 for OS/2 and is included to make thing easier.
It's identical to the latest one that comes with XFree86/2.

********************************************************************************
** STANDARD DISCLAIMER
********************************************************************************
The authors makes no representations about the accuracy or suitability of
this material for any purpose.  It is provided "as is", without any
express or implied warranties.  The authors will assume no liability for
damages either from the direct use of this product or as a consequence of
the use of this product. (including software license violations)
