jpayne@68: '\" t
jpayne@68: .\"     Title: gifhisto
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 "GIFHISTO" "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: gifhisto \- make a color histogram from GIF colr frequencies
jpayne@68: .SH "SYNOPSIS"
jpayne@68: .HP \w'\fBgifhisto\fR\ 'u
jpayne@68: \fBgifhisto\fR [\-v] [\-t] [\-s\ \fIwidth\fR\ \fIheight\fR] [\-n\ \fIimage\-number\fR] [\-b] [\-h] [\fIgif\-file\fR]
jpayne@68: .SH "DESCRIPTION"
jpayne@68: .PP
jpayne@68: 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: .PP
jpayne@68: If no GIF file is given, gifhisto 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: \-t
jpayne@68: .RS 4
jpayne@68: 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: .sp
jpayne@68: The colormap picked is the one to be used for the image to generate histogram for, as defined in GIF format\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-s width height
jpayne@68: .RS 4
jpayne@68: Size of GIF histogram file\&. The height of the histogram should be power of 2 dividable by number of colors in colormap\&.
jpayne@68: .sp
jpayne@68: Width sets the resolution (accuracy if you like) of the histogram as the maximum histogram bar is scaled to fit it\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-n image\-number
jpayne@68: .RS 4
jpayne@68: Image number to test\&. Default is one\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-b
jpayne@68: .RS 4
jpayne@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: .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