home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD2.img / d4xx / d490 / recolor / recolor.doc < prev    next >
Text File  |  1991-05-11  |  2KB  |  72 lines
  1. TABLE OF CONTENTS
  2.  
  3. Recolor
  4. Recolor                                                               Recolor
  5.  
  6.    NAME
  7.     Recolor
  8.  
  9.    SYNOPSIS
  10.     Recolor - A icon recoloring tool
  11.  
  12.    FUNCTION
  13.     The tool is an icon recoloring tool that is fully configurable.
  14.     It can swap/shift the colors of the selected icons when its
  15.     menu item is selected.
  16.  
  17.     You can also drop the selected icons into the Recolor window.
  18.     This will also recolor the icons.
  19.  
  20.     To configure the recoloring process, you just add tooltypes to
  21.     the recolor icon.  The tool types express the color table
  22.     swaps that are to happen and the order in which they should happen.
  23.  
  24.     The default tooltype in the icon is set for swapping colors 1 & 2
  25.     as this is what most people would need.
  26.  
  27.     The TRUNCATE tooltype will tell RECOLOR to truncate the icon
  28.     to a depth.  Some older icon builders had made the icon image
  29.     depth field incorrect.  On deeper screens or while recoloring,
  30.     this can cause strange results.  By setting the TRUNCATE value
  31.     to the depth of the icon desired, Recolor will set the depth
  32.     and thus clean up the image.
  33.  
  34.     Example tool types:
  35.  
  36.         TRUNCATE=2        * Truncate to a depth of 2.
  37.  
  38.         SWAP=1:2        * This is the default b/w swap
  39.  
  40.         SWAP=1:3
  41.         SWAP=2:1        * This is a 1-3-2 swap/rotate
  42.  
  43.         SWAP=7:2        * This swaps colors 7 and 2
  44.  
  45.     Note:    That is the output color is more bit planes that the
  46.         initial icon, strange things may happen.
  47.  
  48.     Recolor can also take these parameters as command line arguments.
  49.     For example:
  50.  
  51.         Recolor            ; No arguments defaults to SWAP=1:2
  52.         Recolor swap=2:3        ; Swap 2 & 3
  53.         Recolor swap=1:3 swap=2:1    ; Swap 1 - 3 - 2
  54.         Recolor truncate=2        ; Truncate to 2 bit planes
  55.  
  56.    INPUTS
  57.     tooltype -- The swapping information
  58.     icons -- Selected icons when the menu item is selected
  59.              or the icons that are dropped on the window.
  60.  
  61.    RESULTS
  62.     An icon written to disk with the new color setup.
  63.  
  64.    SEE ALSO
  65.     None
  66.  
  67.    BUGS
  68.     Does not handle icons with image structures that have non-standard
  69.     plane-pick and plane-on/off values.  But then, neither does
  70.     icon.library... :-)
  71.  
  72.