home *** CD-ROM | disk | FTP | other *** search
/ Doom (Point Software) / Point_Doom.iso / doom2 / progs / reject11 / reject.txt < prev    next >
Encoding:
Text File  |  1994-11-16  |  5.2 KB  |  137 lines
  1.  
  2.                 REJECT.EXE version 1.1.0
  3.                 Copyright (C) 1994 L.M.Witek
  4.                 lee@trousers.demon.co.uk
  5.  
  6.  
  7. 1.0 Introduction
  8. ----------------
  9.     REJECT.EXE is a command line based utility used for building the 
  10.     REJECT resource in a DOOM or DOOM 2 PWAD file. It post-processes a 
  11.     PWAD which has been created using a level editor such as DEU. Its main 
  12.     purpose is to speed up slow PWAD files by reducing the number of 
  13.     line-of-sight calculations performed by the DOOM engine. 
  14.  
  15.     REJECT.EXE is freeware. 
  16.  
  17. 2.0 Legal bit
  18. -------------
  19.  
  20.     This program is free software; you can redistribute it and/or modify
  21.     it under the terms of the GNU General Public License as published by
  22.     the Free Software Foundation. 
  23.  
  24.     This program is distributed in the hope that it will be useful,
  25.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  26.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  27.     GNU General Public License for more details.
  28.  
  29.     You should have received a copy of the GNU General Public License
  30.     along with this program; if not, write to the Free Software
  31.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  32.  
  33. 3.0 Support
  34. -----------
  35.     
  36.     I can be contacted by email at the above address. All the information 
  37.     required to run and operate REJECT should be provided in this document. 
  38.     Before using REJECT:
  39.                        ********************* 
  40.                         READ THIS DOCUMENT!
  41.                        ********************* 
  42.  
  43.     My spare time is limited so I will not respond to any queries if 
  44.     the answer is to be found in this document. However I would be glad 
  45.     to here from anyone who thinks they have found a bug in REJECT or 
  46.     has any ideas on how to improve REJECT. 
  47.  
  48.     The source to REJECT is provided in the file SOURCE.ZIP you are free
  49.     to use all or part of the source in your own programs, however if you
  50.     do I would be grateful if you would credit me in some way. 
  51.  
  52.     If you create a enhanced version of REJECT from the source provided
  53.     I would be grateful if you would send the modified source to me so
  54.     I can put the enhancements into the 'official' version. 
  55.  
  56.     I will not support any versions of REJECT other than those built by
  57.     myself.
  58.  
  59.     Please _DO_NOT_ send me any large binary files (such as your latest 
  60.     PWAD) as email without my prior consent. My time on the net is limited
  61.     as I have to call long distance to my Internet Access provider and my
  62.     phone bill is large enough already.
  63.  
  64.  
  65. 4.0 Requirements
  66. ----------------
  67.  
  68.     REJECT is a 32 bit DOS extended program built with SYMANTEC C++ v6.11.
  69.     Any machine which is capable of running DOOM will (should :->) be capable
  70.     of running REJECT.
  71.  
  72. 5.0 Usage
  73. ---------
  74.         
  75.     REJECT is run from the DOS command line. The syntax is:
  76.  
  77.         REJECT <WADNAME> <MAPNAME> <THRESHOLD>
  78.  
  79.     Where: 
  80.        <WADNAME>   = Name of the WAD file to process. Don't add .WAD onto 
  81.                      the end of the name.
  82.        <MAPNAME>   = The map name to modify. REJECT will only process one
  83.                      map at a time so if you have more than one map in your 
  84.                      WAD then you need to REJECT multiple times.
  85.                      DOOM 1 & DOOM 2 use different naming conventions for
  86.                      map names. If you are using a DOOM1 wad file use the 
  87.                      format ExMy where x and y are the Episode number and 
  88.                      Map number respectively. DOOM2 map names are constructed
  89.                      thus: MAPxx where xx is the map number from 01 to 32. 
  90.        <THRESHOLD> = The distance at which sectors are rejected. See next 
  91.                      section for explanation of this parameter.
  92.          
  93.  
  94.     eg: reject mywad1 e1m1 600
  95.  
  96.         or
  97.  
  98.         reject mywad2 map01 600
  99.  
  100.  
  101.     NOTE: REJECT writes back to the original wad so make a backup
  102.     before using. Having said that it hasn't corrupted any of the wads
  103.     I've tried it on.
  104.  
  105.     Both DEU and BSP will overwrite the reject table in a wad file so run
  106.     REJECT *AFTER* you run either of these utilities. I use a simple batch
  107.     file to control the edit/run cycle:
  108.  
  109.         deu
  110.         bsp mywad.wad
  111.         reject tmp e1m1 600
  112.         doom -file tmp.wad
  113.  
  114.  
  115.     If you want it to dump a load of debug info use the DOS command 
  116.  
  117.         SET DEBUG_DEVICE=REJECT.LOG
  118.  
  119.     will dump into the file REJECT.LOG which you may (or may not)
  120.     find interesting. :->
  121.  
  122.  
  123. 6.0 Operation
  124. -------------
  125.  
  126.     REJECT works by reading the map specified and creating a list of all
  127.     the sectors which exist in the map. It then takes each sector in turn 
  128.     and compares the distance of all the other sectors. If this distance 
  129.     is less the THRESHOLD parameter the the sector is 'ACCEPTED' in the 
  130.     reject table. If the distance is greater than the THRESHOLD parameter    
  131.     then the sector is 'REJECTED' and DOOM will not perform line of sight 
  132.     calculations for that sector thereby speeding up the operation of DOOM.
  133.  
  134.     The exact value of the THRESHOLD varies greatly from WAD to WAD but
  135.     start by using 600 and see if the game play is acceptable.  
  136.         
  137.