xref: /aosp_15_r20/external/giflib/doc/gifclrmp.xml (revision 324bb76b8d05e2a05aa88511fff61cf3f9ca5892)
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='gifclrmp.1'>
6<refentryinfo><date>2 May 2012</date></refentryinfo>
7<refmeta>
8<refentrytitle>gifclrmp</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>gifclrmp</refname>
15<refpurpose>extract colormaps from GIF images</refpurpose>
16</refnamediv>
17
18<refsynopsisdiv id='synopsis'>
19
20<cmdsynopsis>
21  <command>gifclrmp</command>
22      <arg choice='opt'>-v</arg>
23      <arg choice='opt'>-s</arg>
24      <arg choice='opt'>-l <replaceable>mapfile</replaceable></arg>
25      <arg choice='opt'>-t <replaceable>trans</replaceable></arg>
26      <arg choice='opt'>-g <replaceable>gamma</replaceable></arg>
27      <arg choice='opt'>-i <replaceable>image</replaceable></arg>
28      <arg choice='opt'>-h</arg>
29      <arg choice='opt'><replaceable>gif-file</replaceable></arg>
30</cmdsynopsis>
31</refsynopsisdiv>
32
33<refsect1><title>Description</title>
34
35<para>A program to modify GIF image colormaps.  Any local colormap in
36a GIF file can be modified at a time, or the global screen one.</para>
37
38</refsect1>
39<refsect1><title>Options</title>
40
41<variablelist>
42<varlistentry>
43<term>-v</term>
44<listitem>
45<para> Verbose mode (show progress).
46Enables printout of running scan lines. </para>
47</listitem>
48</varlistentry>
49<varlistentry>
50<term>-s</term>
51<listitem>
52<para>Select the global screen color map.</para>
53</listitem>
54</varlistentry>
55<varlistentry>
56<term>-l mapfile</term>
57<listitem>
58<para> Load color map from this file instead of selected color
59map.</para>
60</listitem>
61</varlistentry>
62<varlistentry>
63<term>-t trans</term>
64<listitem>
65<para>Change color index values.  The change is made to both the
66selected color table and the raster bits of the selected image.  A
67translation file is a list of pairs of `before' and `after' index
68values. At present, the `before' index values must be in ascending
69order starting from 0.</para>
70</listitem>
71</varlistentry>
72<varlistentry>
73<term>-g gamma</term>
74<listitem>
75<para>Apply gamma correction to selected color map.</para>
76</listitem>
77</varlistentry>
78<varlistentry>
79<term>-i image</term>
80<listitem>
81<para>Select the color map of the numbered image.</para>
82</listitem>
83</varlistentry>
84<varlistentry>
85<term>-h</term>
86<listitem>
87<para>Print one command line help, similar to Usage above.</para>
88</listitem>
89</varlistentry>
90</variablelist>
91
92<para>If no GIF file is given, gifclip will try to read a GIF file
93from stdin.</para>
94
95</refsect1>
96<refsect1><title>Notes</title>
97
98<itemizedlist>
99<listitem>
100<para>The default operation is to dump out the selected color map in text
101format.</para>
102</listitem>
103<listitem>
104<para>The file to load/dump is simply one color map entry per line.  Each such
105entry line has four integers: "ColorIndex Red Green Blue", where color
106index is in ascending order starting from 1.</para>
107</listitem>
108</itemizedlist>
109
110</refsect1>
111<refsect1><title>Author</title>
112
113<para>Gershon Elber.</para>
114
115</refsect1>
116</refentry>
117