home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 365.lha / MapCol_v1.4 / MapCol.doc < prev    next >
Text File  |  1990-04-10  |  4KB  |  91 lines
  1. NAME
  2.     MapCol - Change workbench object colors
  3.  
  4.     MapCol 1.4 90/03/21 14:48:42
  5.  
  6. SYNOPSIS
  7.     MapCol <objectname> [<color0> <color1> <color2> <color3>]
  8.  
  9.  
  10. DESCRIPTION
  11.     Have you ever wanted to change the color of an icon and dreaded
  12.     going into an icon editor and redrawing every blasted pixel?  Well,
  13.     here's the quick fix.  This program, MapCol (short for MAP COLor),
  14.     will change every occurence of each color in an icon to a color you
  15.     specify.
  16.  
  17.     The Workbench screen has four colors, numbered 0 through 3.  Color
  18.     0 is the background color.  The default colors in WB 1.3 are:
  19.       0 = Blue, 1 = White, 2 = Black, 3 = Orange
  20.     For each color number, MapCol will ask what color number you would
  21.     like it changed to ("mapped to").
  22.  
  23.     MapCol is intended to be run from a Shell (or CLI).  There are two
  24.     ways to use MapCol.  Either type MapCol <name>, and MapCol will
  25.     ask you for each color mapping, or the color mappings may be
  26.     specified on the command line following <name>.
  27.  
  28. EXAMPLES
  29.     For instance, to change the colors of the Empty drawer from white
  30.     (color #1) with black (color #2) to orange (color #3) with white
  31.     (color #1), type
  32.  
  33.         MapCol Empty 0 3 1 2
  34.  
  35.     Or, to change the Workbench disk colors from a black disk with an
  36.     orange shutter to an orange disk with a black shutter, type
  37.  
  38.         MapCol Disk 0 1 3 2
  39.  
  40.     Note that the above examples assume that the Current Director is
  41.     set appropriately.
  42.  
  43. DIAGNOSTICS
  44.     MapCol: Cannot open the icon library
  45.         The file icon.library cannot be found in the LIBS: directory(s)
  46.  
  47.     MapCol: Cannot open workbench object <name>
  48.         The attempt to get workbench object <name> failed.  Check for
  49.         the existence of a file <name>.info.  Also check that the
  50.         current directory is set appropriately.
  51.  
  52.     MapCol does not understand this Disk Object version.
  53.         Either the Disk Object is bad, or Workbench is writing
  54.         different types of Disk Objects nowadays and MapCol doesn't
  55.         work with them.
  56.  
  57.     MapCol expects an integer for color <number>, but it found "<text>".
  58.         The <text> that MapCol found when trying to read the color
  59.         mapping for color <number> is not a valid decimal integral
  60.         number.
  61.  
  62.     MapCol: Image Depth is not 2 bitplanes!!
  63.         The icon image is not a four-color icon.  (i.e. it does not
  64.         have two bitplanes.)
  65.  
  66. AUTHOR
  67.     John A. Thywissen
  68.  
  69.     4205 Tuckerman Street               7 Stonegate
  70.     University Pk, MD  20782-2144       Houston, TX  77024-2703
  71.  
  72.     Amiga Certified Developer              bix: thywiss
  73.  
  74.  
  75. AVAILABILITY
  76.                   Copyright © 1990, John Adam Thywissen
  77.     This program may be freely distributed under certain conditions:
  78.     1.  This program  must be  distributed  in a  completely  UNMODIFIED
  79.         form.
  80.     2.  This  program  shall  not  be  sold.    However,  public  domain
  81.         librarians may charge a small fee for distribution not exceeding
  82.         the cost of duplication, materials, and handling.
  83.     3.  This  program  may  be  incorporated  into  another  program  or
  84.         package.    However,  the notice  of copyright  should  be  made
  85.         visible to the user of such program or package.  (Simply stating
  86.         "MapCol  ©1990,  John  A.  Thywissen"  in the  documentation  is
  87.         sufficient.)
  88.     4.  The source need not be distributed with the binary, however, this
  89.         availabilty  statement  must  always  accompany  the binary  and
  90.         source code.
  91.