home *** CD-ROM | disk | FTP | other *** search
/ Quake 'em / QUAKEEM.BIN / quake / programs / quakex11 / quakex.txt < prev   
Encoding:
Text File  |  1996-07-03  |  4.4 KB  |  144 lines
  1.                         QUAKEX 1.1 (July 3 1996)
  2.  
  3.  
  4. WHAT IS QUAKEX?
  5.  
  6.   Quakex is a freeware utility to list and extract the files contained
  7.   in id Software's Quake .PAK archives.
  8.  
  9.   The .PAK archives are similar to the old id Software's DOOM & co. .WAD
  10.   files.
  11.  
  12.   There are a lot of useful files inside the .PAK archives, like the funny
  13.   .WAV sound files, program files, configuration files, ... If you are
  14.   interested to see them, use QUAKEX to extract them.
  15.  
  16.   This program is not based in the official Quake specs. I's based on author's
  17.   own research (wow! It sounds great!). id Software have not contributed in
  18.   in any way in the developement of this program, with the possible exception
  19.   of creating Quake, of course!.
  20.  
  21.  
  22. USAGE
  23.  
  24.   There are actually two implemented functions in the program: list
  25.   contents of archive and extract files from archive. To produce a help
  26.   screen, type QUAKEX without parameters.
  27.  
  28.  
  29.   * List contents of archive (-l):
  30.  
  31.   The syntax is the following:
  32.  
  33.     QUAKEX -l PAKFILE
  34.  
  35.   where PAKFILE is the name of .PAK file.
  36.  
  37.   Example:
  38.     QUAKEX -l PAK0.PAK
  39.  
  40.   will produce the following output:
  41.  
  42.   sound/items/r_item1.wav
  43.   sound/items/r_item2.wav
  44.   sound/items/health1.wav
  45.   sound/misc/medkey.wav
  46.   sound/misc/runekey.wav
  47.   sound/items/protect.wav
  48.   sound/items/protect2.wav
  49.   sound/items/protect3.wav
  50. ...
  51.  
  52.   You can use the optional parameter 'v' to produce a more extended output:
  53.  
  54.     QUAKEX -lv PAK0.PAK
  55.  
  56.   The output is:
  57.  
  58.        6822 0x0000000C sound/items/r_item1.wav
  59.        7448 0x00001AB2 sound/items/r_item2.wav
  60.        7958 0x000037CA sound/items/health1.wav
  61.       10020 0x000056E0 sound/misc/medkey.wav
  62.       14578 0x00007E04 sound/misc/runekey.wav
  63.       22536 0x0000B6F6 sound/items/protect.wav
  64.       34012 0x00010EFE sound/items/protect2.wav
  65.       23364 0x000193DA sound/items/protect3.wav
  66. ...
  67.  
  68.   The first column is the file length in bytes. The second column is the
  69.   position of file inside the archive in hexadecimal notation, and the third
  70.   column is the file name.
  71.  
  72.  
  73.   * Extract a file from archive (-x):
  74.  
  75.   The syntax is the following:
  76.  
  77.     QUAKEX -x<filename> PAKFILE
  78.  
  79.   where <filename> is the name of the file you want to extract with or
  80.   without the directory information. PAKFILE is the name of .PAK file.
  81.  
  82.   Example:
  83.     QUAKEX -xmedkey.wav PAK0.PAK                  or
  84.     QUAKEX -xsound/misc/medkey.wav PAK0.PAK
  85.  
  86.   will extract the file sound/misc/medkey.wav to medkey.wav in the current
  87.   directory.
  88.  
  89.  
  90. HISTORY
  91.  
  92.   Version 1.1, July 3 1996
  93.  
  94.     Noticed and changed some not-very-understandable things in the program:
  95.       - slashes were used to delimite filenames in output, now changed to
  96.         quotes.
  97.       - In previous version only the short form of filename could be used. Now
  98.         it works with both short and long forms.
  99.  
  100.     and some cosmetic minor changes in program and manual.
  101.  
  102.   Version 1.0, June 28 1996
  103.  
  104.     First release of the program. It can list contents and extract files.
  105.  
  106.  
  107. CONTACTING THE AUTHOR
  108.  
  109.   I'm Toni Martinez-Colom. I'm working in the University of Girona
  110.   (Catalonia) as computer-clasroom maintainer. I like very much playing
  111.   Doom (and related programs) in my free time, as well as programming
  112.   in many languages.
  113.  
  114.   This program is freeware. You don't have to pay me anything for it
  115.   although a postcard will be welcome!. I include the source code in
  116.   C. You can make all the changes you want. If you do so, please, send
  117.   me an e-mail message telling where to get a copy of the modified program.
  118.  
  119.   My address is:
  120.  
  121.     Snail-mail:                          E-mail:
  122.       Toni Martinez-Colom                  toni@xauxa.udg.es
  123.       Bosch i Gimpera, 19
  124.       17190 SALT                         WWW:
  125.       CATALONIA                            http://fc.udg.es/~toni
  126.       ("SPAIN"?)
  127.  
  128.  
  129. THINGS TO DO
  130.  
  131.   I'm planning to add an option to replace a file in the archive (you will be
  132.   able to change the sounds...), but I'm waiting for the official Quake
  133.   program specifications to see if it can be done more easily with something
  134.   like PWAD files, as in DOOM. If it isn't possible, I'll program the replace
  135.   option.
  136.  
  137.  
  138. DISCLAIMER
  139.  
  140.   Quake and DOOM are registered trademarks of id Software, inc.
  141.  
  142.   The autor will not be responsible of any damage produced in your
  143.   computer by using QUAKEX. Use it at your own risk.
  144.