|
jpayne@68
|
1 '\" t
|
|
jpayne@68
|
2 .\" Title: giftext
|
|
jpayne@68
|
3 .\" Author: [see the "Author" section]
|
|
jpayne@68
|
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
|
|
jpayne@68
|
5 .\" Date: 2 May 2012
|
|
jpayne@68
|
6 .\" Manual: GIFLIB Documentation
|
|
jpayne@68
|
7 .\" Source: GIFLIB
|
|
jpayne@68
|
8 .\" Language: English
|
|
jpayne@68
|
9 .\"
|
|
jpayne@68
|
10 .TH "GIFTEXT" "1" "2 May 2012" "GIFLIB" "GIFLIB Documentation"
|
|
jpayne@68
|
11 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
12 .\" * Define some portability stuff
|
|
jpayne@68
|
13 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
jpayne@68
|
15 .\" http://bugs.debian.org/507673
|
|
jpayne@68
|
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
jpayne@68
|
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
jpayne@68
|
18 .ie \n(.g .ds Aq \(aq
|
|
jpayne@68
|
19 .el .ds Aq '
|
|
jpayne@68
|
20 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
21 .\" * set default formatting
|
|
jpayne@68
|
22 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
23 .\" disable hyphenation
|
|
jpayne@68
|
24 .nh
|
|
jpayne@68
|
25 .\" disable justification (adjust text to left margin only)
|
|
jpayne@68
|
26 .ad l
|
|
jpayne@68
|
27 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
28 .\" * MAIN CONTENT STARTS HERE *
|
|
jpayne@68
|
29 .\" -----------------------------------------------------------------
|
|
jpayne@68
|
30 .SH "NAME"
|
|
jpayne@68
|
31 giftext \- dump GIF pixels and metadata as text
|
|
jpayne@68
|
32 .SH "SYNOPSIS"
|
|
jpayne@68
|
33 .HP \w'\fBgiftext\fR\ 'u
|
|
jpayne@68
|
34 \fBgiftext\fR [\-v] [\-c] [\-e] [\-z] [\-p] [\-r] [\-h] [\fIgif\-file\fR]
|
|
jpayne@68
|
35 .SH "DESCRIPTION"
|
|
jpayne@68
|
36 .PP
|
|
jpayne@68
|
37 A program to dump (text only) general information about GIF file\&.
|
|
jpayne@68
|
38 .PP
|
|
jpayne@68
|
39 If no GIF file is given, giftext will try to read a GIF file from stdin\&.
|
|
jpayne@68
|
40 .SH "OPTIONS"
|
|
jpayne@68
|
41 .PP
|
|
jpayne@68
|
42 \-v
|
|
jpayne@68
|
43 .RS 4
|
|
jpayne@68
|
44 Verbose mode (show progress)\&. Enables printout of running scan lines\&.
|
|
jpayne@68
|
45 .RE
|
|
jpayne@68
|
46 .PP
|
|
jpayne@68
|
47 \-c
|
|
jpayne@68
|
48 .RS 4
|
|
jpayne@68
|
49 Dumps the color maps\&.
|
|
jpayne@68
|
50 .RE
|
|
jpayne@68
|
51 .PP
|
|
jpayne@68
|
52 \-e
|
|
jpayne@68
|
53 .RS 4
|
|
jpayne@68
|
54 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
|
55 .RE
|
|
jpayne@68
|
56 .PP
|
|
jpayne@68
|
57 \-z
|
|
jpayne@68
|
58 .RS 4
|
|
jpayne@68
|
59 Dumps the LZ codes of the image\&. Dumps in hex \- 3 digits per code (as we are limited to 12 bits)\&.
|
|
jpayne@68
|
60 .RE
|
|
jpayne@68
|
61 .PP
|
|
jpayne@68
|
62 \-p
|
|
jpayne@68
|
63 .RS 4
|
|
jpayne@68
|
64 Dumps the pixels of the image\&. Dumps in hex \- 2 digit per pixel (<=byte)\&.
|
|
jpayne@68
|
65 .RE
|
|
jpayne@68
|
66 .PP
|
|
jpayne@68
|
67 \-r
|
|
jpayne@68
|
68 .RS 4
|
|
jpayne@68
|
69 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
|
70 .RE
|
|
jpayne@68
|
71 .PP
|
|
jpayne@68
|
72 \-h
|
|
jpayne@68
|
73 .RS 4
|
|
jpayne@68
|
74 Print one line of command line help, similar to Usage above\&.
|
|
jpayne@68
|
75 .RE
|
|
jpayne@68
|
76 .SH "AUTHOR"
|
|
jpayne@68
|
77 .PP
|
|
jpayne@68
|
78 Gershon Elber\&.
|
