home *** CD-ROM | disk | FTP | other *** search
/ Doom 2 Explosion / Doom2Explosion.bin / doom2exp / programs / dfe131 / dfe.txt < prev    next >
Text File  |  1994-05-13  |  22KB  |  483 lines
  1. =================     ===============     ===============   ========  ========
  2. \\ . . . . . . .\\   //. . . . . . .\\   //. . . . . . .\\  \\. . .\\// . . //
  3. ||. . ._____. . .|| ||. . ._____. . .|| ||. . ._____. . .|| || . . .\/ . . .||
  4. || . .||   ||. . || || . .||   ||. . || || . .||   ||. . || ||. . . . . . . ||
  5. ||. . ||   || . .|| ||. . ||   || . .|| ||. . ||   || . .|| || . | . . . . .||
  6. || . .||   ||. _-|| ||-_ .||   ||. . || || . .||   ||. _-|| ||-_.|\ . . . . ||
  7. ||. . ||   ||-'  || ||  `-||   || . .|| ||. . ||   ||-'  || ||  `|\_ . .|. .||
  8. || . _||   ||    || ||    ||   ||_ . || || . _||   ||    || ||   |\ `-_/| . ||
  9. ||_-' ||  .|/    || ||    \|.  || `-_|| ||_-' ||  .|/    || ||   | \  / |-_.||
  10. ||    ||_-'      || ||      `-_||    || ||    ||_-'      || ||   | \  / |  `||
  11. ||    `'         || ||         `'    || ||    `'         || ||   | \  / |   ||
  12. ||            .===' `===.         .==='.`===.         .===' /==. |  \/  |   ||
  13. ||         .=='   \_|-_ `===. .==='   _|_   `===. .===' _-|/   `==  \/  |   ||
  14. ||      .=='    _-'    `-_  `='    _-'   `-_    `='  _-'   `-_  /|  \/  |   ||
  15. ||   .=='    _-'          `-__\._-'         `-_./__-'         `' |. /|  |   ||
  16. ||.=='    _-'                                                     `' |  /==.||
  17. =='    _-'         F    R    O    N    T        E    N    D           \/   `==
  18. \   _-'                                                                `-_   /
  19.  `''                                                                      ``'
  20.                        Release v1.31 - May 08, 1994 EST
  21.                Written by: Josh Jackson (joshjackson@delphi.com)
  22.             "DOOM: Where hackers gnaw the bones left from the banquet
  23.                  of data prepared by the mighty wizards of id."
  24.                        - The Unofficial DOOM Specs v1.3 -
  25.            "The poets talk about love, but what I talk about is DOOM,
  26.                   because in the end, DOOM is all that counts."
  27.             - Alex Machine/George Stark/Stephen King, _The Dark Half_
  28. -----------------------------------------------------------------------------
  29.  
  30. ----------------
  31. ACKNOWLEDGEMENTS
  32. ----------------
  33.  
  34.    Thanks Id for such a KICK ASS game!!  DOOM is a registered trademark of Id 
  35.    Software.
  36.    Hank Leukart for the "OFFICIAL" DOOM FAQ. (And the cool header!)
  37.    Matt Fell for the Unofficial DOOM Specs v1.3
  38.    
  39. --------
  40. CONTENTS
  41. --------
  42.  
  43. =SECTION ONE=  Introduction
  44.       [1-1] What is DFE?
  45.       [1-2] Distribution of DFE
  46.       [1-3] Obtaining the Source
  47.       [1-4] Disclaimer
  48.  
  49. =SECTION TWO=  Using DFE
  50.       [2-1] Single Player Games
  51.       [2-2] Serial Link Games
  52.       [2-3] IPX Network Games
  53.       [2-4] Modem Link Games
  54.       [2-5] Sprite Viewer
  55.       [2-6] Map Viewer
  56.  
  57. =SECTION THREE= Misc Info
  58.       [3-1] Known Bugs
  59.       [3-2] Trouble Shooting
  60.       [3-3] Version History
  61.       [3-4] Setting up an IPX Network for DOOM
  62.  
  63. ------------------------------------------------------------------------------
  64. SECTION *1*:  Introduction
  65. ------------------------------------------------------------------------------
  66.  
  67. [1-1]: What is DFE?
  68.    
  69.    DFE is a Front End for that wondrous program DOOM!  For those of you that
  70.    are not familiar with the term "front end", well, it is simply a way of
  71.    configuring DOOM without all of the hassles of trying to remember the which
  72.    of the bazillion command line parameters you can pass to DOOM and the 
  73.    SERSETUP/IPXSETUP programs you need to use.  DFE gives you an easy to use, 
  74.    text based user interface for selecting things like: Starting Episode, 
  75.    Starting Map, Skill Level, Number of players, etc.
  76.  
  77. [1-2]: Distribution of DFE
  78.  
  79.    PLEASE distribute this utility to anyone and everyone that can make use of
  80.    it.  There is no registration fee or any other such BS.  The only thing 
  81.    that I do request is that you include this document, in its entirety along
  82.    with the program.  The following files are needed for DFE:
  83.  
  84.                DFE.EXE   (the Front End executable file)
  85.                THING.DEF (Things Definition file for the Map Viewer)
  86.                DFE.TXT   (this document)
  87.  
  88. [1-3]: Obtaining the source for DFE
  89.  
  90.    If you would like a copy of the source to this program, I will gladly mail
  91.    you a copy.  It was written in Turbo Vision for Borland Pascal v7.
  92.    
  93.    Mail your request to the following:
  94.  
  95.             Jackson Software
  96.             10506 Bayard Rd.
  97.             Minerva, OH  44657
  98.  
  99.    Please include $5.95  for shipping of just the source diskette, or $9.95
  100.    for the diskette and a printed copy (at this point it is a good 50 pages
  101.    or so).
  102.  
  103. [1-4]: Disclaimer
  104.  
  105.    This program come with with no warranty, expressed or implied.  Anyone
  106.    who uses this program, uses it at their own risk (what risks these are,
  107.    one can only guess).
  108.    
  109.    The Author excepts NO responsibility for anyone who should become
  110.    clinically insane, or otherwise incapacitatied for any reason during
  111.    the use of this program.  Nor shall the Author be held responsible for
  112.    anyone out there that obtains the source, and thinking they are a brain,
  113.    should modify it and cause damage to themself or their computer.
  114.    
  115.  
  116. ------------------------------------------------------------------------------
  117. SECTION *2*:  Using DFE
  118. ------------------------------------------------------------------------------
  119.       
  120.  
  121.  
  122. [2-1] Single Player Games
  123.       
  124.    After Loading DFE  (this should not be too difficult!) you will receive a
  125.    menu giving you selections for Single Player, Serial Link, IPX Network, and
  126.    Modem Link.  To play a single player game, select modem link (just kidding)
  127.  
  128.    After selecting your game type, you will be prompted for the episode name
  129.    or an External Wad file.  If you choose a predefined Episode (1-3), you
  130.    will then be given a list of your game options.  This area will differ
  131.    depending on the game type and episode selected.  For a single player game,
  132.    you will be given the option to select your level, skill, and no monsters
  133.  
  134.    The option of No Monsters is exactly what it sounds like, NO MONSTERS. In
  135.    a single player game, the only use I can think of for this is when you
  136.    just feel like poking around, trying to find secrets and the like.
  137.  
  138.    After you have made your selection, press the OK button or Enter if you
  139.    haven't already selected the cancel button.
  140.  
  141.    The option of loading and External WAD file is not a whole lot more
  142.    difficult than the above.  From you Episode selection box, simply select
  143.    External WAD File.  You will then be given a file list dialog box.  Select
  144.    the appropriate WAD file.  DFE will then open the selected WAD file to 
  145.    ensure that is both valid and contains a level to play.  If both of
  146.    these criteria are met, it will then load the level names out of the WAD
  147.    file.  At this point in time, you can only have up to 9 levels in a patch
  148.    wad file and access it from DFE.
  149.  
  150. [2-2] Serial Link Games
  151.       
  152.    If you have not read 1-1 yet, please do so, as I only explain the
  153.    difference between a the two here.
  154.  
  155.    In a Serial Link game the only real differences from a single player
  156.    game is the selection of your COM port and whether or not you want to play
  157.    a DEATHMATCH.
  158.  
  159.    Before DFE will spawn DOOM, it will attempt to locate the DOS external
  160.    command MODE.COM.  It uses this utility to set the Baud rate and parity
  161.    of your selected COM port.  If it can not locate MODE, it will simply
  162.    display a message box, pause briefly, and then continue with execution
  163.    of SERSETUP.EXE.
  164.  
  165. [2-3] IPX Network Games
  166.  
  167.    If you have not read 1-1 yet, please do so, as I only explain the
  168.    difference between a the two here.
  169.    
  170.    In an IPX Network game the only real differences from a single player
  171.    game is the selection of the number of players and whether or not you 
  172.    want to play a DEATHMATCH.
  173.  
  174.    Please do note that an IPX driver must be loaded before DFE will even
  175.    enable the IPX Network menu selection.  It is NOT necessary to be connected
  176.    to a Local Area Network (LAN), nor does there need to be any form of
  177.    server present for IPX Network DOOM to work.  Simply installing LAN cards
  178.    in more than one machine, linking them with cable and loading the IPXODI
  179.    packet drivers is all that is necessary.  (See section 3-4 for information
  180.    on setting up your own DOOM network!)
  181.      
  182. [2-4] Modem Link Games
  183.    
  184.    If you have not read 1-1 yet, please do so, as I only explain the
  185.    difference between a the two here.
  186.  
  187.    In a Modem Link game the only real differences from a single player
  188.    game is the selection of your COM port,whether or not you want to play a
  189.    DEATHMATCH, and the type of modem connection you will be making.
  190.  
  191.    The possible modem connections are: Dial and connect, Wait for call, and
  192.    Already connected.  If you specify Dial and connect, you must fill in the
  193.    Number to Dial field.
  194.    
  195.    Before DFE will spawn DOOM, it will attempt to locate the DOS external
  196.    command MODE.COM.  It uses this utility to set the Baud rate and parity
  197.    of your selected COM port.  If it can not locate MODE, it will simply
  198.    display a message box, pause briefly, and then continue with execution
  199.    of SERSETUP.EXE.
  200.  
  201. [2-5] Sprite Viewer
  202.  
  203.    This function has been dropped from the main menu and has been incorporated
  204.    into the Map View.
  205.  
  206. [2-6] Map Viewer
  207.  
  208.    This Function allows you to view the DOOM maps before you play the game.
  209.    It will display monsters, weapons, and "goodies".  The goodies include
  210.    keys, ammo, health kits/bonuses, armor, soul spheres (supercharge),
  211.    invisibility sphere, light goggles, radiations suits, berserk, and computer
  212.    area maps.
  213.  
  214.    If you select this option from the main menu, you will then be prompted
  215.    for the desired episode.  You can also specify an external WAD file, this
  216.    is real handy when downloading DEATHMATCH WAD files from various BBSs, etc.
  217.  
  218.    After selecting the episode or WAD file of your choice, you will be
  219.    given a list of viewer options.  First of these options is the level that
  220.    you wish to view.  Next, whether or not you want it to display the
  221.    monsters, weapons, or goodies, the skill level you want to view (Viewing a 
  222.    skill level will show you just what you are going up against.), and finally
  223.    whether or not you want to view it as a MultiPlayer game (some items will
  224.    only appear in a multiplayer game).
  225.  
  226.    Once you are viewing the map, the following keys will have effect on the
  227.    map:
  228.  
  229.          M        (Toggle monsters on/off)
  230.          G        (Toggle goodies on/off)
  231.          W        (Toggle weapons on/off)
  232.          P        (Toggle Multiplayer on/off)
  233.          1-5      (Select skill level 1-5)
  234.          S        (Toggle secrets on/off)
  235.          +        (Zoom in on map)
  236.          -        (Zoom out)
  237.          Home     (Return view to original)
  238.          Arrows   (Move map around on the screen, handy for zooming)
  239.  
  240.    You will also notice the status display in the upper left hand corner.
  241.    This display shows the current status of the display toggles, as well
  242.    as the color of each.  Using the mouse to select any one of these options
  243.    is allowed and works the same as pressing the keys to do so.
  244.  
  245.    The color scheme used by ViewMap is as follows:
  246.  
  247.          Blue        Walls
  248.          Lt. Blue    Doors
  249.          White       Secrets
  250.          Red         Monsters
  251.          Yellow      Weapons
  252.          Green       Goodies
  253.  
  254.    Note for DOOM TechHeads:  The Secrets the will show up in white are
  255.    LineDef based and will not show a Sector that is marked a secret.  I
  256.    have noticed that some secrets do not have a LineDef defined as a secret,
  257.    but only the Sector that they border.  (However the majority of DOOM's
  258.    secrets have at least one LineDef defined as a secret.)
  259.  
  260.    New to DFE 1.3 is the ability to view sprites from the Map Viewer.  To
  261.    view any sprite that is drawn on the map, simply select to wil the mouse
  262.    and press the LEFT mouse button.  You will be given a Sprite Viewer window
  263.    in the lower right corner of the screen.  To clear the sprite viewer, 
  264.    simply select any option that redraws the Map. (Changing Skill Level, Scale
  265.    factor, X and Y Offsets, Mosters, Goodies, Etc.)
  266.  
  267.  
  268. =SECTION THREE= Misc Info
  269.  
  270. [3-1] Known Bugs
  271.       
  272.    At this point I have not found any major bugs in the program. (AMAZING!!)
  273.    If you do run into any errors or glitches, please let me know by EMail
  274.    or snail mail (to the address seen later on in this document).  I have 
  275.    spent many hours developing this program and don't want anyone considering 
  276.    it a pain to use because of some nasty little glitch.
  277.  
  278.       
  279. [3-2] Trouble Shooting
  280.       
  281.    The following is a list of problems that you may encounter while running
  282.    DFE.
  283.  
  284.    Q) Why am I running out of memory when running DOOM?  I used to have
  285.       plenty.
  286.    A) There are a couple of things that could be going wrong.  If your
  287.       system uses and Expanded Memory, DFE will take advantage of this for
  288.       Program Swapping.  If you have less than 8Mb in your computer, I would
  289.       recommend that you either disable your Expanded Memory while playing
  290.       DOOM, or specify the parameter /NOEMS when running DFE.
  291.  
  292.       Note: DFE only requires about 1k of base memory after it has swapped 
  293.             out; I can't foresee this causing any problems!  But it will use
  294.             up to about 250k of EMS if it is available, this will reduce the
  295.             amount of DPMI memory available to DOOM by about 256k.
  296.       
  297.       Personally, I have a 386dx/40 with 8Mb of RAM,  I have never had a
  298.       problem with memory, even when I am running a series of IPX network
  299.       drivers and a 2Mb disk cache.
  300.       
  301.    Q) Why is the IPX Network selection disabled?
  302.    A) You don't have an IPX driver installed!
  303.  
  304.    Q) Why won't the Serial Link work?
  305.    A) Welp, these is slew of problems that you could be having.  Mainly,
  306.       you should make sure that you have the DOS command MODE.COM in either
  307.       the current directory or the Path. (DFE uses this to ensure that your
  308.       COM port is set correctly)
  309.  
  310.       Secondly, I have not had much luck with Serial Link, especially when
  311.       linking two computers of different speeds together.  After about 2-3
  312.       minutes of play they will begin to bog down until the game becomes
  313.       unbearably slow.
  314.  
  315.    Q) Why is Modem Link DOOM so slow?
  316.    A) Make sure that you are connected at 9600 baud, N81.  Also, make sure
  317.       that any error correction or data compression is turned OFF!  This
  318.       makes a big difference in the way the game performs.
  319.  
  320.    Q) Why won't the Map Viewer allow me to view sprites?
  321.    A) DFE was unable to set 640x480x256 color mode.  This can be caused by
  322.       any of the following:
  323.          1) An incompatible SVGA video card
  324.          2) Lack of an SVGA video card  (DUH!)
  325.          3) Not enough video RAM (265k SVGA cards don't support this mode!)
  326.       #1 can be corrected on most machines by installing the supplied UNIVBE
  327.       driver of a vendor provided VESA driver.
  328.  
  329. [3-3] Version History
  330.  
  331.    v1.0  Allowed you to only select the level you wanted to play from existing
  332.          levels.
  333.  
  334.    v1.1 Added Map Viewer and .OVL file to save on memory.  Map Viewer was in
  335.         a separate executable file.  Allowed the selection of external WAD
  336.         files.
  337.  
  338.    v1.2 Removed .OVL and added memory swapping.  Saves an extra 150k of memory
  339.         Integrated the Map Viewer into DFE.
  340.  
  341.    v1.21 Fixed a small bug in v1.2 that would not allow you to view a map if
  342.          the filename was 8 characters long. (Sounds weird, but thats what I
  343.          get for using so many stinking pointers and linked lists in this
  344.          program!)
  345.  
  346.    v1.3  MapView has been COMPLETELY rewritten into fully object oriented
  347.          code, allowing for better control over the map (Internally).
  348.          MapView also now allows you to "Click" on any sprite on the map
  349.          and view it.
  350.  
  351.    v1.31 Fixes a Memory allocation problem when disposing of a Map Viewer.
  352.  
  353.    Future Releases:
  354.    v2.0  Will include a Map Search to find the selected sprite on all maps.
  355.          I Plan to also include a LineDef tag locator to associate those 
  356.          secrets that you just can't seem to figure out with their necessary 
  357.          trigger locations. I have also located the source to both a SERSETUP 
  358.          and IPXSETUP communications driver for DOOM, I am currently 
  359.          converting them to Pascal so that they can be built in to DFE.
  360.          
  361.          The only thing stopping v2.0 from going into beta at the moment it
  362.          the fact that the Map Viewer User Interface is currently begin 
  363.          revised into a fully event driven GUI.  The new user interface 
  364.          will look and behave somewhat like Microsoft Windows.  Since such a 
  365.          GUI is no small task, this is going to take a little time.
  366.  
  367.    DOOM_DOS v.99 is currently being developed for those of you who are "balls
  368.          to the walls" DOOM players.  This program, which is a COMMAND.COM
  369.          replacement, will allow you to view any part of the WAD file
  370.          directory as a DOS style directory structure.  It will also
  371.          allow you to import new levels, sprites, sounds, and textures.
  372.  
  373.          It will enable you to load SERSETUP and IPXSETUP style drivers
  374.          as DOOM_DOS device drivers.  These driver, which are also under
  375.          development, will be written in 100% 80386 assembly language to 
  376.          provide optimal efficeincy and speed.
  377.  
  378.          Since this program will be a COMMAND.COM replacement, it will also
  379.          have its own AUTOEXEC.BAT style start up file.  This will enable you
  380.          to load any other programs as well (Mouse Drivers, Disk Caches, etc)
  381.  
  382.  
  383. [3-4] Setting up an IPX Network for DOOM
  384.  
  385.    If you have never played IPX Network DOOM, you are missing out BIG TIME!
  386.    Imagine playing up to 4 player DOOM with very little or NO slowdown in
  387.    game performance.  Unlike Serial Link or Modem Link DOOM which can very
  388.    seriously slow down the game if one of the two players (and ONLY two 
  389.    players) is running on a 386 based or a slower 486 based machine, IPX
  390.    networks give you high speed, fluid game play.  The reason is simple,
  391.    DOOM is designed to communicate with a serial device (this includes modems)
  392.    at only 9600 baud.  At this rate, you are only transferring around
  393.    800-1000 bytes per second.  A SLOW network transfers about 1,250,000
  394.    bytes per second!!  Some of the faster networks can transfer up to 
  395.    16,000,000 bytes per second! (Talk about a speed increase!)
  396.  
  397.    Welp, Jackson Software can help.  I am currently selling everything that
  398.    you need to setup a full blown EtherNet IPX driven network.  This may
  399.    sound a bit expensive, but its not too bad.  (I have one myself)
  400.  
  401.    Do note that it is not necessary to set up a Novell LAN or any other such
  402.    outrageously priced network just to play Network DOOM.  All that is needed
  403.    is a set of EtherNet (or similar) cards, the cables, your computers, and
  404.    DOOM!
  405.  
  406.    My current setup for IPX DOOM is 2 386dx/40Mhz and 2 486sx/33Mhz.  With
  407.    these machines I can not tell the difference between a single player
  408.    game and a multiplayer game as far as speed is concerned.
  409.  
  410.    If this sounds appealing to you here, is how to obtain your network
  411.    hardware:
  412.  
  413.             Send check or Money Order to:
  414.  
  415.             Jackson Software
  416.             10506 Bayard Rd.
  417.             Minerva, OH  44657
  418.  
  419.             or Call:
  420.             (216) 868-1169
  421.  
  422.    Network Pricing:
  423.  
  424.       One EtherNet Node.........................................$75
  425.          LanPro NE2000 EtherNet Card
  426.          Software Drivers
  427.          Instructions for NetDOOM Setup
  428.          The latest copy of DFE
  429.          10ft EtherNet Coax Cable
  430.          2 50ohm EtherNet Terminators
  431.  
  432.       Two EtherNet Nodes........................................$145
  433.          2 LanPro NE2000 EtherNet Cards
  434.          Software Drivers
  435.          Instructions for NetDOOM Setup
  436.          The latest copy of DFE
  437.          10ft EtherNet Coax Cable
  438.          2 50ohm EtherNet Terminators
  439.  
  440.       Three EtherNet Nodes......................................$215
  441.          3 LanPro NE2000 EtherNet Cards
  442.          Software Drivers
  443.          Instructions for NetDOOM Setup
  444.          The latest copy of DFE
  445.          2 10ft EtherNet Coax Cables
  446.          2 50ohm EtherNet Terminators
  447.  
  448.       Four EtherNet Nodes.......................................$285
  449.          4 LanPro NE2000 EtherNet Cards
  450.          Software Drivers
  451.          Instructions for NetDOOM Setup
  452.          The latest copy of DFE
  453.          3 10ft EtherNet Coax Cables
  454.          2 50ohm EtherNet Terminators
  455.  
  456.       The following is included on disks FREE of charge for each purchase
  457.       of any of the above Network packages:
  458.  
  459.          The DOOM Hacker's tool kit (Disk 1)
  460.             The Latest version of the Unofficial DOOM Specs
  461.             The Latest version of the "Official" DOOM FAQ
  462.             The Latest version of the DEU level editor
  463.                Includes a demo and all C source
  464.             The Pascal Source for DFE
  465.                Includes MANY routines for accessing a variety of info
  466.                in the WAD file.
  467.  
  468.          The Jackson Software's  "Outstanding DeathMatch WAD collection"
  469.          (Disk 2)
  470.             This collections includes many of my favorite WAD files
  471.             created by varying authors especially for DEATHMATCHES!
  472.  
  473.  
  474.  
  475.                                  Happy Hunting!
  476.  
  477.                                       \   /
  478.                                     (O)   (O)
  479.                                         |
  480.                                      \_____/
  481.  
  482.                                           JJ
  483.