jpayne@68: '\" t
jpayne@68: .\"     Title: giftext
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 "GIFTEXT" "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: giftext \- dump GIF pixels and metadata as text
jpayne@68: .SH "SYNOPSIS"
jpayne@68: .HP \w'\fBgiftext\fR\ 'u
jpayne@68: \fBgiftext\fR [\-v] [\-c] [\-e] [\-z] [\-p] [\-r] [\-h] [\fIgif\-file\fR]
jpayne@68: .SH "DESCRIPTION"
jpayne@68: .PP
jpayne@68: A program to dump (text only) general information about GIF file\&.
jpayne@68: .PP
jpayne@68: If no GIF file is given, giftext will try to read a GIF file from stdin\&.
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: \-c
jpayne@68: .RS 4
jpayne@68: Dumps the color maps\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-e
jpayne@68: .RS 4
jpayne@68: Dumps encoded bytes \- the pixels after compressed using LZ algorithm and chained to form bytes\&. This is the form the data is saved in the GIF file\&. Dumps in hex \- 2 digit per byte\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-z
jpayne@68: .RS 4
jpayne@68: Dumps the LZ codes of the image\&. Dumps in hex \- 3 digits per code (as we are limited to 12 bits)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-p
jpayne@68: .RS 4
jpayne@68: Dumps the pixels of the image\&. Dumps in hex \- 2 digit per pixel (<=byte)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-r
jpayne@68: .RS 4
jpayne@68: Dumps raw pixels as one byte per pixel\&. This option inhibits all other options and only the pixels are dumped\&. This option may be used to convert GIF files into raw data\&. Note: the color map can be extracted by gifclrmp utility\&. If more than one image is included in the file, all images will be dumped in order\&.
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: .SH "AUTHOR"
jpayne@68: .PP
jpayne@68: Gershon Elber\&.