USAGE: mapcolors [-f file] [-s safecolor] [-m] [-a] [-d depth] [-t type] infile outfile
USAGE: mapcolors [-help]

-f .... file ............. Space delimited text file containing "from" and "to" colors;
.......................... Any valid IM color is allowed;
-s .... safecolor ........ Any color not used in the image; To be used as intermediary color;
.......................... Any valid IM color is allowed including none;
.......................... The default=none
-m ....................... Monitors the progess by printing a comment to the terminal for
.......................... every color processed.
-a ....................... Disables transparency for the output image; Values are on or off;
.......................... The default leaves it as determined by the input image and processing.
-d .... depth ............ Desired depth for output image, relevant to your IM Q level.
.......................... default is to leave it according to the input and processing.
-t .... type ............. Type forces the resulting image class to be either:
.......................... palette or palettematte. The default is the leave the image class
.......................... as determined by the input image and the processing.

PURPOSE: Maps or translates one set of colors in an image to another set of colors.

DESCRIPTION: MAPCOLORS maps (or translates or changes) one set of colors in an image to another set of colors. The color pairs must be provided in a text file as a "from" color separated by one or more space followed by a "to" color, one pair per row in the file.

ARGUMENTS:

-f file ... File containing space delimeted pairs of colors, one pair per row. The first color will be mapped or changed to the second color using a safecolor as intermediary. Any valid IM color is allowed such that it does not include the safecolor. See http://imagemagick.org/script/color.php

-s safecolor ... SAFECOLOR is the safe color to use as the intermediary in the mapping process. It must not a color that exists already in the input image. Any valid IM color is allowed. See http://imagemagick.org/script/color.php For mapping colors that do not include transparency, use the default=none, but do not use none for any "from" or "to" color in the file. If you want to change transparnent colors, then you need to find some other non-used color in the image for the safecolor.

-m ... Enables progress monitoring by printing each color change to the terminal as it is processed. Use this when you have a large number of colors to map, since process is rather slow depending upon image size and number of colors to change.

-a ... Disables transparency in the resulting image. Use only if you know there are no transparent colors left or created in the output image. The default is to leave the transparency as determined by the input image and the processing.

-d depth ... Depth is the depth of the resulting image. Allowed values depend on the IM Q level of your IM build. You may set the depth to the smalles value that will account for all the colors in your image. The default is to leave it as determined by the input image's depth and processing.

-t type ... TYPE controls the image class of the resulting image. The default is to leave the image class unchanged. Other choices are palette or palettematte. They will force the image class to be pseudoclass rather than directclass. For some image formats and processing this can lead to smaller file sizes, but in other cases it appears that leaving it unchanged results in smaller files sizes. You may have to play with this for your image format.

Note: This script probably will not work for versions of IM prior to 6.4.1.4 due to a bug in +opaque

CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk.