home *** CD-ROM | disk | FTP | other *** search
/ D!Zone (Collector's Edition) / D_ZONE_CD.ISO / programs / editors / dmreject / reject.txt < prev    next >
Text File  |  1994-12-06  |  5KB  |  137 lines
  1.  
  2.                 REJECT.EXE version 1.0.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 PWAD file. It post-processes a PWAD which 
  11.     has been created using a level editor such as DEU. Its main purpose
  12.     is to speed up slow PWAD files by reducing the number of line-of-sight 
  13.     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.     If any mail to me bounces then try sending to:
  65.  
  66.         lee%trousers.demon.co.uk@demon.co.uk
  67.  
  68.     Email from outside the UK sometimes goes missing. I'm not sure why 
  69.     but I am looking into it. Using the longer address should always 
  70.     get to me. Only use the long address if mail to the shorter address
  71.     fails. This will allow me to see where I am having problems recieving 
  72.     from.
  73.  
  74. 4.0 Requirements
  75. ----------------
  76.  
  77.     REJECT is a 32 bit DOS extended program built with SYMANTEC C++ v6.11.
  78.     Any machine which is capable of running DOOM will (should :->) be capable
  79.     of running REJECT.
  80.  
  81. 5.0 Usage
  82. ---------
  83.         
  84.     REJECT is run from the DOS command line. The syntax is:
  85.  
  86.         REJECT <WADNAME> <MAPNAME> <THRESHOLD>
  87.  
  88.     Where: 
  89.        <WADNAME>   = Name of the WAD file to process. Don't add .WAD onto 
  90.                      the end of the name.
  91.        <MAPNAME>   = The map name to modify. REJECT will only process one
  92.                      map at a time so if you have more than one map in your 
  93.                      WAD then you need to REJECT multiple times.
  94.        <THRESHOLD> = The distance at which sectors are rejected. See next 
  95.                      section for explanation of this parameter.
  96.          
  97.  
  98.     eg: reject mywad e1m1 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.