home *** CD-ROM | disk | FTP | other *** search
/ Chip Hitware 6 B / CHIP_HITWARE6_B.iso / gry / wkiss / tools / ks_utils.lzh / README.TXT < prev   
Text File  |  1995-05-21  |  9KB  |  205 lines
  1. Release 3.0 of KissUtils. Including a translations of the original KISS
  2. notes (from the Venice FTP site... my Japanese is NOT that good).
  3. This version has basic /GS2 (General Specification) support and color
  4. remapping.
  5. NOTE this is a beta release of the auto palette detecting function and 256
  6. color processing.
  7.  
  8. CEL2PCX.EXE  Cel to PCX conversion utility version 3.0 (GS2 format)
  9. CELTOPCX.BAT Cel to PCX conversion utility batch file
  10. KISSFMT.DOC  Translation of original (old format) manual.
  11. PCX2CEL.EXE  PCX to Cel 16 color conversion utility version 2.20 (GS2 format)
  12. 8BIT2CEL.EXE PCX to Cel 256 color conversion utility version 1.0
  13. README.CNF   My notes on the old file format.
  14. README.TXT   This file.
  15. GS_SPEC.TXT  Specifications of the new /GS format
  16.  
  17. THESE FILES ARE PUBLIC DOMAIN. THEY MAY NOT BE SOLD.
  18.  
  19. Finding that I'm not the only person to write a paper doll program
  20. was amusing. I wrote PaperDoll, available as DOLL-205.ARJ, or the (much)
  21. older Paper-d5.arj around various places such as the venice FTP site or
  22. via anonymous ftp at ftp.netcom.com in /pub/mu/mughi/PaperDoll.
  23.  
  24. Here are a few IBM utilities I have written to let you make your own dolls
  25. for the KISS system.
  26.  
  27. They require a VGA card to run, and will convert any image up to
  28. 640 x 480 x 16 colors. For the 256 color functions to function, a VESA SVGA
  29. card supporting 800 x 600 x 256 is required.
  30.  
  31. These utils were written so I could produce KISS dolls myself. In both
  32. cases (original and GS2) I had the basic system running long before I managed
  33. to get a copy of the specifications. The interface (or lack there of) is
  34. satisfactory for the semi-batch point and click system I have set up with
  35. Norton Commander. If you don't like it, well.... tough.
  36.  
  37. Of course there are NO guarantees with these utilities. They are hacks,
  38. nice hacks, but hacks nonetheless.
  39.  
  40. Legend:
  41.  [] enclosed text is optional.
  42.  <> descriptive example only. Enter a real file name here.
  43.  
  44. CEL2PCX.EXE  V3.0
  45.  
  46. This routine converts KISS /GS1 and KISS /GS2 .cel files into PCX images.
  47.  
  48. It locates the correct palette (.kcf) file by searching the current directory
  49. for any .cnf files and then searching them for the cel name and associated
  50. .kcf file name. It also uses the correct saved palette as specified in the
  51. .cnf which is vital in some multi doll configurations.
  52. If the .kcf file is specified it will use saved palette 0 from the specified
  53. .kcf file. If no matching .kcf or .cnf file can be found it automatically
  54. reads the palette from the first .kcf color file it finds in the current
  55. directory. It uses saved palette 0.
  56. The 4 bits per pixel 12 bits per palette color format in both GS1 and GS2,
  57. and 8 bits per pixel 24 bits per palette color format are supported. Other
  58. Hybrids such as 8 bits per pixel 12 bits per palette color may cause problems
  59. as I have neither addressed or tested them.
  60.  
  61. A new option is also provided.
  62. /E exit in graphics mode. This stops the flashing in batch conversions.
  63.  
  64. About the color remap function. This moves colors to more suitable positions
  65. in the palette for paint programs.
  66. /R specifies the palette remap order. If <FILENAME.RMP> is not found,
  67. a new file will be created. If <FILENAME.RMP> is not specified, a remap
  68. file will be generated with the same name as the cel, and the extension .RMP.
  69. The automatically generated file uses the following remap order:
  70. Black to position 0
  71. Background/transparent color to position 1
  72. White to position 15 (or 255 in 256 color mode)
  73. other colors in order in remaining locations.
  74. Use this option to edit cels with programs such as NeoPaint.
  75.  
  76. Usage: CEL2PCX <FILENAME[.CEL]> [<FILENAME[.KCF]>] [/R][<FILENAME.RMP>] [/E]
  77.  
  78. It will produce <FILENAME.PCX>
  79.  
  80. WARNING. It will overwrite any existing pcx with the same name.
  81.  
  82. The batch file CELtoPCX.BAT will automatically convert all .cel files in the
  83. current directory into .pcx files.
  84.  
  85. The format for the .RMP remap file is as follows, if you wish to create one
  86. manually using an ASCII text editor.
  87. The file consists of sixteen lines of text, each containing a number.
  88. The lines represent the position in the palette.
  89. The number is the new color to put there. (ie the OLD palette position of that
  90. color)
  91. e.g.
  92.  
  93. 1   (Put color 1 in position 0)
  94. 0   (Put color 0 in position 1)
  95. 2   (Put color 2 in position 2)
  96. 3
  97. 4
  98. 5
  99. etc.
  100.  
  101. Note: there is only limited error checking on the .RMP file.
  102. This .RMP file should then be used for all successive pcx2cel/8bit2cel
  103. and cel2pcx conversions with the same set of artwork.
  104.  
  105. PCX2CEL.EXE  V2.20
  106.  
  107. This little util converts 16 color PCX images into the .cel format used by
  108. KISS. This version features the ability to write cels and palettes in one
  109. variant of the GS2 (General Specification) format.
  110. The GS2 variant chosen is 4 bits per pixel, with 10 palette groups.
  111.  
  112. Usage: PCX2CEL <FILENAME[.PCX]> [<PALNAME[.kcf]>] [/T] [/G] [/P<filename.pcx>]
  113. where <FILENAME[.PCX]> is the name of the image to convert to a cel and
  114. <PALNAME[.kcf]> is the name of the kcf file to be produced.
  115. In the GS1 (old format) mode, extra palettes will be added to an
  116. existing .KCF file.
  117. In GS2 mode, a .KCF file will be produced with 10 identical palettes taken
  118. from the 16 color file <FILENAME[.PCX]>.
  119.  
  120. Command line switches for PCX2CEL:
  121.  
  122. New with verion 2.2 :-
  123. A ten group kcf file can be created by supplying an additional 256 color pcx
  124. image containing the color data. This file is specified by the command line
  125. switch /P<FILENAME.PCX>
  126. Note: This palette file is remapped in the same manner as all other remap
  127. functions. (e.g. color pairs 0 & 1, 16 & 17, 32 & 33 etc will be swapped if the
  128. .rpm file specifies for colors 0 & 1 to be swapped.)
  129.  
  130. /T will prevent the automatic trimmer clipping from the left and top
  131. corner of the cel as needed by multi-layer cels. It will correctly use
  132. the offset ability of the GS2 format when running in that mode.
  133.  
  134. /G will produce cel and kcf files in GS2 format.
  135.  
  136. /R<FILENAME.RMP> will remap colors according to the remap file.
  137. This file must be either created by cel2pcx, or written manually according
  138. to the above.
  139.  
  140. eg.
  141. PCX2CEL mian.pcx mian.kcf /Rmian.rmp
  142.  
  143. The background/transparent color that PCX2CEL uses is color 0. This
  144. is the only color KISS will use as the transparent color. Some paint programs
  145. set this color to black. If you can, swap it to another position. Make sure
  146. that either your art work uses color 0 as the background color, or you use
  147. the remaping function (which allows any color to be used as the background).
  148.  
  149. If you are doing a two part cel (front & back) it is necessary for both cels
  150. to have the same relationship to the top left hand corner or they will be
  151. incorrectly overlaid. Place the art for the item of clothing etc as close
  152. to the top left corner of the two pcx images as possible while still
  153. maintaining the correct relationship between them.
  154. Convert them to cels using the /T command line switch to tell PCX2CEL not
  155. to trim anything from the top left corner. The bottom and right edges will
  156. still be trimmed automatically. In the case of GS2 files, the image will still
  157. be trimmed, but an offset will be specified in the header.
  158.  
  159. When working in the old format, the same .kcf file should be specified for
  160. multiple cels being converted to a single doll. If a different palette is
  161. found in one of the cels, it will be saved in a secondary position in the
  162. .kcf file. This way, by using several different palettes in your cels, you
  163. can have several palettes available from within the program.
  164.  
  165. An important note on colors. KISS uses 4 bits per color instead of the 6 bits
  166. used by usually used by VGA paint programs. This will lead to slight shifting
  167. of colors, and perhaps similar colors becoming identical.
  168.  
  169. See the readme.cnf file for the KISS 2.24 cnf file format. For earlier
  170. versions, including 2.18, you're on your own, though the basics are the same.
  171.  
  172. 8BIT2CEL.EXE  V1.0
  173.  
  174. This little util converts 256 color PCX images into the .cel format used by
  175. KISS. This version features the ability to write cels and palettes in one
  176. variant of the GS2 (General Specification) format.
  177. The GS2 variant chosen is 8 bits per pixel, with 1 palette group at 24 bits
  178. per color, though only the 6 most significant bits of each R, G & B are used
  179. because the 256 color IBM PCX format only uses these 6 bits.
  180. Unfortunately, the boundry clipping is not as fast as that of PCX2CEL.EXE.
  181.  
  182. Usage: 8BIT2CEL <FILENAME[.PCX]> [<PALNAME[.KCF]>] [/T] [/R<NAME[.RMP]>]
  183. where <FILENAME[.PCX]> is the name of the image to convert to a cel and
  184. <PALNAME[.KCF]> is the name of the kcf file to be produced.
  185.  
  186. Specifying /R with no remap file name will use the internal default of
  187. swapping color 0 and color 1.
  188.  
  189. The remainder of its behavior follows that of its ancestor, PCX2CEL.EXE above.
  190.  
  191. by Mian.   Mad artist, programmer and paper doll freak.
  192.  
  193. internet address:  ken.stone@blaze.bbs.net.au
  194.  
  195.   _____________________________________________________________________/
  196. /
  197.      _______     _     _______      "Mian"  ken.stone@blaze.bbs.net.au
  198.    /____ \\\\\ / o \ ///// ____\
  199.          \_\\\| ^+^ |///_/                   Member of #SAS#
  200.             // \ U / \\                Sasami Appreciation Society
  201.          _____/ | | \_____
  202.         m------ m m ------m  Ryoohki-chan
  203.   _____________________________________________________________________/
  204. /
  205.