home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 19 / WW_DEMO.iso / gp2 / gp2jamt.txt < prev    next >
Text File  |  1996-06-24  |  9KB  |  199 lines
  1.                  GP2JAM - Grand Prix 2 JAM to BMP Converter
  2.  
  3.       Copyright (c) 1996 Trevor Kellaway (100331.2330@compuserve.com)
  4.  
  5.                              V1.1 3rd Sep 1996
  6.  
  7.              Jump to the latest information on GP2 and GP2JAM.
  8.             Jump to the latest online version of this document.
  9.               Download the latest online version of GP2JAM.ZIP
  10. ---------------------------------------------------------------------------
  11. Introduction
  12. Grand Prix 2 (GP2) from Microprose stores its image files in a unique
  13. format, these files have the extension '.JAM' (referred to as 'JAM' files).
  14.  
  15. GP2JAM is a DOS program which converts GP2 JAM files to .BMP files and back
  16. again. You will find these images in \GP2\GAMEJAMS\ on your hard disk (or
  17. CD-ROM drive).
  18.  
  19. This version of GP2JAM supports the car image JAM files, thus you can
  20. convert from a WILLIAMS.JAM file to a WILLIAMS.BMP. You can now use your
  21. favourite bitmap editor to modify the image and save it. Next you would
  22. convert the WILLIAMS.BMP back to WILLIAMS.JAM.
  23. ---------------------------------------------------------------------------
  24. Installation
  25. This distribution should include the following files:
  26.  
  27.         GP2JAM.TXT      A text version of the help file.
  28.         GP2JAM.HTM      An HTML version of the help file.
  29.         GP2JAM.EXE      The converter program.
  30.  
  31. Copy GP2JAM.EXE to any directory on your hard disk, I recommend that you
  32. create a new directory (say '\JAM'), you can then keep all your updated
  33. JAMs and BMPs there without cluttering up the game directories (this also
  34. allows you to reinstall the game without losing your images).
  35. ---------------------------------------------------------------------------
  36. Quick Start
  37. Here is a quick tutorial on how to start painting the Williams.
  38.  
  39. Change directory to where you put GP2JAM.EXE ('\JAM'). Convert the Williams
  40. JAM file to a bitmap by typing the following at a DOS command prompt:
  41.  
  42.         GP2JAM -j\GP2\GAMEJAMS\WILLIAMS.JAM
  43.  
  44. This should create a WILLIAMS.BMP in the current directory (Note: If the
  45. game is stored on a different drive then add the appropriate drive letter
  46. at the front of the filename).
  47.  
  48. Now startup your favourite bitmap editor (Paint Shop Pro is a good one,
  49. much better than Windows/W95 Paintbrush) and load the WILLIAMS.BMP. You
  50. should see a picture of the different panels of the car. Paint the car and
  51. then save the WILLIAMS.BMP again.
  52.  
  53. Now back at the DOS prompt convert the file back to a JAM:
  54.  
  55.         GP2JAM -bWILLIAMS.BMP -j\GP2\GAMEJAMS\WILLIAMS.JAM
  56.  
  57. That should be it. Startup GP2 and admire your work!
  58. ---------------------------------------------------------------------------
  59. Important
  60. All of the JAM files have a unique identity (ID) encoded in them so you
  61. can't copy a WILLIAMS.JAM over the top of say a BENETTON.JAM, you will get
  62. a transparent car! GP2JAM will always display the actual JAM ID when
  63. converting to help you identify which file you are manipulating, this only
  64. becomes useful if you start renaming the JAM files in your directory (don't
  65. rename the games JAM files!).
  66. ---------------------------------------------------------------------------
  67. Usage
  68.  
  69. GP2JAM [-h?v] [-y] [-bFILENAME.BMP] [-jFILENAME.JAM]
  70.  
  71.      -h|-?         Display this usage message.
  72.      -v            Display the version number & contact information.
  73.  
  74.      -jFNAME.JAM        Set the JAM filename to be 'FNAME.JAM'.
  75.      -bFNAME.BMP        Set the BMP filename to be 'FNAME.BMP'.
  76.  
  77.      -y            Automatically answer all questions with 'Yes'.
  78.  
  79. When converting from a JAM to BMP you need only specify the JAM filename:
  80.  
  81.         GP2JAM -jWILLIAMS.JAM
  82.  
  83. This will automatically create a WILLIAMS.BMP (based on the JAM ID), if the
  84. WILLIAMS.BMP file already exists you will be asked if you wish to overwrite
  85. it. You can turn off these prompts by using the '-y' option which will
  86. automatically respond 'Yes' to all prompts.
  87.  
  88. If you wanted to use a different bitmap filename specify it after the JAM
  89. filename:
  90.  
  91.         GP2JAM -jWILLIAMS.JAM -bCAR1.BMP
  92.  
  93. To convert back from a BMP to a JAM file you must specify both filenames
  94. and the BMP filename must be first:
  95.  
  96.         GP2JAM -bWILLIAMS.BMP -jWILLIAMS.JAM -y
  97.  
  98. This will update the existing WILLIAMS.JAM file (Note: the '-y' option was
  99. present to automatically respond to the overwrite prompt).
  100.  
  101. You can display the usage message by starting GP2JAM either with no command
  102. line options, or use either '-?', or '-h'.
  103.  
  104. To find out which version of GP2JAM you have use the '-v' option, this also
  105. displays the author's E-mail address and web site URL.
  106. ---------------------------------------------------------------------------
  107. Bitmaps and Palettes
  108. When you first convert an original game JAM file GP2JAM may display the
  109. following warning:
  110.  
  111.  'Warning: The image contains unique colours which can't be mapped to GP2JAM's
  112.  standard palette, these will be mapped to the nearest colour available.'
  113.  
  114. Don't worry about this, GP2JAM uses a different fixed palette to that of
  115. the cars in the game and maps the game colours to the nearest available
  116. ones in its palette. When you perform a later update of a car you've edited
  117. previously you won't get this warning.
  118.  
  119. When saving the BMP image don't change the colour depth (256) or change the
  120. image size. You can use any of the colours from the fixed palette (the
  121. first 192) but *don't* change the palette as this is fixed by the game and
  122. the BMP just contains a copy (changing the palette won't have any effect in
  123. the game). Make sure you save the bitmap RGB encoded (not RLE or OS/2
  124. encoded).
  125.  
  126. Don't over paint the background (dull green) colour or move any of the car
  127. parts. A good way to paint large areas is to use the selective colour
  128. eraser tool which is available in most good painting packages.
  129.  
  130. The BMP has several small rectangles which are all one colour, these are
  131. the suspension arms.
  132. ---------------------------------------------------------------------------
  133. Known Problems
  134. GP2JAM has been tested with the European GP2 V1.0b and works fine in VGA
  135. and SVGA. It should also work for the other language versions but I haven't
  136. tried these yet.
  137.  
  138. This version of GP2JAM currently only supports the car JAM files. The
  139. cockpit view from a car will display the original game colour as this
  140. information seems to be encoded in the GP2.EXE file rather than the car JAM
  141. file.
  142. ---------------------------------------------------------------------------
  143. Car Sets
  144. Please *don't* send me the results of your painting, I'll get swamped with
  145. file E-mails otherwise! I won't be producing any car sets (I just write the
  146. converter, I never actually use it!), but I'm sure some good ones will
  147. quickly be available on the web.
  148.  
  149. Checkout Dave Gymer's web site and this will probably soon have some links
  150. on it:
  151.  
  152. http://www.gamesdomain.co.uk/dgymer/f1gp/
  153.  
  154. Note: The JAM files don't compress at all, so if possible when creating a
  155. car set include the BMP files as they do compress (I recommend you create a
  156. JAMS.ZIP and a BMP.ZIP then the downloader can choose which one to
  157. download, the BMP.ZIP will be much smaller than the JAMS.ZIP).
  158. ---------------------------------------------------------------------------
  159. Future Updates
  160. The next version of GP2JAM will support the driver's helmets. Subsequent
  161. versions may support the advertising boards and possibly other objects
  162. around the track. Keep an eye on my web page.
  163. ---------------------------------------------------------------------------
  164. History
  165.  
  166. V1.0 18th Aug 1996      Initial version.
  167.                         Only supports car JAM files.
  168. V1.1  3rd Sep 1996      Fixed memory overwrite bug which caused an "Unable to open
  169.                         file *.JAM" error message when converting from BMP -> JAM.
  170.  
  171. ---------------------------------------------------------------------------
  172. E-mail / Further Info
  173. Please send any suggestions, comments, or bug reports (include the version
  174. of GP2JAM you are using) to the author Trevor Kellaway at:
  175.  
  176. CompuServe:    [100331,2330]
  177. Internet:      100331.2330@compuserve.com
  178.  
  179. The current version of GP2JAM will always be available on my web page along
  180. with the current version of this help file.
  181.  
  182. http://ourworld.compuserve.com/homepages/tkellaway/
  183.  
  184. It should also be available on Compuserve in GO SPRTSIMS, Lib #14 (Racing
  185. Circuits) as GP2JAM.ZIP.
  186.  
  187. This program may be freely copied and distributed, as long as it is not
  188. modified in any way, no fee is charged and this file is always included.
  189. This program is provided "as is" with no warranties expressed or implied.
  190. The author will not be held responsible for any losses incurred, either
  191. directly or indirectly by the use of this program.
  192.  
  193. This is *not* an Microprose product. If you have problems with the game
  194. then try it without using this program.
  195.  
  196. The author has no connection with Geoff Crammond or Microprose.
  197. ---------------------------------------------------------------------------
  198. E-mail: Trevor Kellaway (100331.2330@compuserve.com)
  199.