PaletteConverter

... anything more to say?

• Home
  • Impressum
  • Publications
• Software
  • PaletteTool
    • User Docs
    • PaletteConverter
  • "Mandalas"
  • st2gif
  • AnoPlib
  • BibPres
    • Ex.: Styling
    • Ex.: Philosophy
    • Ex.: Gutenberg
  • ALSOG
• Blog
  • Recent
  • Topics

PaletteConverter is a command line utility for the Microsoft Windows operating system for converting colour palettes (colour maps) between different formats.

Please note that a GUI-version of the application named PaletteTool exists. It includes this software as well.

PaletteConverter currently supports the following formats:

• GIMP palette (*.gpl)
• Adobe Photoshop palette (*.aco)
• Fractint palette (*.map)
• Microsoft palette (*.pal)
• A hexadecimal color list (*.hextxt)

Each of these formats can be used as input and the read palette can be written in one of these formats.

The following formats can be exported only, but not read:

• JavaScript list (*.js)
• CSS color list (*.css)
• HTML (as a table) (*.html)

Additionally, PaletteConverter can render palettes to .gif-files (see below).

PaletteConverter is a commercial product. The licence fee is €10 (approx. 10US$). The licence allows to install the application on any number of computers, provided only one person can use it. Installing PaletteConverter as a web service is not allowed.

The trial version (v1.4.0) for Windows may be used for evaluation only and is limited - well, let's say crippled - as following:

• Conversion does not start immediately. You have to confirm a message by typing 'yes', instead.
• Batch processing is disabled. As soon as you try to convert more than a single file, you'll be prompted that this version is not capable to do this.
• You may not generate .gif-images.
• It is not allowed to use it for commercial purposes.

Download PaletteConverter Shareware Version (version 1.4.0, zipped archive)

Download PaletteConverter Shareware Version (version 1.4.0, Microsoft installer)

Please note that there is another tool named PaletteTool, which includes the complete PaletteTool release as well.

You can obtain a licenced copy of PaletteConverter via PayPal. A window will open within which you can process your payment and download a licenced version afterwards. The current release (1.4.0) contains the uncrippled executable. We give a strong advice to save the file to a known folder.

Es erfolgt kein Ausweis der Umsatzsteuer aufgrund der Anwendung der Kleinunternehmerregelung gem. § 19 UStG.

A basic call looks like this:

paletteconverter.exe -i myOrigPalette.aco -o myNewPalette.gpl

This call lets PaletteConverter read the palette file defined by the option -i and write it into the file defined by the option -o. As both files have correct extensions, .aco and .gpl, respectively, PaletteConverter knows that the file to read is an Adobe Photoshop palette named "myOrigPalette.aco" and that the file to write should be a GIMP palette named "myNewPalette.gpl".

Rendering an image is done by a call like the following one:

paletteconverter.exe -i palette.map -o palette.gif

Here, the extension .gif forces PaletteConverter to write the palette as a .gif-image.

The file to read is given to PaletteConverter using the --input <PATH>[,<PATH>]* (or -i <PATH>[,<PATH>]* for short). As you may have noticed, more than one path can be given, separated using a ','. <PATH> may be either the name of a file itself, including wildcards, or the path to a folder. In the second case, you should additionally set the option --recurse to walk down the folder tree.

The output path is defined using the option --output <PATH> (or -o <PATH> for short). If only one file is converted, the option should contain the name of the file to generate. You may omit to define the output format, if this file's extension is known to PaletteConverter, see below.

If no output path is given, the name of the file(s) to generate is constructed by appending the output format's extension to the name of the converted input file without extension. Please note that the output format must be given in this case. If the output path is given and more than one file shall be converted, each output file name is constructed as:

OP := <INPUT_PATH><OUTPUT><TO_FORMAT_EXTENSION>

where:

• <OP> is the name of the generated file
• <INPUT_PATH> is the path to the file to convert, without the file's name
• <OUTPUT> is the value of the output option
• <TO_FORMAT_EXTENSION> is the the extension, as defined using --toformat <FORMAT>

PaletteConverter recognizes the file format of input and output files by extension. In the case your files have a different or none extension, you have to let PaletteConverter know the format of the files to read. This is done using the option --fromformat <FORMAT> (or -f <FORMAT> for short). The same counts for output files. If no known extension is given for the output file, you have to specify it using the --toformat <FORMAT> (or -t <FORMAT> for short) option.

The following table shows which extensions are assigned to which formats and the used format name:

PaletteConverter can generate some further representations, but they cannot be read as they are no original palette formats:

Additionally, PaletteConverter writes the following image formats, which are as well recognized by their extension:

If no further options are given, PaletteConverter writes all colours as single pixels into one line:

paletteconverter.exe -i palette.aco -o palette.gif

Result:

The parameter --columns <INTEGER> defines after how many columns, a new line shall be started. The height of a colour cell can be changed using --cell-height <INTEGER> (-h <INTEGER> for short). Its width can be accordingly changed using --cell-width <INTEGER> (-w <INTEGER> for short).

paletteconverter.exe -i palette.aco -o palette.gif -w 8 -h 8 --columns 16

Result:

Please note that only palettes of no more than 256 color entries can be used for image generation.

The defaults render .css-entries like this:

.pal_example_0 { background-color: #000000; }
.pal_example_1 { background-color: #900ae5; }
.pal_example_2 { background-color: #9309e3; }
.pal_example_3 { background-color: #9608e1; }
...

Where "example" is the name of the palette - either as set on the command line using the --name <NAME> option, as given in the read palette file, or as derived from the palette's file name. The parameter --css.attribute <NAME> sets the name of the attribute. The default is "background-color" as seen above. The parameter --css.name <FORMAT_STRING> is a format string template that describes how the names of the entries shall be encoded. E.g. if one wants to use .mypalette_<INDEX> as name for setting the font color, the following call could be used:

paletteconverter.exe -i palette.aco -o palette.css --css-name ".mypalette_%i" --css-attribute font-color

This would result in:

.mypalette_0 { font-color: #000000; }
.mypalette_1 { font-color: #900ae5; }
.mypalette_2 { font-color: #9309e3; }
.mypalette_3 { font-color: #9608e1; }
...

By default, JavaScript-palettes are rendered like:

var <NAME>=[ <HEX_LIST> ];

Where the <HEX_LIST> consists of entries that are divided by a colon (',') and are formatted as:

"#RRGGBB"

You may change how the name is rendered using --js.name <FORMAT_STRING>. Instead of writing every colour entry as a hex-string, one may as well force PaletteConverter to write RGB-triplets using --js.type triplet.

At some places, a FORMAT_STRING is used. The string may contain placeholders for current values, e.g. the color table entry's index. The following placeholders are supported:

• %f: the filename without extension
• %n: the name of the palette if given in the file, otherwise the file name (%f)
• %i: the index of the palette entry

You may find the obligatory --verbose (or -v) option which shows some more output. You can force PaletteConverter to write the files it processes using --print-files and if you do, you can define the prefix to use using --print-files.prefix <STRING> and the divider to use using --print-files.divider <STRING>. You can also print the set options using --print-set-options.

• 2012/08/18: Version 1.0 (.pal, .gpl, .aco, .map)
• 2015/02/14: Version 1.2 (.gif)
• 2016/03/22: Version 1.4 (.pal correction, .gif extension, .js, .css, .html)

The software is provided "AS IS". It did not hurt us, yet, and even worked as expected and there are even tests which prove it. Though we cannot guarantee it will work as you expect.