jpayne@68
|
1 '\" t
|
jpayne@68
|
2 .\" Title: gifbg
|
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 "GIFBG" "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 gifbg \- generate a test\-pattern GIF
|
jpayne@68
|
32 .SH "SYNOPSIS"
|
jpayne@68
|
33 .HP \w'\fBgifbg\fR\ 'u
|
jpayne@68
|
34 \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
|
35 .SH "DESCRIPTION"
|
jpayne@68
|
36 .PP
|
jpayne@68
|
37 A program to generate a single\-color test pattern GIF with gradually changing intensity in any of the basic 8 directions\&.
|
jpayne@68
|
38 .PP
|
jpayne@68
|
39 The gifbg program reads no input, and will dump the created GIF file to stdout\&.
|
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 \-d dir
|
jpayne@68
|
48 .RS 4
|
jpayne@68
|
49 Select direction the intensity of the background should increase\&. Direction can be one of the 8 principal directions:
|
jpayne@68
|
50 .PP
|
jpayne@68
|
51 "T"
|
jpayne@68
|
52 .RS 4
|
jpayne@68
|
53 for Top
|
jpayne@68
|
54 .RE
|
jpayne@68
|
55 .PP
|
jpayne@68
|
56 "TR"
|
jpayne@68
|
57 .RS 4
|
jpayne@68
|
58 for Top Right
|
jpayne@68
|
59 .RE
|
jpayne@68
|
60 .PP
|
jpayne@68
|
61 "R"
|
jpayne@68
|
62 .RS 4
|
jpayne@68
|
63 for Right
|
jpayne@68
|
64 .RE
|
jpayne@68
|
65 .PP
|
jpayne@68
|
66 "BR"
|
jpayne@68
|
67 .RS 4
|
jpayne@68
|
68 for Bottom Right
|
jpayne@68
|
69 .RE
|
jpayne@68
|
70 .PP
|
jpayne@68
|
71 "B"
|
jpayne@68
|
72 .RS 4
|
jpayne@68
|
73 for Bottom
|
jpayne@68
|
74 .RE
|
jpayne@68
|
75 .PP
|
jpayne@68
|
76 "BL"
|
jpayne@68
|
77 .RS 4
|
jpayne@68
|
78 for Bottom Left
|
jpayne@68
|
79 .RE
|
jpayne@68
|
80 .PP
|
jpayne@68
|
81 "L"
|
jpayne@68
|
82 .RS 4
|
jpayne@68
|
83 for left
|
jpayne@68
|
84 .RE
|
jpayne@68
|
85 .PP
|
jpayne@68
|
86 "TL"
|
jpayne@68
|
87 .RS 4
|
jpayne@68
|
88 for Top Left
|
jpayne@68
|
89 .RE
|
jpayne@68
|
90 .sp
|
jpayne@68
|
91 The compass directions may be use as synonyms for the above directions, so for example "NE" is equal to "TR"\&.
|
jpayne@68
|
92 .sp
|
jpayne@68
|
93 Direction is case insensitive\&. The default direction is Top (North)\&.
|
jpayne@68
|
94 .RE
|
jpayne@68
|
95 .PP
|
jpayne@68
|
96 \-l lvls
|
jpayne@68
|
97 .RS 4
|
jpayne@68
|
98 Numeric, nmber of levels the color will be scaled to\&. Default is 16\&.
|
jpayne@68
|
99 .RE
|
jpayne@68
|
100 .PP
|
jpayne@68
|
101 \-c R G B
|
jpayne@68
|
102 .RS 4
|
jpayne@68
|
103 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
|
104 .RE
|
jpayne@68
|
105 .PP
|
jpayne@68
|
106 \-m min
|
jpayne@68
|
107 .RS 4
|
jpayne@68
|
108 Minimum intensity (in percent) to scale color\&. Default 10%
|
jpayne@68
|
109 .RE
|
jpayne@68
|
110 .PP
|
jpayne@68
|
111 [\-M max
|
jpayne@68
|
112 .RS 4
|
jpayne@68
|
113 Maximum intensity (in percent) to scale color\&. Default 100%
|
jpayne@68
|
114 .RE
|
jpayne@68
|
115 .PP
|
jpayne@68
|
116 \-s W H
|
jpayne@68
|
117 .RS 4
|
jpayne@68
|
118 Size of image to create\&. Default 640 by 350\&.
|
jpayne@68
|
119 .RE
|
jpayne@68
|
120 .PP
|
jpayne@68
|
121 \-h
|
jpayne@68
|
122 .RS 4
|
jpayne@68
|
123 Print one line of command line help, similar to Usage above\&.
|
jpayne@68
|
124 .RE
|
jpayne@68
|
125 .PP
|
jpayne@68
|
126 If min == max = 100 (%) and lvls == 2 then boolean mask image of specified size will be created \- all foreground\&.
|
jpayne@68
|
127 .SH "AUTHOR"
|
jpayne@68
|
128 .PP
|
jpayne@68
|
129 Gershon Elber\&.
|