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='gif2rgb.1'>
6<refentryinfo><date>2 May 2012</date></refentryinfo>
7<refmeta>
8<refentrytitle>gif2rgb</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>gif2rgb</refname>
15<refpurpose>convert images saved as GIF to 24-bit RGB triplets</refpurpose>
16</refnamediv>
17
18<refsynopsisdiv id='synopsis'>
19
20<cmdsynopsis>
21  <command>gif2rgb</command>
22      <arg choice='opt'>-v</arg>
23      <arg choice='opt'>-1</arg>
24      <arg choice='opt'>-c <replaceable>colors</replaceable></arg>
25      <arg choice='opt'>-s
26      		<replaceable>width</replaceable>
27      		<replaceable>height</replaceable></arg>
28      <arg choice='opt'>-o <replaceable>outfile</replaceable></arg>
29      <arg choice='opt'>-h</arg>
30      <arg choice='opt'><replaceable>gif-file</replaceable></arg>
31</cmdsynopsis>
32</refsynopsisdiv>
33
34<refsect1><title>Options</title>
35
36<variablelist>
37<varlistentry>
38<term>-v</term>
39<listitem>
40<para>Verbose mode (show progress).
41Enables printout of running scan lines.</para>
42</listitem>
43</varlistentry>
44<varlistentry>
45<term>-1</term>
46<listitem>
47<para>Only one file in the format of RGBRGB... triplets (Each of R,
48G,B is a byte) is being read or written.  This file size is 3 * Width
49* Height. If stdin is used for input or stdout for output, this option
50is implicitly applied. The default (if not `-1') is 3 files with the
51names OutFileName.R, OutFileName.G, OutFileName.B, each of which is
52Width * Height bytes.</para>
53</listitem>
54</varlistentry>
55<varlistentry>
56<term>-c colors </term>
57<listitem>
58<para> Specifies number of colors to use in RGB-to-GIF conversions, in
59bits per pixels, so '-c 8' actually specifies 256 colors (maximum and
60default).</para>
61</listitem>
62</varlistentry>
63<varlistentry>
64<term>-s width height</term>
65<listitem>
66<para> Sets RGB-to-GIF conversion mode and specifies the size of the image
67to read. </para>
68</listitem>
69</varlistentry>
70<varlistentry>
71<term>-o</term>
72<listitem>
73<para> specifies the name of the out file (see also `-1' above).</para>
74</listitem>
75</varlistentry>
76<varlistentry>
77<term>-h</term>
78<listitem>
79<para> Print one line of command line help, similar to Usage above.</para>
80</listitem>
81</varlistentry>
82</variablelist>
83
84<para>By default, convert a GIF input file to RGB triplets.  If -s is
85specified, convert RGB input to a GIF.</para>
86
87<para>If no input file is given, gif2rgb will try to read data
88from stdin.</para>
89
90</refsect1>
91<refsect1><title>Author</title>
92
93<para>Gershon Elber.</para>
94
95</refsect1>
96</refentry>
97