jpayne@68: '\" t
jpayne@68: .\"     Title: gifbg
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 "GIFBG" "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: gifbg \- generate a test\-pattern GIF
jpayne@68: .SH "SYNOPSIS"
jpayne@68: .HP \w'\fBgifbg\fR\ 'u
jpayne@68: \fBgifbg\fR [\-v] [\-d\ \fIdir\fR] [\-l\ \fIlvls\fR] [\-c\ \fIR\fR\ \fIG\fR\ \fIB\fR] [\-m\ \fImin\fR] [\-o\ \fImax\fR] [\-s\ \fIw\fR\ \fIh\fR] [\-h]
jpayne@68: .SH "DESCRIPTION"
jpayne@68: .PP
jpayne@68: A program to generate a single\-color test pattern GIF with gradually changing intensity in any of the basic 8 directions\&.
jpayne@68: .PP
jpayne@68: The gifbg program reads no input, and will dump the created GIF file to stdout\&.
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: \-d dir
jpayne@68: .RS 4
jpayne@68: Select direction the intensity of the background should increase\&. Direction can be one of the 8 principal directions:
jpayne@68: .PP
jpayne@68: "T"
jpayne@68: .RS 4
jpayne@68: for Top
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "TR"
jpayne@68: .RS 4
jpayne@68: for Top Right
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "R"
jpayne@68: .RS 4
jpayne@68: for Right
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "BR"
jpayne@68: .RS 4
jpayne@68: for Bottom Right
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "B"
jpayne@68: .RS 4
jpayne@68: for Bottom
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "BL"
jpayne@68: .RS 4
jpayne@68: for Bottom Left
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "L"
jpayne@68: .RS 4
jpayne@68: for left
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: "TL"
jpayne@68: .RS 4
jpayne@68: for Top Left
jpayne@68: .RE
jpayne@68: .sp
jpayne@68: The compass directions may be use as synonyms for the above directions, so for example "NE" is equal to "TR"\&.
jpayne@68: .sp
jpayne@68: Direction is case insensitive\&. The default direction is Top (North)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-l lvls
jpayne@68: .RS 4
jpayne@68: Numeric, nmber of levels the color will be scaled to\&. Default is 16\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-c R G B
jpayne@68: .RS 4
jpayne@68: What to use as the primary background color to scale\&. This color is scaled between the minimum intensity (min) and maximum intensity (max) from one end of the screen to the other as defined by dir\&. See below (\-m & \-M) for min & max\&. Default is Blue (0, 0, 255)\&.
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-m min
jpayne@68: .RS 4
jpayne@68: Minimum intensity (in percent) to scale color\&. Default 10%
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: [\-M max
jpayne@68: .RS 4
jpayne@68: Maximum intensity (in percent) to scale color\&. Default 100%
jpayne@68: .RE
jpayne@68: .PP
jpayne@68: \-s W H
jpayne@68: .RS 4
jpayne@68: Size of image to create\&. Default 640 by 350\&.
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: .PP
jpayne@68: If min == max = 100 (%) and lvls == 2 then boolean mask image of specified size will be created \- all foreground\&.
jpayne@68: .SH "AUTHOR"
jpayne@68: .PP
jpayne@68: Gershon Elber\&.