home *** CD-ROM | disk | FTP | other *** search
/ Fun & Games 31 / fun_&_games_nr_31.iso / fg31 / levels / doom2 / boothill / lmputil.doc < prev    next >
Text File  |  1995-05-22  |  6KB  |  211 lines
  1.                         Doom LMP Utility System
  2.                         Version 2.10, 05-22-95
  3.                       Copyright 1995, Raymond Chi
  4.                           All Rights Reserved
  5.  
  6.  
  7. ========
  8. Overview
  9. ========
  10.  
  11. LmpUtil is a program that you can use to display detailed information
  12. about a LMP file. It allows you to set the LMP file version, change
  13. recording player to a different active player, convert 1.0 - 1.2 LMP to
  14. the newer LMP format used with Doom 1.4 - 1.9, remove a section of LMP,
  15. and the ability to add some idle tics at the end of the LMP.
  16.  
  17. It works with any kind of LMP generated by any version of Doom / Doom II.
  18. Heretic LMP is supported, but requires a special parameter to tell LmpUtil.
  19.  
  20. ============
  21. Installation
  22. ============
  23.  
  24. 1) Make a directory and copy all lmputil files to it.
  25. 2) add the directory to your path statement in autoexec.bat
  26.  
  27. Or, if you are using 4dos/Ndos, create an alias that points to
  28. lmputil.exe instead of add the directory to your path.
  29.  
  30. ==========
  31. What's New
  32. ==========
  33.  
  34. The -chop command is implemented. So your -timer 20 lmpfile can now be
  35. exactly 22 minutes long.
  36.  
  37. You can now omit the .lmp file extension in all cases. If the file
  38. specification doesn't contain any period, then the ".lmp" extension is
  39. added automatically.
  40.  
  41. The -cut command is removed from the help screen, but it is still
  42. implemented should you want to play with it.
  43.  
  44. LmpUtil can now display info about multiple files. So you can do
  45.  
  46. lmputil *
  47.  
  48. and it will print info on all *.lmp files.
  49.  
  50. ============
  51. Sample Usage
  52. ============
  53.  
  54. To display information about a LMP, simply type :
  55.  
  56. -> lmputil lmpfile
  57.  
  58. Change the recording player to the next available player :
  59.  
  60. -> lmputil -viewer lmpfile
  61.  
  62. Change the LMP file version to 1.9 :
  63.  
  64. -> lmputil -ver 1.9 lmpfile
  65.  
  66. You can combine -viewer and -ver. For example :
  67.  
  68. -> lmputil lmpfile -ver 1.7 -viewer
  69.  
  70. will set the LMP version to 1.7, and change the recording player.
  71.  
  72. In LmpUtil v2.00, wildcards support is added for -ver and -viewer. Say you
  73. want to convert all the LMPs in your current directory to 1.9, the command
  74. to do it is :
  75.  
  76. -> lmputil -ver 1.9 *.lmp
  77.  
  78. To convert a 1.1 or 1.2 LMP to the newer LMP format, type :
  79.  
  80. -> lmputil -convert source target <optional version>
  81.  
  82. The source and target must not be the same file. Although the program tries
  83. to detect if the 2 files are the same, it will fail if you deliberately
  84. tries to fool it. And in that case, will corrucpt the source file.
  85. If ver is not specified, the target file will have LMP version stamp 1.9.
  86.  
  87. Although the order of parameter doesn't matter, i.e., you can specify the
  88. lmpfile either before or after the -viewer, there must be a version number
  89. follow -ver; a source, a target, and a optional version after -convert.
  90.  
  91. So you cannot, for example, do :
  92.  
  93. -> lmputil -viewer -ver lmpfile 1.6
  94.  
  95. because a lmp version is expected after -ver.
  96.  
  97. To add 100 seconds of waiting time at the end of your LMP, do :
  98.  
  99. -> lmputil -wait 3500 source.lmp target.lmp
  100.  
  101. the 3500 represent 100 seconds, because 35 gametics is 1 second.
  102.  
  103. To remove the first 10 minutes of LMP, do :
  104.  
  105. -> lmputil -cut 1 21000 source.lmp target.lmp
  106.  
  107. -cut and -wait expect time to be specified in gametics, not seconds.
  108. To convert from time to gametics is very easy :
  109.  
  110. 1) convert the time to seconds
  111. 2) multiply the seconds by 35.
  112.  
  113. You can use either - or / as the parameter indicator. All of the above
  114. examples can be done with / instead of -. So you can do, for example,
  115.  
  116. -> lmputil /ver 1.6 lmpfile -viewer
  117.  
  118. If -convert, -cut, -wait is specified, anything after the required parameter
  119. will be ignored. So if you use -heretic, use it as the first parameter.
  120.  
  121. =============
  122. Sample Output
  123. =============
  124.  
  125. Here's an output of a LMP recorded with Doom 1.666 :
  126.  
  127. f:\test>lmputil jayalanw.lmp
  128. LMP Version   : 1.6
  129. Skill Level   : 2, Hey, not too rough
  130. Episode       : 1, Hell on Earth / Knee-Deep in the Dead
  131. Map           : 5, The Waste Tunnels / Phobos Lab
  132. Play Mode     : DeathMatch 2.0
  133. -respawn      : No
  134. -fast         : No
  135. -nomonsters   : Yes
  136. Recorded by   : Indigo
  137. Active Player : Green, Indigo
  138. Game Tick     : 106443
  139. Duration      : 00:50:41
  140.  
  141. Here's an output of a 1.2 Lmp :
  142.  
  143. c:\test\hall>lmputil showdown.lmp
  144. LMP Version   :
  145. Skill Level   : 4, Ultra-Violence
  146. Episode       : 2, The Shores of Hell
  147. Map           : 9, Fortress of Mystery
  148. Play Mode     :
  149. -respawn      :
  150. -fast         :
  151. -nomonsters   :
  152. Recorded by   :
  153. Active Player : Green
  154. Game Tick     : 8078
  155. Duration      : 00:03:51
  156.  
  157. And here's the output when wildcards are used :
  158.  
  159. f:\test>lmputil *.lmp /ver 1.9
  160. ■ LEVEL19.LMP : 1.7 » 1.9 [done]
  161. ■ LEVEL20.LMP : 1.7 » 1.9 [done]
  162. ■ LEVEL21.LMP : 1.7 » 1.9 [done]
  163. ■ LEVEL22.LMP : 1.7 » 1.9 [done]
  164. ■ LEVEL23.LMP : 1.7 » 1.9 [done]
  165. ■ LEVEL24.LMP : 1.7 » 1.9 [done]
  166. ■ LEVEL25.LMP : 1.7 » 1.9 [done]
  167. ■ LEVEL26.LMP : 1.7 » 1.9 [done]
  168. ■ LEVEL27.LMP : 1.7 » 1.9 [done]
  169.      9 file(s) processed, 0 file(s) skipped.
  170.  
  171. ===========
  172. Other Notes
  173. ===========
  174.  
  175. This program is free of charge and there is no registration fee.
  176. However, If you like the program and found it useful, send me an e-mail.
  177.  
  178. You may distribute this program as long as it is unmodified, and contains
  179. the whole package (lmputil.exe, lmputil.doc, lmputil.new and lmputil.faq)
  180. Selling, lending, and leasing this software is not permitted.
  181.  
  182. If this program is to be put into a Doom type CD of *any* kind, you
  183. *must* get permission from me first.
  184.  
  185. This is the first program I released into the public, I would appreciate
  186. any feedbacks.
  187.  
  188. =======
  189. Credits
  190. =======
  191.  
  192. Of course, credit must go to id software for such an excellent game,
  193. and Uwe Girlich for the unofficial Doom LMP spec 1.10.
  194.  
  195. ===========
  196. Legal Stuff
  197. ===========
  198.  
  199. THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". THE AUTHOR HEREBY
  200. DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  201. DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  202. TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  203. PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
  204. TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
  205. SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
  206. OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  207.  
  208. Raymond Chi
  209. chiry@po.EECS.Berkeley.EDU
  210. 05-22-95
  211.