|
jpayne@68
|
1 '\" t
|
|
jpayne@68
|
2 .\" Title: gifhisto
|
|
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 "GIFHISTO" "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 gifhisto \- make a color histogram from GIF colr frequencies
|
|
jpayne@68
|
32 .SH "SYNOPSIS"
|
|
jpayne@68
|
33 .HP \w'\fBgifhisto\fR\ 'u
|
|
jpayne@68
|
34 \fBgifhisto\fR [\-v] [\-t] [\-s\ \fIwidth\fR\ \fIheight\fR] [\-n\ \fIimage\-number\fR] [\-b] [\-h] [\fIgif\-file\fR]
|
|
jpayne@68
|
35 .SH "DESCRIPTION"
|
|
jpayne@68
|
36 .PP
|
|
jpayne@68
|
37 A program to create histogram of number of pixels using each color\&. The output can be formatted into a GIF histogram file, or as text file \- both go to stdout\&.
|
|
jpayne@68
|
38 .PP
|
|
jpayne@68
|
39 If no GIF file is given, gifhisto 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 \-t
|
|
jpayne@68
|
48 .RS 4
|
|
jpayne@68
|
49 Force output to be text file of the following form: (colormap size) lines each containing two integers: number of times color appeared, and color index\&. Lines are in increasing color index order\&. This output can be fed directly to a sort program if ordering by color frequency is desired\&.
|
|
jpayne@68
|
50 .sp
|
|
jpayne@68
|
51 The colormap picked is the one to be used for the image to generate histogram for, as defined in GIF format\&.
|
|
jpayne@68
|
52 .RE
|
|
jpayne@68
|
53 .PP
|
|
jpayne@68
|
54 \-s width height
|
|
jpayne@68
|
55 .RS 4
|
|
jpayne@68
|
56 Size of GIF histogram file\&. The height of the histogram should be power of 2 dividable by number of colors in colormap\&.
|
|
jpayne@68
|
57 .sp
|
|
jpayne@68
|
58 Width sets the resolution (accuracy if you like) of the histogram as the maximum histogram bar is scaled to fit it\&.
|
|
jpayne@68
|
59 .RE
|
|
jpayne@68
|
60 .PP
|
|
jpayne@68
|
61 \-n image\-number
|
|
jpayne@68
|
62 .RS 4
|
|
jpayne@68
|
63 Image number to test\&. Default is one\&.
|
|
jpayne@68
|
64 .RE
|
|
jpayne@68
|
65 .PP
|
|
jpayne@68
|
66 \-b
|
|
jpayne@68
|
67 .RS 4
|
|
jpayne@68
|
68 Zeros the background color count\&. As only linear scale bars are supported and usually the background appears much more often then other colors, deleting the background count will improve the scaling of other colors\&.
|
|
jpayne@68
|
69 .RE
|
|
jpayne@68
|
70 .PP
|
|
jpayne@68
|
71 \-h
|
|
jpayne@68
|
72 .RS 4
|
|
jpayne@68
|
73 Print one line of command line help, similar to Usage above\&.
|
|
jpayne@68
|
74 .RE
|
|
jpayne@68
|
75 .SH "AUTHOR"
|
|
jpayne@68
|
76 .PP
|
|
jpayne@68
|
77 Gershon Elber
|
