home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / lmpc21.zip / LMPC.DOC < prev    next >
Text File  |  1994-10-24  |  7KB  |  187 lines
  1.                                LMPC
  2.  
  3.                     The DOOM LMP Control Program
  4.  
  5.            Public Version 2.1           24 October, 1994
  6.            by Uwe Girlich 
  7.               (girlich@aix520.informatik.uni-leipzig.de)
  8.  
  9.  
  10. 1. Introduction
  11. ***************
  12.  
  13. LMPC is a small utility to handle DOOM LMP files.
  14.  
  15. It is based upon the information in the "Unofficial LMP format description".
  16.  
  17. With LMPC you can get informations about a LMP, change the version and
  18. viewing player's number and (this is the main part) you compile and 
  19. recompile a LMP from and to a LS file. LS stands for "Lmp Source". 
  20.  
  21.  
  22. 2. Command line parameters
  23. **************************
  24.  
  25. LMPC is a command line oriented program.
  26.  
  27. 2.1 Syntax description
  28. ======================
  29.  
  30. Syntax:      LMPC
  31.  
  32. Description: If you start LMPC without any command line parameters you 
  33.              receive the following syntax message:
  34.  
  35. LMP Control
  36. LMPC (c) U. Girlich, October 1994, Version 2.1
  37.  
  38. "LMPC" Action FileName1 [FileName2]
  39. Action can start with "-" or "/".
  40. -i  FileName            prints out informations about this LMP.
  41. -vn FileName1 FileName2 changes the DOOM version of FileName1 to n
  42.                         and stores in FileName2.
  43. -pn FileName1 FileName2 changes the recording player to n (0<=n<=3)
  44.                         and stores in FileName2.
  45. -s  LMPFile LSFile      recompiles the LMP to a LS file.
  46. -l  LSFile LMPFile      compiles the LS to a LMP file.
  47.  
  48. 2.2 Information about a LMP
  49. ===========================
  50.  
  51. Syntax:      LMPC -i LMPFile
  52.  
  53. InputFile:   LMPFile
  54.  
  55. Description: LMPC reads the LMP file LMPFile and prints out some information
  56.              like version number, episode, map, skill, number of players,
  57.              deathmatch/altdeath, nomonsters etc.
  58.              Please note: in the old format there is no version information,
  59.              so if you check ie a 1.2 LMP file you receive only the vague 
  60.              information v<1.4 instead of v1.2.
  61.  
  62.  
  63. 2.3. Version change
  64. ===================
  65.  
  66. Syntax:      LMPC -vn LMPInFile LMPOutFile
  67.  
  68. InputFile:   LMPInFile
  69.  
  70. OutputFile:  LMPOutFile
  71.  
  72. Description: LMPC reads the LMP file LMPInFile, changes the version number
  73.              to n and stores the result in LMPOutFile. LMPC uses the old
  74.              header format for version numbers <1.4 and the new format
  75.              for version numbers >=1.4.
  76.              Please note: LMPInFile must be different to LMPOutFile.
  77.              
  78.                       There is no guarantee for a special LMP file 
  79.                             to work with the new version!!
  80.  
  81.  
  82. 2.4 Player's view change
  83. ========================
  84.  
  85. Syntax:      LMPS -pn LMPInFile LMPOutFile
  86.  
  87. InputFile:   LMPInFile
  88.  
  89. OutputFile:  LMPOutFile
  90.  
  91. Description: LMPC reads the LMP file LMPInFile, changes the number of the 
  92.              player with the main view (status bar, sound) and stores the 
  93.              result in LMPOutFile.
  94.  
  95.              This works only with new LMP's, since old LMP's are always 
  96.              recorded from the view of the first player and there is no 
  97.              information about this in the header.
  98.              Please note: LMPInFile must be different to LMPOutFile.
  99.  
  100.  
  101. 2.3. LMP Recompiler
  102. ===================
  103.  
  104. Syntax:      LMPC -s LMPFile LSFile
  105.  
  106. InputFile:   LMPFile
  107.  
  108. OutputFile:  LSFile
  109.  
  110. Description: LMPC reads the LMP file LMPFile, recompiles it to the LMP source
  111.              and stores the result in the LS file LSFile.
  112.  
  113.              LMPC appends at the end of the LS file some useful additional
  114.              informations. For each player there is a statistics about his
  115.              favorite movement codes and the portion of WT. Since you can
  116.              achive with keyboard/joystick only a few special movement codes,
  117.              is is very easy to detect, if the player used a keyboard or a 
  118.              mouse. Some new players don't use strafe, so LMPC shows also
  119.              this handicap.
  120.  
  121.              From the favorite movement codes you can easily deduce the 
  122.              number behind a prospective -turbo parameter. Until now you
  123.              have to do this for yourself, but I hope, that in the next 
  124.              version a heuristic algorithm calculates this number.
  125.  
  126.  
  127. 2.4. LMP Compiler
  128. ===================
  129.  
  130. Syntax:      LMPC -l LSFile LMPFile
  131.  
  132. InputFile:   LSFile
  133.  
  134. OutputFile:  LMPFile
  135.  
  136. Description: LMPC reads the LS source file LSFile, compiles it to the 
  137.              LMP format and stores the result in the LMP file LMPFile.
  138.  
  139.  
  140. 3. Known bugs
  141. *************
  142.  
  143. If the quit byte of a multiplayer LMP does not appear after the last game
  144. tic of the last player but, say after the last game tic of the first player, 
  145. then this last (uncomplete) action does not appear in the LS file. LMPC 
  146. analyses only full game tics. Since DOOM itselft produces only well formed 
  147. LMP files, it's not a real bug. Since DOOM can play back also such LMP files 
  148. (you can produce them with LMPC -l) it must be fixed anyway.
  149.  
  150. The LS text parser is very simple and may produce sometimes wrong things.
  151. Please inform me, if you wrote (or prduced with LMPC -s) a correct LS file
  152. ('correct' is described in ls.doc) and LMPC -l can not compile it.
  153.  
  154.  
  155. 4. History of LMPC
  156. ******************
  157.  
  158. 1.0   30.08.1994  lmpc10.zip   (31.08.1994 posted in a.b.d,a.g.d)
  159.       * first public version   
  160. 1.01  31.08.1994  lmpc101.arj  (01.09.1994 posted in a.b.d,a.g.d)
  161.       * bug fixed in WT statistics
  162.       * LS description / LMPC program reference splitted in LS.DOC / LMPC.DOC
  163.       * New heuristic algorithm to discover former version changes.
  164.       * History added in LMPC.DOC
  165.       * Terry (terry@usis.com) wrote also a doom utility (I don't know it) 
  166.         with the archiv name lmpc10.zip. Therefore I changed to the ARJ archiv.
  167. 2.0   11.10.1994  lmpc20.arj   (internal beta test release)
  168.       * the LMP compiler is ready after all!
  169. 2.01  12.10.1994  lmpc201.arj  (internal beta test release)
  170.       * recompiler bug fixed (UT/FW and NW in the same game tic)
  171.       * compiler parser improved (token length test)
  172.       * NW8 (8 gives you the chainsaw directly) added
  173. 2.1   24.10.1994  lmpc21.arj   (25.10.1994 posted in a.b.d)
  174.       * after a error free beta test phase nothing changed, new public version
  175.  
  176. Plan for 2.2
  177. I will add a heuristic algorithm to calculate the -turbo value from the 
  178. favorite movement bytes.
  179.  
  180.  
  181. For further information on LMP's look in the "Unofficial LMP format 
  182. description". The current version is 1.10 (LMP110.DOC on infant2).
  183.  
  184.  
  185. Uwe Girlich             24 October, 1994
  186. girlich@aix520.informatik.uni-leipzig.de
  187.