=====================================================================
                   README.TXT    11/15/98
=====================================================================

PRBOOM v2.02 --- an official port to WIN32 of the released BOOM source

-This port is based upon BOOM v2.02
-This port was written by Florian "Proff" Schulze, member of TeamTNT
http://www.teamtnt.com
-DOOM is copyright ID software (www.idsoftware.com)
-This port is not endorsed by id software, so don't bug them about it
-I am not responsible for any damage that may be done by this program

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

Contents

Section 1. Installing PRBOOM
Section 2. Configuring PRBOOM
Section 3. Playing PRBOOM in Single Player mode
Section 4. Playing PRBOOM in Serial/Network mode
Section 5. Editing for PRBOOM
Section 6. Differences between PRBOOM and BOOM
Section 7. Files and Directories in the PRBOOM Distribution
Section 8. How to report bugs in PRBOOM
Section 9. Appendix

=====================================================================
-----------------------------
Section 1. Installing PRBOOM
-----------------------------

Requirements:
-------------

PRBOOM requires a minimum of a 486DX/33 with 16M of RAM running
Windows 95 / 98 / Windows NT 4.0 (+SP3 or better).

PRBOOM requires a copy of DOOM, DOOM II, Ultimate DOOM, or Final DOOM already
      installed on your system. In the installation instructions below we use
      C:\DOOM2 to denote the directory it is installed in. Substitute the
      path to DOOM on your system wherever that appears.

PRBOOM requires a sound card, it will not play sounds over the PC speaker. If
you do not have a sound card you should run it with the -nosound option on the
command line. It requires DirectX 2.0 or better if you want to use sound and
fullscreen-drawing.

If you want to run PRBOOM in a window you need 32768 (15 bit) or more to get a
playable view.

To run it fullscreen you need 256 colors. No other color-modes are supported.

Suggested installation procedure:
---------------------------------

1) Unzip the download archive in a new directory, which we will call \PRBOOM.

2) Type PRBOOM -iwad C:\DOOM2, the game will start as usual. To avoid having
  to type -iwad C:\DOOM2, add the line below to your AUTOEXEC.BAT and
  reboot:

  SET DOOMWADDIR=C:\DOOM2

  Alternately you can unzip the PRBOOM archive in your DOOM directory and
  avoid needing -iwad or the change to your AUTOEXEC.BAT file.

  You can also simply copy DOOM1.WAD, DOOM.WAD, or DOOM2.WAD to the PRBOOM
  directory.

