jpayne@68: '\" t
jpayne@68: .\"     Title: gifclrmp
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 "GIFCLRMP" "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: gifclrmp \- extract colormaps from GIF images
jpayne@68: .SH "SYNOPSIS"
jpayne@68: .HP \w'\fBgifclrmp\fR\ 'u
jpayne@68: \fBgifclrmp\fR [\-v] [\-s] [\-l\ \fImapfile\fR] [\-t\ \fItrans\fR] [\-g\ \fIgamma\fR] [\-i\ \fIimage\fR] [\-h] [\fIgif\-file\fR]
jpayne@68: .SH "DESCRIPTION"
jpayne@68: .PP
jpayne@68: A program to modify GIF image colormaps\&. Any local colormap in a GIF file can be modified at a time, or the global screen one\&.
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: \-s
jpayne@68: .RS 4
jpayne@68: Select the global screen color map\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-l mapfile
jpayne@68: .RS 4
jpayne@68: Load color map from this file instead of selected color map\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-t trans
jpayne@68: .RS 4
jpayne@68: Change color index values\&. The change is made to both the selected color table and the raster bits of the selected image\&. A translation file is a list of pairs of `before\*(Aq and `after\*(Aq index values\&. At present, the `before\*(Aq index values must be in ascending order starting from 0\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-g gamma
jpayne@68: .RS 4
jpayne@68: Apply gamma correction to selected color map\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-i image
jpayne@68: .RS 4
jpayne@68: Select the color map of the numbered image\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-h
jpayne@68: .RS 4
jpayne@68: Print one command line help, similar to Usage above\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: If no GIF file is given, gifclip will try to read a GIF file from stdin\&.
jpayne@68: .SH "NOTES"
jpayne@68: .sp
jpayne@68: .RS 4
jpayne@68: .ie n \{\
jpayne@68: \h'-04'\(bu\h'+03'\c
jpayne@68: .\}
jpayne@68: .el \{\
jpayne@68: .sp -1
jpayne@68: .IP \(bu 2.3
jpayne@68: .\}
jpayne@68: The default operation is to dump out the selected color map in text format\&.
jpayne@68: .RE
jpayne@68: .sp
jpayne@68: .RS 4
jpayne@68: .ie n \{\
jpayne@68: \h'-04'\(bu\h'+03'\c
jpayne@68: .\}
jpayne@68: .el \{\
jpayne@68: .sp -1
jpayne@68: .IP \(bu 2.3
jpayne@68: .\}
jpayne@68: The file to load/dump is simply one color map entry per line\&. Each such entry line has four integers: "ColorIndex Red Green Blue", where color index is in ascending order starting from 1\&.
jpayne@68: .RE
jpayne@68: .SH "AUTHOR"
jpayne@68: .PP
jpayne@68: Gershon Elber\&.