'\" t

.\"     Title: gifbg

.\"    Author: [see the "Author" section]

.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

.\"      Date: 2 May 2012

.\"    Manual: GIFLIB Documentation

.\"    Source: GIFLIB

.\"  Language: English

.\"

.TH "GIFBG" "1" "2 May 2012" "GIFLIB" "GIFLIB Documentation"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

gifbg \- generate a test\-pattern GIF

.SH "SYNOPSIS"

.HP \w'\fBgifbg\fR\ 'u

\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]

.SH "DESCRIPTION"

.PP

A program to generate a single\-color test pattern GIF with gradually changing intensity in any of the basic 8 directions\&.

.PP

The gifbg program reads no input, and will dump the created GIF file to stdout\&.

.SH "OPTIONS"

.PP

\-v

.RS 4

Verbose mode (show progress)\&. Enables printout of running scan lines\&.

.RE

.PP

\-d dir

.RS 4

Select direction the intensity of the background should increase\&. Direction can be one of the 8 principal directions:

.PP

"T"

.RS 4

for Top

.RE

.PP

"TR"

.RS 4

for Top Right

.RE

.PP

"R"

.RS 4

for Right

.RE

.PP

"BR"

.RS 4

for Bottom Right

.RE

.PP

"B"

.RS 4

for Bottom

.RE

.PP

"BL"

.RS 4

for Bottom Left

.RE

.PP

"L"

.RS 4

for left

.RE

.PP

"TL"

.RS 4

for Top Left

.RE

.sp

The compass directions may be use as synonyms for the above directions, so for example "NE" is equal to "TR"\&.

.sp

Direction is case insensitive\&. The default direction is Top (North)\&.

.RE

.PP

\-l lvls

.RS 4

Numeric, nmber of levels the color will be scaled to\&. Default is 16\&.

.RE

.PP

\-c R G B

.RS 4

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)\&.

.RE

.PP

\-m min

.RS 4

Minimum intensity (in percent) to scale color\&. Default 10%

.RE

.PP

[\-M max

.RS 4

Maximum intensity (in percent) to scale color\&. Default 100%

.RE

.PP

\-s W H

.RS 4

Size of image to create\&. Default 640 by 350\&.

.RE

.PP

\-h

.RS 4

Print one line of command line help, similar to Usage above\&.

.RE

.PP

If min == max = 100 (%) and lvls == 2 then boolean mask image of specified size will be created \- all foreground\&.

.SH "AUTHOR"

.PP

Gershon Elber\&.