1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE refentry PUBLIC 3 "-//OASIS//DTD DocBook XML V4.1.2//EN" 4 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []> 5<refentry id='gifbg.1'> 6<refentryinfo><date>2 May 2012</date></refentryinfo> 7<refmeta> 8<refentrytitle>gifbg</refentrytitle> 9<manvolnum>1</manvolnum> 10<refmiscinfo class="source">GIFLIB</refmiscinfo> 11<refmiscinfo class="manual">GIFLIB Documentation</refmiscinfo> 12</refmeta> 13<refnamediv id='name'> 14<refname>gifbg</refname> 15<refpurpose>generate a test-pattern GIF</refpurpose> 16</refnamediv> 17 18<refsynopsisdiv id='synopsis'> 19 20<cmdsynopsis> 21 <command>gifbg</command> 22 <arg choice='opt'>-v</arg> 23 <arg choice='opt'>-d <replaceable>dir</replaceable></arg> 24 <arg choice='opt'>-l <replaceable>lvls</replaceable></arg> 25 <arg choice='opt'>-c 26 <replaceable>R</replaceable> 27 <replaceable>G</replaceable> 28 <replaceable>B</replaceable></arg> 29 <arg choice='opt'>-m <replaceable>min</replaceable></arg> 30 <arg choice='opt'>-o <replaceable>max</replaceable></arg> 31 <arg choice='opt'>-s 32 <replaceable>w</replaceable> 33 <replaceable>h</replaceable></arg> 34 <arg choice='opt'>-h</arg> 35</cmdsynopsis> 36</refsynopsisdiv> 37 38<refsect1><title>Description</title> 39 40<para>A program to generate a single-color test pattern GIF with 41gradually changing intensity in any of the basic 8 directions.</para> 42 43<para>The gifbg program reads no input, and will dump the created GIF file 44to stdout.</para> 45 46</refsect1> 47<refsect1><title>Options</title> 48 49<variablelist> 50<varlistentry> 51<term>-v</term> 52<listitem> 53<para> Verbose mode (show progress). 54Enables printout of running scan lines.</para> 55</listitem> 56</varlistentry> 57<varlistentry> 58<term>-d dir</term> 59<listitem> 60<para>Select direction the intensity of the background should 61increase. Direction can be one of the 8 principal directions:</para> 62<variablelist> 63<varlistentry> 64<term>"T"</term> 65<listitem><para>for Top</para></listitem></varlistentry> 66<varlistentry> 67<term>"TR"</term> 68<listitem><para>for Top Right</para></listitem></varlistentry> 69<varlistentry> 70<term>"R"</term> 71<listitem><para>for Right</para></listitem></varlistentry> 72<varlistentry> 73<term>"BR"</term> 74<listitem><para>for Bottom Right</para></listitem></varlistentry> 75<varlistentry> 76<term>"B"</term> 77<listitem><para>for Bottom</para></listitem></varlistentry> 78<varlistentry> 79<term>"BL"</term> 80<listitem><para>for Bottom Left</para></listitem></varlistentry> 81<varlistentry> 82<term>"L"</term> 83<listitem><para>for left</para></listitem></varlistentry> 84<varlistentry> 85<term>"TL"</term> 86<listitem><para>for Top Left</para></listitem></varlistentry> 87</variablelist> 88<para>The compass directions may be use as synonyms for the above directions, so 89for example "NE" is equal to "TR".</para> 90<para>Direction is case insensitive. The default direction is Top 91(North).</para> 92</listitem> 93</varlistentry> 94<varlistentry> 95<term> -l lvls</term> 96<listitem> 97<para> Numeric, nmber of levels the color will be scaled to. Default is 16.</para> 98</listitem> 99</varlistentry> 100<varlistentry> 101<term> -c R G B</term> 102<listitem> 103<para> What to use as the primary background color to scale. This 104color is scaled between the minimum intensity (min) and maximum 105intensity (max) from one end of the screen to the other as defined by 106dir. See below (-m & -M) for min & max. Default is Blue (0, 1070, 255).</para> 108</listitem> 109</varlistentry> 110<varlistentry> 111<term> -m min</term> 112<listitem> 113<para> Minimum intensity (in percent) to scale color. Default 10%</para> 114</listitem> 115</varlistentry> 116<varlistentry> 117<term> [-M max</term> 118<listitem> 119<para> Maximum intensity (in percent) to scale color. Default 100%</para> 120</listitem> 121</varlistentry> 122<varlistentry> 123<term> -s W H</term> 124<listitem> 125<para> Size of image to create. Default 640 by 350.</para> 126</listitem> 127</varlistentry> 128<varlistentry> 129<term> -h</term> 130<listitem> 131<para> Print one line of command line help, similar to Usage above.</para> 132</listitem> 133</varlistentry> 134</variablelist> 135 136<para>If min == max = 100 (%) and lvls == 2 then boolean mask image 137of specified size will be created - all foreground.</para> 138 139</refsect1> 140<refsect1><title>Author</title> 141 142<para>Gershon Elber.</para> 143 144</refsect1> 145</refentry> 146