Linux Port of DEU 5.21 8/25/94 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Intro ===== This is a joint port between Brad Hawthorne (u9c192@ugrad.cs.ubc.ca) and Sam Lantinga (slouken@cs.ucdavis.edu). This is presented to you as a tool for building DOOM wad levels in the Linux environment. It is our hope that when DOOM for Linux is released, you will be able to make fast changes to levels while DOOM is running in another virtual console. It is not an official port, though it has been seen by the authors of DEU, and it contains known bugs. The next version of DEU slated to be released will be DEU 5.22 and will be on the way very soon. We will port it as well, and correct any problems found in this port. Since the newer versions will be out soon (we all hope), we will not expend much effort debugging this version of DEU for Linux. Please do not send mail to the original authors of DEU if you have problems with this port. Send mail to either of us who ported this beast, and we will do our best to respond. Remember, this is the first release, so keep up to date, and see if the problems you are having are fixed in the port of DEU 5.22 DEU 6.0 is in the works and should be done in a few months. It is designed with event driven input in mind and will be the first version of DEU to be handled in the port to X11. The authors of DEU will likely be working on this themselves. All disclaimers apply! That said, we hope you enjoy using DEU for Linux. It is a great tool, combined with the BSP node builder, and has produced some of the finest wads on the net. We don't use DEU enough to be of any major help, so please do not send us mail asking how to use it. If you have trouble using DEU, look on the DOOM only anonymous ftp site infant2.sphs.indiana.edu for documentation and if you are still stuck, look to the newsgroup alt.games.doom for helpful advice and hints. Enjoy! Setup ===== 1. Svgalib has been included with this distribution, to ensure that everyone has a version that works with DEU. If DEU works fine with your version of svgalib, then you don't have to worry. If it doesn't, or if you don't have svgalib, read on. a) go into the libs directory and type 'make'. This should install the libraries and config files for you. b) edit /usr/local/lib/libvga.config to reflect your system. c) if you have an et4000 card, edit /usr/local/lib/libvga.et4000 as best you can (its actually the one from my system). If it doesn't work, you will need to run tseng3.exe to create one specifically for your card. Sorry, you have to get it from the svgalib distribution (which can be found on dewdrop.water.ca.gov) 2. In order to use DEU, you must have the files "deu.ini" and "pc8x14.fnt" in the current directory. You will probably need to edit deu.ini so that DEU can locate your main doom.wad. Note: Your doom.wad will have to be located on a partition mounted under Linux, which means it cannot be on a stacked partition. Running ======= First of all, this program uses svgalib, so it does not run under X. Don't even try to run it while in X :) This program (and any svgalib program) must run with root privileges. It is _NOT_ a safe set-uid program. We are not responsible for any misuse of DEU or security holes DEU might possess. If you are careful, it should be okay, but don't let your kid brother play around with 'the new DOOM editor', or he may overwrite /bin/sh or something. Don't Drink and DEU. :) Several new features have been added to this version: 1) From the deu command line you can execute shell commands by typing an exclamation point before the command. eg: !ls 2) If DEU receives a SIGTERM while in the level editor, it will save the level as deulevel.wad in the user's home directory. Note that this is only meant as a safeguard in the case that you forget to save the level before you reboot. Don't go around throwing SIGTERMs at DEU whenever you want to, since it will screw up your display (especially under X) Current known bugs/quirks: ========================== -menu keys won't do anything, nor will shift keys. Use your mouse. If you've specified microsoft mouse in libvga.config, the middle button won't work. (If it does, let me know!) Seems to be because the microsoft protocol doesn't support that third button. You can't run the editor in any video mode other than 0, unless your video card supports linear addressing. Don't blame me, pin it on the guy who did libgrx ;) For what it's worth, here's a quote from the author of GRX for Linux: *************************************************************************** *************************************************************************** *************************************************************************** *** *** *** A WORD OF WARNING. IF YOUR VIDEO CARD SUPPORTS LINEAR ADDRESSING *** *** PLEASE READ THE README FILES IN SVGALIB FOR MORE DETAILS ABOUT *** *** BEING ABLE TO RUN THIS MODE. IF YOUR VIDEO SUPPORTS IT BUT YOUR *** *** SYSTEM CONFIGURATION DOES NOT YOU WILL CRASH YOUR SYSTEM!!!!! *** *** *** *************************************************************************** *************************************************************************** *************************************************************************** The default font 'pc8x14.fnt' for some reason was too tall, so I used pc8x8.fnt and renamed it. If you edit a level and then read in a pwad and then edit the level again, DEU will quit with a little error message. (Is this a bug in DEU itself?) If you discover any bugs that seem to be particular to this Linux version only, please let us know. Brad Hawthorne (u9c192@ugrad.cs.ubc.ca) Sam Lantinga (slouken@cs.ucdavis.edu)