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