3) PRBOOM provides support for mouse, but in the current release the mouse
  is sometimes choppy if you use it in the window-mode, I had no problems
  in fullscreen-mode.

  If you don`t use the mouse you should set use_mouse to 0 in the CFG-File,
  because the game runs a little bit faster.

4) PRBOOM supports different ways to play music. You can choose it with
  the mus_card variable in the cfg-file. You have the following options:
   0 No Music
   1 MCI-Midi, this uses the mci-interface and needs a temporary
     file called prboom.mid
   2 Stream-Midi, this uses the streaming midi-interface and needs
     no more temp-file, but it could make problems.
  Stream-Midi is used by default.

  You can't set the volume of the Midi-Music with the option in the game, with
  it you can only turn the music on and off. You have to set the volume of the
  Midi-Music with the windows-mixer.

  I had some problems with my PCI-Soundcard. I have solved them by setting
  the hardware acceleration to one tick lower than 100%. I have found this
  setting in the control panel under multimedia settings.

  Under Windows 98 I had to install the newest driver for my PCI-Soundcard
  to get MIDI-Music.

  You can change the sampling parameters in the CFG-File.
   snd_channels : This is the number of sound-channels used. A higher value
                  means you can hear more sounds at once, but it also uses
                  more CPU-Power.
   snd_frequency: The sampling-rate, useful values are 11025,
                  22050 and 44100.
   snd_bits     : The bitdepth, allowed values are 8 and 16.
   snd_stereo   : If you have a mono-soundcard you can set this to 0.

5) If sound and music sound ok, and the mouse behaves properly, you're done!

------------------------------
Section 2. Configuring PRBOOM
------------------------------

It's the same as in original BOOM, see boom.txt in the txts/boom directory.

------------------------------------------------
Section 3. Playing PRBOOM in Single Player mode
------------------------------------------------

It's the same as in original BOOM, see boom.txt in the txts/boom directory.

In the game 'ALT-ENTER' switches to fullscreen-mode and all window-keys like
'ALT-TAB' work the same way as in any other windows-program.

Command line parameters
------------------------

*Configuration Options

I have added the following command line parameters:

-condump
 This dumps the output to the files disp.txt and error.txt

-2
 In window mode:
  The gamescreen is stretched by 2 with StretchDIBits
 In fullscreen mode:
  If your display driver is only able to display 640x480 like in the most
  NT drivers, you can use this option to stretch it up to fullscreen.

-m2
 In window mode:
  The gamescreen is stretched by 2 with my own routine (this
  is normally faster on NT)
 In fullscreen mode:
  If your display driver is only able to display 640x480 like in most
  NT drivers, you can use this option to stretch it up to fullscreen.

-fullscr
 Forces fullscreen-mode at startup if it's available

-nofullscr
 Forces window-mode at startup

-width
-height
 Specifies the resolution for the display. The maximum is 1600x1200.
 Usefull values are:

 width    x    height
 --------------------
   320    x      200
   320    x      240
   400    x      300
   512    x      384
   640    x      400
   640    x      480
   800    x      600
   960    x      720
  1024    x      768
  1280    x     1024
  1600    x     1200

 Default is 320x200. If you go higher than 640x480 the game will be
 much slower on most Systems, this has to do with the size of the
 L1-Cache and the L2-Cache.

-noddraw
 Don't use DirectDraw. You will not be able to use fullscreen with
 this option.

-------------------------------------------------
Section 4. Playing PRBOOM in Serial/Network mode
-------------------------------------------------

This is completely different to the original BOOM version, but its
similar to the Linux version of DOOM.

The following command line parameters are for use in netgames:

-net
 After this comes the player number of the machine. Then comes a list
 of host addresses or IP addresses. If you use IP addresses they have to
 begin with a ".". If one of the other machines has another portnumber,
 you can add " :PORTNUMBER" after the address (note that there MUST be
 a blank between the address and the colon).

-port
 If you want to use another port for a machine you can specify it with
 this command.

Here are some samples:

2 Players:
 1. Machine: -net 1 .192.168.1.2
 2. Machine: -net 2 .192.168.1.1

3 Players with changed port on the 2. Machine:
 1. Machine: -net 1 .192.168.1.2 :26001 .192.168.1.3
 2. Machine: -net 2 .192.168.1.1 .192.168.1.3 -port 26001
 3. Machine: -net 3 .192.168.1.1 .192.168.1.2 :26001

The -port command is also useful if you want to run a net game on ONE machine:
2 Players:
 1. Command: -net 1 .192.168.1.1 :26001 -port 26000
 2. Command: -net 2 .192.168.1.1 :26000 -port 26001

*Multiplayer Options

It's the same as in original BOOM, see boom.txt in the txts/boom directory.

------------------------------
Section 5. Editing for PRBOOM
------------------------------

It's the same as in original BOOM, see boom.txt in the txts/boom directory.

-----------------------------------------------
Section 6. Differences between PRBOOM and BOOM
-----------------------------------------------

Whats implemented:
 -mouse
 -keyboard
 -graphics   (using StretchDIBits and DirectDraw)
 -sound fx   (using DirectSound)
 -music      (using Windows-MIDI-Functions)
 -networking (using TCP/IP)

Whats not implemented:
 -joystick

Whats new:
 High-resolutions

-----------------------------------------------------------
Section 7. Files and Directories in the PRBOOM Distribution
-----------------------------------------------------------

PRBOOM executable archive PRBOOM202.ZIP

prboom.exe    The executable for Windows 95 / 98 / NT 4.0
txts          Docs and infos
txts/boom     Docs and infos of the original BOOM distribution
prbstuff      Progs for the Win32-Version. These are from me

PRBOOM source archive PRBOOM202S.ZIP

prboom.dsp            VC50 Project File
prboom.dsw            VC50 Workspace File
src                   All the source files
txts                  Docs and infos
txts/boom             Docs and infos of the original BOOM distribution
txts/doom             Docs and infos of the original DOOM source distribution
makfiles/makefile.dos The DJGPP makefile
makfiles/makefile.c32 The CYGWIN32 makefile
makfiles/makefile.m32 The MINGW32 makefile
boomstuf              Progs for the DOS-Version. These are from BOOM

----------------------------------------
Section 8. How to report bugs in PRBOOM
----------------------------------------

If you find a bug in PRBOOM you should visit

http://www.teamtnt.com

and follow the directions there for reporting it.

For more information on reporting a bug, see boom.txt in the same section.

--------------------
Section 9. Appendix
--------------------

You can get the PRBOOM source at:
http://www.teamtnt.com

You can get the original linux-doom source at:
ftp://ftp.idsoftware.com/source/doomsrc.zip

You can get the BOOM source at:
http://www.teamtnt.com

Thanks go to (in no particular order):
   ID Software for the release of LinuxDOOM

   TeamTNT for BOOM

   Andy Bay for ATBDOOM

   The DOSDOOM-Team for DOSDOOM

   Randy Heit for ZDOOM

-------------------------------------------------------------------------

You are viewing proxied material from liquiddoom.net. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.