home *** CD-ROM | disk | FTP | other *** search
/ Chip Hitware 6 B / CHIP_HITWARE6_B.iso / gry / wkiss / tools / dovkiss.exe / dovutil.txt < prev    next >
Text File  |  1999-02-04  |  9KB  |  203 lines
  1. Dov's KiSS Utilities
  2.  
  3. This is a small collection of simple DOS utilities which I wrote and use
  4. for making KiSS sets. You may find them useful but they only work as DOS
  5. command-line programs.
  6.  
  7. Included are....
  8. GIF2CEL  - A GIF-to-CEL conversion utility
  9. CEL2GIF  - A CEL-to-GIF conversion utility
  10. CELMIN   - CEL offset minimizer
  11. CELOFF   - CEL offset incrementer
  12. KCFMERGE - Merge two KCFs to form a new KCF (for multi-palette sets)
  13.  
  14. More detailed descriptions of these utilities follow in this document.
  15.  
  16. Disclaimer: I have tried to test this program a great deal during the
  17. creation of my past KiSS dolls but there may still be problems I don't
  18. know about. Use these programs at your own risk. I disclaim any
  19. responsibility for any problems you may have as the result of using
  20. these programs. I've been using these for years now so I think they're
  21. pretty reliable though.
  22.  
  23. ---------------------------------------------------------
  24.  
  25. GIF2CEL
  26. A GIF-to-CEL conversion utility
  27. Copyright 1996 Dov Sherman
  28.  
  29. GIF2CEL is a very simple DOS command-line utility for the creation of
  30. KiSS .CEL files from .GIF images. To use this program, you should either
  31. place GIF2CEL.EXE in the same directory as your GIF and CEL images or
  32. somewhere in your PATH as defined by AUTOEXEC.BAT. If you don't know how
  33. to put something into your PATH, just put this file into your GIF and
  34. CEL directory; messing around with your PATH can really mess things up
  35. if you aren't familiar with the operation.
  36.  
  37. Syntax:
  38.  
  39. GIF2CEL <image.gif> [<palette.kcf>] [/t]
  40.  
  41. The first parameter is a GIF image. The CEL that is created will have
  42. the same name as the GIF image. For example, if you use a GIF named
  43. "hat.gif", you will get a CEL named "hat.cel".
  44.  
  45. GIF2CEL hat.gif                - hat.cel and hat.kcf created
  46.  
  47. The second parameter is a palette KCF filename. This is the KCF file
  48. which will be created based on the colors in your GIF file. This
  49. parameter is optional. If you don't supply a KCF filename, GIF2CEL will
  50. make a KCF file with the same name as the GIF file. In the previous
  51. example, you'd wind up with a KCF file named "hat.kcf". If your GIF file
  52. is 16 color, the KCF will have 16 colors. If you GIF is 256 color, the
  53. KCF will have 256 colors. If your GIF has some number of colors other
  54. than 16 or 256, it will make a messed up KCF file. I'd fix this but I
  55. lost all my source code in a hard drive crash. Just make sure your GIF
  56. is 16 or 256 color only. The KCF will always use 24-bit color.
  57.  
  58. GIF2CEL hat.gif basic.kcf      - hat.cel and basic.kcf created
  59.  
  60. The third parameter is the "Don't Trim" option. Put a "/t" at the end of
  61. the command to indicate that you don't want the CEL to be trimmed. When
  62. GIF2CEL looks at the GIF, if trims off all the extra empty space around
  63. the edges of the image, storing only the smallest rectangle of image
  64. that actually contains the image. However, if you use the "/t", it will
  65. make sure the CEL knows how much was trimmed from the upper-left and
  66. uses that as the offset for the CEL. This is useful when creating CELs
  67. for multi-level objects.
  68.  
  69. GIF2CEL hat.gif basic.kcf /t   - hat.cel and basic.kcf created
  70.                                  hat.cel not trimmed
  71.  
  72. ---------------------------------------------------------
  73.  
  74. CEL2GIF
  75. A CEL-to-GIF conversion utility
  76. Copyright 1999 Dov Sherman
  77.  
  78. CEL2GIF is a simple DOS command-line utility to create GIF images
  79. from CELs. This can be handy if you lose your source images and need
  80. to recreate them from the CELs you have.
  81.  
  82. Syntax:
  83. CEL2GIF <KiSS.cel> <palette.kcf>
  84.  
  85. This will create a GIF image with the same basename as the CEL. You MUST
  86. give the name of a KCF file so that CEL2GIF will know what colors to use
  87. in the GIF image. If the CEL has a non-zero offset, the new GIF will
  88. have some extra blank space in the upper-left to match the offset.
  89.  
  90. Example:
  91. CEL2GIF hat.cel basic.kcf      - hat.gif would be created using colors
  92.                                  from the first color group in basic.kcf
  93.  
  94. ---------------------------------------------------------
  95.  
  96. CELMIN
  97. CEL offset minimizer
  98. Copyright 1997 Dov Sherman
  99.  
  100. This DOS command-line utility is best used for working with a group of
  101. CELs which are all part of the same object. It's purpose is to minimize
  102. the offsets of all the cels while still keeping them in the correct
  103. relative positions to one another.
  104.  
  105. Syntax:
  106. CELMIN <KiSS.cel> [<KiSS.cel> <KiSS.cel> <KiSS.cel>...]
  107.  
  108. Here's an example: Suppose you are drawing a hat and this hat has three
  109. levels (the front of the brim HATFRONT.CEL, the bowl of the hat
  110. HATBOWL.CEL, and the back of the brim HATBACK.CEL). Suppose that, in
  111. your source images you drew this hat in the middle of a large empty
  112. space and then converted the images to CELs. If you use PCX2CEL or
  113. GIF2CEL or something similar with "trimming" turned off, the three parts
  114. would be in the correct relative positions but they would also have a
  115. really high offset value which keeps them from approaching the
  116. upper-left edge of the screen in KiSS. If you type:
  117.  
  118. CELMIN HATFRONT.CEL HATBOWL.CEL HATBACK.CEL
  119.  
  120. CELMIN would look at each of the files, compare their offsets, and then
  121. shrink those offsets to be as small as possible while still keeping each
  122. piece in the right relative position.
  123.  
  124. You can list as many CELs as the command-line will allow. You can also
  125. use wildcard filenames. Examples of valid commands:
  126.  
  127. CELMIN HATFRONT.CEL HATB*.CEL
  128. CELMIN HAT*.CEL
  129. CELMIN NOSE.CEL EYE*.CEL MOUTH.CEL EAR*.CEL
  130.  
  131. ---------------------------------------------------------
  132.  
  133. CELOFF
  134. CEL offset incrementer
  135. Copyright 1997 Dov Sherman
  136.  
  137. This DOS command-line utility is extremely simple in its function. It
  138. accepts a list of CELs and then increases the offset of each CEL by a
  139. set amount. This can be useful if you have a group of CELs which are all
  140. part of the same object and have the right offsets relative to each
  141. other but for which you want to increase the offsets uniformly. I use it
  142. when I want an object to stay away from the left side of the screen for
  143. some reason, but you may find other uses.
  144.  
  145. Syntax:
  146. CELOFF <X> <Y> <KiSS.cel> [<KiSS.cel> <KiSS.cel> <KiSS.cel>...]
  147.  
  148. X and Y are the horizontal and vertical increments. Valid examples might
  149. be:
  150.  
  151. CELOFF 10 100 HAT*.CEL        - takes all cels matching HAT*.CEL and
  152.                                 increases their offsets by 10 to the
  153.                                 right and 100 down
  154. CELOFF 50 0 NOSE.CEL EYE*.CEL - takes all cels matching NOSE.CEL and
  155.                                 EYE*.CEL increases their offsets by
  156.                                 50 down
  157.  
  158. You can list as many CELs as the command-line will allow. You can also
  159. use wildcard filenames. Examples of valid commands:
  160.  
  161. ---------------------------------------------------------
  162.  
  163. KCFMERGE
  164. Merge two KCFs to form a new KCF (for multi-palette sets)
  165. Copyright 1999 Dov Sherman
  166.  
  167. If you've seen some of the older KiSS sets which make use of the little
  168. multi-palette buttons and want to know how to do that in your dolls,
  169. this is the utility you need. (You can also do this with some of the
  170. other utilities but this one is good for DOS junkies and very simple.)
  171.  
  172. Here's the way it works. Suppose you're doing a KiSS set where you want
  173. the little palette buttons to change the haircolor. First you draw your
  174. source images with blonde hair. Then make the CELs and a KCF file called
  175. BLONDE.KCF. Now go back and change the palette in your source image so
  176. that the colors that were blonde are now brunette. (It's important to
  177. understand that you're changing the *palette*, not just selecting
  178. different colors from the existing palette.) Then make a KCF file called
  179. BRUNETTE.KCF. The new CEL will be identical to the old one but the new
  180. KCF will have different colors from the old one. Now you use this
  181. utility to combine BLONDE.KCF and BRUNETTE.KCF to create HAIR.KCF and
  182. use it in your KiSS set. Then, when someone clicks on different palettes
  183. in the set, the haircolor will change from blonde to brunette.
  184.  
  185. The new KCF file will have the first KCF colors first, followed by the
  186. second KCF colors.
  187.  
  188. Syntax:
  189. KCFMERGE <first KCF> <second KCF> <new KCF>
  190.  
  191. Example:
  192. KCFMERGE BLONDE.KCF BRUNETTE.KCF HAIR.KCF - Takes the colors from BLONDE.KCF
  193.                                             and BRUNETTE.KCF and makes a new
  194.                                             HAIR.KCF
  195. KCFMERGE HAIR.KCF RED.KCF HAIR.KCF        - Assuming HAIR.KCF is the one we
  196.                                             just made, it will add RED.KCF
  197.                                             colors to the end of HAIR.KCF so
  198.                                             that it contains blonde, brunette,
  199.                                             and red colors
  200.  
  201. ---------------------------------------------------------
  202.  
  203.