home *** CD-ROM | disk | FTP | other *** search
/ Qu-ake / Qu-ake.iso / qu_ke / utils / grafikto / 004 / GRAFIXER.TXT < prev   
Encoding:
Text File  |  1996-10-20  |  10.2 KB  |  278 lines
  1. QUAKE GRAFIXER V1.0, (c) 1996 by Jonas P. (joXonoX@berlin.snafu.de)
  2. 21. October 1996
  3.  
  4. WHAT IS THIS?
  5. -------------
  6.  
  7. Freeware!
  8.  
  9. This should be a new star in the sky of QUAKE tools! :)
  10. At least I would have jumped around in my room with happiness like crazy if
  11. I had found somethin' like this in the web before.
  12.  
  13. I've seen a lot of custom graphics where the choose of colors could be nicer.
  14. Especially when some pixels of a graphic are fullbright colors, it looks
  15. shitty in darker areas of the game (I find). Or skins have single pixels of
  16. the shirt and/or pants colors, then you see ugly dots with the color
  17. depending on the color the player chose in mutiplayer.
  18.  
  19. With this tool you can take bitmaps and convert/remap the colors to the
  20. QUAKE palette.
  21.  
  22. You can determine exactly which colors of the QUAKE palette are used in
  23. your pictures.
  24.  
  25. It will convert the colors to the closest equal colors of the (defined colors
  26. of the) QUAKE palette.
  27.  
  28. It's great to make new skins, textures and other quake graphics.
  29.  
  30. You also can adjust the brightness and switch/compare the view to the
  31. original picture while fooling around with the palette.
  32.  
  33. It's written for DOS but works also under WIN95 (see WIN95 section).
  34.  
  35. GARANTY:
  36. ---------
  37. This program is garanteed to work on my computer. I think it should work on
  38. any other machine too (as long it is at least some 486). But, like any other
  39. freeware progammer, I can NOT garantee anything. And I am not responsable for
  40. anything that happens when you start this cool tool on your machine.
  41. Enjoy anyway!
  42.  
  43.  
  44. CREDITS:
  45. --------
  46. Robert Seidel   XGRAF V1.01 for PowerBASIC 3.xx (256 color mode) 
  47. IDsoft          you know why
  48.  
  49.  
  50. LANGUAGE:
  51. ---------
  52. If enough people ask me for a german documentation I'll write one. :)
  53.  
  54.  
  55. HOW TO START:
  56. -------------
  57. Make a directory called GRAFIXER (e.g. C:\GRAFIXER). Copy/unzip the 2 files
  58. there (GRAFIXER.EXE and GRAFIXER.TXT). Now copy the BMP files you want to
  59. convert in that directory and run GRAFIXER.EXE (type 'GRAFIXER' and <ENTER>).
  60. GRAFIXER will detect all BMP files in that directory and tell you how many
  61. has been found. You can also give filenames to GRAFIXER via the command line
  62. (then it will NOT scan the directory for BMP's) like this:
  63.  
  64.   GRAFIXER PIC1.BMP PIC2.BMP
  65.  
  66. or with full path:
  67.  
  68.   GRAFIXER C:\BMP\QUAKE\PIC1.BMP C:\BMP\QUAKE\PIC2.BMP
  69.  
  70. You also can put GRAFIXER.EXE into your PATH (e.g. C:\DOS) or add your
  71. GRAFIXER directory to the PATH (AUTOEXEC.BAT) and use it from any directory.
  72.  
  73. Now you are prompted to type in a directory name. Type in up to 8 chars (just
  74. press ENTER to cancel). If the directory you typed in already exists then you
  75. got 4 options:
  76.  
  77.   N   - type in another name
  78.   D   - delete all files in that directory
  79.   A   - add new files to that directory (keep what's in there)
  80.   ESC - change of mind, cancel the programm, exit to wherever you came from
  81.  
  82. The directory will be created in the folder where you're currently in
  83. (the dir you started GRAFIXER in).
  84.  
  85.  
  86. EDIT SCREEN:
  87. ------------
  88. After that is done you will see the edit screen. There you will see the
  89. picture of your first BMP converted to the deafault color combination (all
  90. colors exept fullbright). At the bottom there is the QUAKE palette split up
  91. into 16 blocks. 4 blocks are special!
  92.  
  93.   One has a little "S". If it is used in the skin of the PLAYER.MDL it
  94.   changes to the SHIRT color which is set with "COLOR" in the console.
  95.   If it's used for textures or monsters etc. it will look like you see
  96.   it here.
  97.  
  98.   One has a little "P". If it is used in the skin of the PLAYER.MDL it
  99.   changes to the PANTS color which is set with "COLOR" in the console.
  100.   If it's used for textures or monsters etc. it will look like you see
  101.   it here.
  102.  
  103.   One has a little "F". These are fullbright colors used for fire and
  104.   flames, they always have the same brightness, even in the darkest vault
  105.   of the game.  (you still can change the brightness with GRAFIXER)
  106.  
  107.   In the rightmost block are miscellaneous fullbright colors. The red
  108.   shades for example are used for the little red light on the weappon
  109.   or the health packs or some switches etc. I will work on some code
  110.   to apply them easily to your bitmaps
  111.  
  112. The number in the upper right is the brightness.
  113.  
  114.  
  115. EDIT MODES:
  116. -----------
  117. There are two editing modes. You can toggle between them with the TAB-key.
  118.  
  119. 'normal' edit mode (default):
  120. You can move the 'block selector' with the left and right cursor keys. With
  121. space you can toggle the use of the color at the selector for your new
  122. bitmap. You'll see the changes instantly. You can move left and right and
  123. set the colors with SPACE like you desire until you like what you see. The
  124. colors that are used have a little white marker.
  125.  
  126. 'combination' edit mode:
  127. If you switch to this mode there will be only the color marked where the
  128. selector is located and the bitmap will be shown made of only this color.
  129. If you move left or right the color of the bitmap will switch to the color
  130. at the selector. Now you can again add (mark) colors with SPACE but the
  131. color at the selector will always be added to the marked ones. This is good
  132. if you wanna try different combinations of colors. Select one color and move
  133. left and right to see and optimize mixes of colors.
  134.  
  135. This is hard to explain for me, just try it out! If you don't understand
  136. it at all, mail me.
  137.  
  138. The selector is dark grey in 'normal' mode and light grey in
  139. 'combination' mode.
  140.  
  141. The settings of the first mode will be remembered (if you switch to the
  142. second mode and back). The second mode starts always with one color (the
  143. color at the selector).
  144.  
  145. With <DEL> you can delete all markers.
  146.  
  147. I've added some presets which you can access via F5-F9. See the KEYS section
  148. of this doc.
  149.  
  150.  
  151. BRIGHTNESS:
  152. -----------
  153. With cursor up and down you can adjust the brightness. The numbers at the
  154. top right of the screen show the brightness value (in %). Press '0' to reset
  155. the brightness back to zero.
  156.  
  157.  
  158. SAVE:
  159. -----
  160. Press 'S' to save a bitmap like you see it. You can save several versions of
  161. one bitmap. The names will be ascending like this:
  162.  
  163. original:
  164. PICTURE.BMP
  165.  
  166. quaked:
  167. PICTUR_0.BMP
  168. PICTUR_1.BMP
  169. PICTUR_2.BMP
  170.  
  171. (_0 to _9, then _A to _Z and then to hell :)
  172.  
  173. The pics will be saved into the directory you specified at the beginning.
  174.  
  175.  
  176. VIEW ORIGINAL BITMAP:
  177. --------------------
  178. Press 'O' to view the orginal (source) bitmap with it's orginal palette.
  179. The orginal palette will be shown at the bottom as well. Press any key to
  180. get back to edit mode.
  181.  
  182.  
  183. WINDOWS95:
  184. ----------
  185. If you use WINDOWS95 (maybe WIN3.x too) you can place a link to GRAFIXER.EXE
  186. on the desktop (or anywhere) and "drag and drop" files onto it (even multiple
  187. files). This is kinda comfortable, I find. (if you drag and drop to many
  188. files at once you'll get a windows error message, select less files then)
  189.  
  190. You might want to check the "close after exit" option (don't know the exact
  191. term in english win, mine is german) in the properties of the link. Also make
  192. sure the 'working path' (or whatever it's called) is set right (should be
  193. automatically when you drag it to drop the link). In my WIN95 the file
  194. access is a little slower than under DOS. Dunno why. I will try to fix this,
  195. meanwhile watch the asterisk (*) in the upper left corner of the screen.
  196.  
  197. The directory you define at the beginnig will be created in the same dir as
  198. GRAFIXER.EXE is in (actually in the 'working path' directory in the
  199. properties of the link).
  200.  
  201.  
  202. MISCELLANEOUS:
  203. --------------
  204. There will appear a little asterisk (*) in the upper left corner of the
  205. screen when work is in progress.
  206.  
  207. The more colors are marked the slower it gets (e.g. when changing
  208. brightness), but I think it's fine for what it does...
  209.  
  210. Right now the bitmaps must be 8 bit/256 colors and not bigger than 320x200.
  211. The program will tell you if they don't fit those restrictions though.
  212. Im still working on this, if anybody wanna try larger bitmaps use the
  213. -CRAZY option and tell me what the limit is right now :). The part that
  214. doesn't fit on the screen will be clipped away (at least:). But you'll
  215. probably get a error message.
  216.  
  217. I might create a little hompage in the web concerning GRAFIXER and other
  218. QUAKE related tools. Mail me for more infos.
  219.  
  220. For ideas, criticism, complains, reporting bugs, say hello, sending me
  221. cybercash, telling me where to get/sending me this cool thing GRAFIXER
  222. helped you creating email to joXonoX@berlin.snafu.de instantly!
  223.  
  224.  
  225. KEYS:
  226. -----
  227. F1         - Help
  228.  
  229. TAB        - toggle between 'normal' and 'combination' edit mode
  230.              settings of 'normal' mode will be remembered
  231. O          - view original bitmap (with original palette)
  232. S          - save edited bitmap (save up to 36 versions, from '_0' to '_Z')
  233. ENTER      - edit next bitmap (if there is more), else exit
  234. ESC        - exit (nothing will be saved automatically)
  235.  
  236.              [PALETTE]
  237. RightArrow - move palette selector to the right
  238. LeftArrow  - move palette selector to the left
  239. SPACE      - Include/exclude (select/deselect) color at palette selector
  240. DEL        - delete all markers
  241. F5         - preset: all colors exept fullbright colors (e.g. textures)
  242. F6         - preset: all colors exept fullbright, shirt and pants colors
  243.              (e.g. skins)
  244. F7         - preset: only shirt color
  245. F8         - preset: only pants color
  246. F9         - preset: only fire fullbright color
  247.  
  248.              [BRIGHTNESS]
  249. UpArrow    - increase brightness
  250. DownArrow  - decrease brightness
  251. 0 (zero)   - reset brightness to zero
  252.  
  253.  
  254.  
  255. Planed for following releases:
  256. ------------------------------
  257.  
  258. - everything faster :)
  259. - the feature you desire and I like
  260. - being able to choose specific single colors
  261.   from the miscellaneous fullbright colors
  262. - when started without BMP's in the command
  263.   line, all BMP's will be listet and
  264.   choosable in a menu
  265. - maybe support for other file formats (PCX)
  266. - specify the destination directory in the
  267.   command line
  268. - increase the maximum size for images
  269.   (still got some memory problems with this,
  270.   question of time)
  271. - make more messages to clarify what's going
  272.   on (like telling which edit mode is selected)
  273. - add a 'QUAKE Brightness' adjustment
  274.   (also for single colors)
  275. - add a full screen view
  276. - I'll make a true windows version as soon as
  277.   I'm able to
  278.