home *** CD-ROM | disk | FTP | other *** search
/ Doom Magazine 1 / Doom_magazine_01.bin / editeurs / die / die.doc < prev    next >
Text File  |  1994-03-30  |  8KB  |  199 lines
  1. /*********************** Doom Image Editor v1.1 ****************************/
  2. -Disclaimer:
  3.      By reading this file DIE.DOC and/or installing it, you hereby 
  4.      acknowledge you the reader are wholly responsible in every way 
  5.      shape or form for any effects the user (you) incur.  I have made
  6.      every reasonable effort to insure DIE executes correctly.
  7.  
  8. -Updates for DIE v1.1:
  9.      - added mouse speed settings to die.cfg.
  10.      - added check for mouse on startup.
  11.      - added visual for image load\save status.
  12.      - the executable is now named DIE.EXE (no more version numbers to type).
  13.  
  14.  
  15. -Stuff I forgot in the last version:
  16.      - DIE is FREEWARE.  Use it, distribute it, upload it,
  17.        but don't exploit it.  Don't act like it's yours and make others
  18.        pay a fee (dollars) for you giving it to them.  That is not cool.
  19.        I released this as FREEWARE, and it shall stay that way.  If you 
  20.        think you need to have someone pay for you to sit on your butt
  21.        and copy it to diskette...that's bull.  However, if you need to milk
  22.        .50 cents out of 'em for a diskette, I suppose that makes sense.
  23.        
  24.      - If you haven't figured it out yet, the right mouse button chooses the
  25.        color to paint with, and the left button drops the pixel onto the 
  26.        image.  and the ESCAPE key gets you out.
  27.        I apologize for this oversight on my part.  In the world of 
  28.        point-and-grunt these days, I assumed end users are born with
  29.        a mouse in their hand. (addleminded....sorrry).
  30.  
  31.      - DIE has been tested on three different machines.  
  32.          -Intel (c) 486 DX - 33, 4M RAM, AMI BIOS (c), TRIDENT(c) vga card,
  33.           Smartdrive (c) running.....  
  34.                - worked fine.
  35.  
  36.          -TANDY (c) 386 SX - 25, 4M RAM, Phoneix (c) BIOS (I think), 
  37.           Stacker (c) running, (and other TANDY hardware).....
  38.                - worked fine.
  39.  
  40.          -AMD (c) 386 DX - 40, 4M RAM, AMI BIOS (c), TRIDENT (c) vga card,
  41.           Smartdrive (c) running....
  42.                - worked fine.
  43.  
  44.           I also ran DIE under the MS Windows(c) environment flawlessly.
  45.           (on the 486).
  46.  
  47.           I have covered numerous machine configurations to verify DIE
  48.           will run correctly on different environments. if it doesn't run 
  49.           on yours, I have done all I can do. 
  50.           (it ran on a tandy for god's sake)
  51.           Any bugs I find will be fixed in due time. 
  52.  
  53.      - It was suggested Jeff Miller (WADTOOLS) might not appreciate his
  54.        program being included in the DIE package.  In post 
  55.        reflection upon this, I should have mentioned in the FILE IDZ
  56.        you need to dl his program in order to use DIE.  I apologize to
  57.        Mr. Miller if this is indeed the case.  Future versions of DIE
  58.        will require the user download the WADTOOLS program written by
  59.        Jeff Miller.
  60.      
  61. -What it is:
  62.      DIE (Doom Image Editor) is a utility for the seemingly endless 
  63.      tools for the DOOM wad.  
  64.      (The game DOOM ain't gonna die out for a looonnggg time.)
  65.  
  66.      You can Export an Image from WADTOOLS (c) Jeff Miller 1994, and
  67.      Import it to DIE.  Then you can paint all over it, Import it back
  68.      to WADTOOLS, and Shazam.  Custom walls.
  69.  
  70.      !!! DO NOT EXPORT THE IMAGE TO A .LBM FILE. !! 
  71.      DIE only works with raw DOOM.WAD data.
  72.  
  73.      If you have the Shareware Version <sigh> (still..). Register DOOM.
  74.      DIE will not work with the Shareware version in keeping with
  75.      ID software's request to limit hacks to the registered version.
  76.  
  77.      At this point, DIE is a point and grunt paint program.  You are
  78.      limited to pixel by pixel painting.  If you wanna gripe, go ahead.  
  79.      Be glad all these DOOM hackers are keeping you griper leeches 
  80.      satisfied !
  81.  
  82. -How to use it:
  83.      (where this file notes < > for explaining configuration info, do not 
  84.       include the "< >".  They are used only for illustration.)
  85.  
  86.      There should be four files in the DIE011.ZIP package:
  87.  
  88.           DIE   .EXE - Doom Image Editor.
  89.           DIE   .DOC - What you is reading.
  90.           DIE   .DAC - Image of the DAC registers.
  91.           DIE   .CFG - DIE'S configuration file.
  92.  
  93.      Bark up your favorite text editor, and change (in DIE.CFG) the line:
  94.  
  95.           doomdir <path_to_wadfile\wadname>
  96.  
  97.      to be set to the path of your DOOM.WAD file with the name of your
  98.      main DOOM.WAD tacked to the end.  (doomdir c:\doom\doom.wad).
  99.      
  100.      I did this so you can have a separate directory for DIE, other than
  101.      you DOOM directory.  (Mine is soooooooo full of stuff.....).
  102.  
  103.      Also, set the desired mouse speed at the line:
  104.  
  105.           mouse <x_speed> <y_speed> <sensitivity>
  106.  
  107.                - x, y, and sensitivity can range from 1 to 100.
  108.  
  109.      go into WADTOOLS (c) Jeff Miller 1994, and find your image to EXPORT.
  110.      give it an extension too, if you want.
  111.  
  112.      Execute DIE like this:   DIE <Image_exported>
  113.  
  114.      If I exported SKY1.DOM from WADTOOLS, (I export mine with extensions), 
  115.      I would type
  116.  
  117.           DIE SKY1.DOM
  118.  
  119.      You will then see a checking of the mouse driver, and a status of
  120.      the image loading.  (or an error message if you made a mistake).
  121.  
  122.      If the file you are loading already exists in the current directory
  123.      with the extension of .DIE, you will be asked if you want to 
  124.      continue; this means the file will be overwritten if you save it
  125.      at the end.
  126.  
  127.      You should then have the image on the screen, a "color bar", and the
  128.      mouse cursor (yes, I KNOW it's ugly in mode 13h, but it turns off
  129.      when you are drawing).
  130.  
  131.      When you grunt on a color with the right mouse button, a small box
  132.      will appear in the lower left corner of the screen in the color
  133.      you chose.  This is the current drawing color.  You may also choose
  134.      a color from the image. 
  135.  
  136.      Use the left mouse button to color a pixel, and the F1 key will
  137.      redraw the screen (if you get sloppy).
  138.  
  139.      When you hit escape, you will be prompted to save the image.  This
  140.      is done regardless.  Even if you didn't change the image.
  141.  
  142.      You will then have a file in the current directory with the .DIE
  143.      extension. This is the file to import back into WADTOOLS.
  144.  
  145.      ONE LAST THING:
  146.           I DON'T HAVE SUPPORT FOR THE ENEMY IMAGES YET.  THIS IS A DIFFERENT
  147.           PIXEL FORMAT.  DO NOT EDIT THESE.
  148.  
  149.  
  150. -Wuz next:
  151.      I'm _thinking_ maybe cut and paste parts of images, shapes maybe,
  152.      fonts so I can actually print to the screen....whole lotta ways to go.
  153.      Probably implement the enemy image editing first, though.
  154.  
  155.      DIE wuz coded in Borland C v3.1.  As far as I know, BC doesn't 
  156.      support mode 13h.  All my calls had to be coded into assembly
  157.      language.  (I do have kind of a nice library now, though).
  158.  
  159.      Only after I started coding DIE, did I find the lib of bitchin' -ness.
  160.      I decided to continue to grunt with mode 13h, but once I get
  161.      my <sigh> homework out of the way, (due 3 weeks ago)
  162.      I'll probably recode the whole mess with Abrash's info on mode-x.
  163.  
  164.  
  165. /************************* Thanks go to: ************************************/ 
  166.  
  167. Jeff Miller 
  168.      - WADTOOLS.
  169.      THANKS!
  170.      Nice program Jeff. Without your exporting, DIE
  171.      would by dead. <pun, grin, grin>
  172.  
  173. Raphael Quinet quinet@montefiore.ulg.ac.be 
  174.      - NEWDEU  
  175.      THANKS!
  176.      Another cool program.  Good luck on the roll-your-own maps,
  177.      I WILL be watching for it.
  178.  
  179. Brendon Wyber (b.wyber@csc.canterbury.ac.nz).
  180.      -DEU
  181.      THANKS!
  182.      Your program was inspiring.  I've spent many hours in front of it.
  183.      
  184. Matt Fell (matt.burnett@acebbs.com)
  185. Hank Leukart (ap641@cleveland.freenet.edu)
  186.      -DMSPECS...
  187.      THANKS!
  188.      Without your specs, I would have given up on the pixel format a long
  189.      time ago.  These were a real HELP.
  190.  
  191. AND thanks go to any one else contributing to the Great Doom Hack, 
  192. may your BFG never go limp.
  193.  
  194. ****************************************************************************/
  195.  
  196.                                                  
  197.  
  198.  
  199.