1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE refentry PUBLIC
3   "-//OASIS//DTD DocBook XML V4.1.2//EN"
4   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []>
5<refentry id='gifcolor.1'>
6<refentryinfo><date>2 May 2012</date></refentryinfo>
7<refmeta>
8<refentrytitle>gifcolor</refentrytitle>
9<manvolnum>1</manvolnum>
10<refmiscinfo class="source">GIFLIB</refmiscinfo>
11<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo>
12</refmeta>
13<refnamediv id='name'>
14<refname>gifcolor</refname>
15<refpurpose>generate color test-pattern GIFs</refpurpose>
16</refnamediv>
17
18<refsynopsisdiv id='synopsis'>
19
20<cmdsynopsis>
21  <command>gifcolor</command>
22      <arg choice='opt'>-v</arg>
23      <arg choice='opt'>-b <replaceable>background</replaceable></arg>
24      <arg choice='opt'>-h</arg>
25      <arg choice='opt'><replaceable>colormap-file</replaceable></arg>
26</cmdsynopsis>
27</refsynopsisdiv>
28
29<refsect1><title>Description</title>
30
31<para>A program to generate color test patterns.  Feed it a color map file (as
32generated, say, by the -s option of gifclrmp) and it will generate a GIF
33containing lines of the form.</para>
34
35<programlisting>
36Color %-3d: [%-3d, %-3d, %-3d]:
37</programlisting>
38
39<para>where the first number is the zero-based color index, and the
40triple is the index's [Red, Green, Blue] value.  There will be one
41such line for each color.  Each line will be set in a simple 8x8 font
42in the color it describes; thus, any lines corresponding to the GIF's
43background color will be blank.</para>
44
45</refsect1>
46<refsect1><title>Options</title>
47
48<variablelist>
49<varlistentry>
50<term>-v</term>
51<listitem>
52<para>Verbose mode (show progress).
53Enables printout of running scan lines. </para>
54</listitem>
55</varlistentry>
56<varlistentry>
57<term>-b</term>
58<listitem>
59<para>Set the image's backround color to a given numeric index.</para>
60</listitem>
61</varlistentry>
62<varlistentry>
63<term>-h</term>
64<listitem>
65<para>Print one line of command line help, similar to Usage above.</para>
66</listitem>
67</varlistentry>
68</variablelist>
69
70<para>If no colormap file is specified, the color map will be read from stdin.</para>
71
72</refsect1>
73<refsect1><title>Author</title>
74
75<para>Gershon Elber.</para>
76
77</refsect1>
78</refentry>
79