jpayne@68: '\" t
jpayne@68: .\"     Title: gif2rgb
jpayne@68: .\"    Author: [see the "Author" section]
jpayne@68: .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
jpayne@68: .\"      Date: 2 May 2012
jpayne@68: .\"    Manual: GIFLIB Documentation
jpayne@68: .\"    Source: GIFLIB
jpayne@68: .\"  Language: English
jpayne@68: .\"
jpayne@68: .TH "GIF2RGB" "1" "2 May 2012" "GIFLIB" "GIFLIB Documentation"
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .\" * Define some portability stuff
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
jpayne@68: .\" http://bugs.debian.org/507673
jpayne@68: .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
jpayne@68: .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
jpayne@68: .ie \n(.g .ds Aq \(aq
jpayne@68: .el       .ds Aq '
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .\" * set default formatting
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .\" disable hyphenation
jpayne@68: .nh
jpayne@68: .\" disable justification (adjust text to left margin only)
jpayne@68: .ad l
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .\" * MAIN CONTENT STARTS HERE *
jpayne@68: .\" -----------------------------------------------------------------
jpayne@68: .SH "NAME"
jpayne@68: gif2rgb \- convert images saved as GIF to 24\-bit RGB triplets
jpayne@68: .SH "SYNOPSIS"
jpayne@68: .HP \w'\fBgif2rgb\fR\ 'u
jpayne@68: \fBgif2rgb\fR [\-v] [\-1] [\-c\ \fIcolors\fR] [\-s\ \fIwidth\fR\ \fIheight\fR] [\-o\ \fIoutfile\fR] [\-h] [\fIgif\-file\fR]
jpayne@68: .SH "OPTIONS"
jpayne@68: .PP
jpayne@68: \-v
jpayne@68: .RS 4
jpayne@68: Verbose mode (show progress)\&. Enables printout of running scan lines\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-1
jpayne@68: .RS 4
jpayne@68: Only one file in the format of RGBRGB\&.\&.\&. triplets (Each of R, G,B is a byte) is being read or written\&. This file size is 3 * Width * Height\&. If stdin is used for input or stdout for output, this option is implicitly applied\&. The default (if not `\-1\*(Aq) is 3 files with the names OutFileName\&.R, OutFileName\&.G, OutFileName\&.B, each of which is Width * Height bytes\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-c colors
jpayne@68: .RS 4
jpayne@68: Specifies number of colors to use in RGB\-to\-GIF conversions, in bits per pixels, so \*(Aq\-c 8\*(Aq actually specifies 256 colors (maximum and default)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-s width height
jpayne@68: .RS 4
jpayne@68: Sets RGB\-to\-GIF conversion mode and specifies the size of the image to read\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-o
jpayne@68: .RS 4
jpayne@68: specifies the name of the out file (see also `\-1\*(Aq above)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-h
jpayne@68: .RS 4
jpayne@68: Print one line of command line help, similar to Usage above\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: By default, convert a GIF input file to RGB triplets\&. If \-s is specified, convert RGB input to a GIF\&.
jpayne@68: .PP
jpayne@68: If no input file is given, gif2rgb will try to read data from stdin\&.
jpayne@68: .SH "BUGS"
jpayne@68: .PP
jpayne@68: Feeding this utility a GIF with an invalid colormap, or other kinds of malformations, index will produce invalid output and may core\-dump the tool\&. Don\*(Aqt do that\&.
jpayne@68: .SH "AUTHOR"
jpayne@68: .PP
jpayne@68: Gershon Elber\&.