Sophie

Sophie

distrib > Mandriva > 8.2 > i586 > media > contrib > by-pkgid > d2f2e08d88dbc61efc48707a3730ec61 > files > 24

xbanner-1.31-16mdk.i586.rpm

<HTML>
<HEAD>
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   <META NAME="GENERATOR" CONTENT="Mozilla/4.0b3C (X11; I; Linux 2.0.27 i586) [Netscape]">
   <TITLE>XBanner Resources Reference</TITLE>
</HEAD>
<BODY BGCOLOR="#93DB70">

<CENTER>
<H1>
The XBanner Resource Reference</H1></CENTER>

<CENTER>
<H3>
For XBanner v1.3</H3></CENTER>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;<!-- AS-TOC_BEGIN{ --></CENTER>

<CENTER>
<H1>
Table of Contents</H1></CENTER>

<CENTER><TABLE COLS=2 WIDTH="76%" rules="cols" >
<TR>
<TD><A HREF="#as-h4-68060">General Options</A>&nbsp;
</TD>

<TD><A HREF="#as-h4-68068">Miscellaneous Effect-Specific Resources</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68061">Information And Debugging Options</A>&nbsp;
</TD>

<TD><A HREF="#as-h4-68069">Other Effects Specific Options</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68062">Background Effects</A>&nbsp;
</TD>

<TD><A HREF="#as-h4-680610">Miscellaneous Resources</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68063">Underlining The Text</A>&nbsp;
</TD>

<TD><A HREF="#cmdline">Other Command Line Switches</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68064">Putting An Image On The Screen</A>&nbsp;
</TD>

<TD><A HREF="#prgclass">Program Class And Program Name Hints</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68065">The Glint Feature</A>&nbsp;
</TD>

<TD><A HREF="#outline_effects">Outline Effects - Detailed Information</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68066">Color Cycling Options</A>&nbsp;
</TD>

<TD><A HREF="#underline_effects">Underline Effects - Detailed Information</A>&nbsp;
</TD>
</TR>

<TR>
<TD><A HREF="#as-h4-68067">PlasmaCloud Effects</A>&nbsp;
</TD>

<TD><A HREF="#as-h4-680611">Explanations About Resource Types</A>&nbsp;
</TD>
</TR>
</TABLE></CENTER>
<CENTER></CENTER>
<CENTER>Click <A HREF="#Index">here</A> to see the index.&nbsp;<!-- AS-TOC_END} --></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68060"></A>General Options</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".label"></A><TT>.label</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Label</TT>
<BR><I>String</I>&nbsp;
</TD>

<TD VALIGN=TOP>The label is the text that XBanner draws on the root window.
It may be any text. All text is drawn on one line.&nbsp;
<BR>
<BR>You can use double-quotes (e.g. <TT>" "</TT>) for leading spaces.&nbsp;
<BR>
<BR>Also, you can use environment variables within the label. Use <TT>$VAR_NAME</TT>
or <TT>${VAR_NAME}</TT> to insert environment variable values into the
label. To get a single <TT>$</TT> sign, use <TT>$$</TT>.&nbsp;
<BR>
<BR>Command-line: <TT>-label</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".effect"></A><TT>.effect</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Effect</TT>
<BR><I>Keyword</I>&nbsp;
</TD>

<TD VALIGN=TOP>The graphics rendering to be done on the text of <TT>.label</TT>.
<BR>Command-line: <TT>-effect</TT>. This is a <A HREF="#keyword">keyword</A>
resource.&nbsp;
<BR>Valid values:&nbsp;

<DL>
<DT>
<A NAME="3D-Shadow"></A><TT>3D-Shadow</TT>&nbsp;</DT>

<DD>
Take <TT><A HREF="#Shadowed-Outline">Shadowed-Outline</A></TT>, and
use it for both the main text and its shadows. You can use <TT><A HREF="#.shadows">.shadows</A></TT>
to control the number of shadows. The outline for the "shadows" is chosen
by <TT><A HREF="#.shadowColor">.shadowColor</A></TT>.&nbsp;</DD>

<DT>
<A NAME="Backlight"></A><TT>Backlight</TT>&nbsp;</DT>

<DD>
The text is outlined with 1-pixel outlines, colored along a color-gradient.
Use <TT><A HREF="#.thickness">.thickness</A></TT> to select number of outlines,
and <TT><A HREF="#.backlightGrad">.backlightGrad</A></TT> for the gradient.&nbsp;</DD>

<DT>
<A NAME="Coin"></A><TT>Coin</TT>&nbsp;</DT>

<DD>
This is very much like <TT><A HREF="#StandOut">StandOut</A></TT> but
it has the first few pixels closest to the text with oposite colors, creating
a sort of a rim resembling the rim of a coin.&nbsp;</DD>

<DT>
<A NAME="Fade"></A><TT>Fade</TT>&nbsp;</DT>

<DD>
This effect is very much like the <TT><A HREF="#Thick">Thick</A></TT>
effect, only that here the pixels of the thickness of the text change along
a color-gradient. If you select the color gradient such that the furthest
color from the text is the same color as the background, it seems as if
the text fades into the background. Use <TT><A HREF="#.fadeGrad">.fadeGrad</A></TT>
to select the color gradient.&nbsp;</DD>

<DT>
<A NAME="FatText"></A><TT>FatText</TT>&nbsp;</DT>

<DD>
The outlines are like in <TT><A HREF="#Backlight">Backlight</A></TT>,
but go into the letters, causing them to look fat if the colors are properly
selected. Use <TT><A HREF="#.thickness">.thickness</A></TT> to select number
of "out"lines, and <TT><A HREF="#.fatTextGrad">.fatTextGrad</A></TT> for
the gradient.&nbsp;</DD>

<DT>
<A NAME="FgGrad"></A><TT>FgGrad</TT>&nbsp;</DT>

<DD>
This is like <TT><A HREF="#Shadow">Shadow</A></TT> but the pixels of
the text are colored along a color gradient from the top line of pixels
to the bottom. Use <TT><A HREF="#.fgGradGrad">.fgGradGrad</A></TT> to select
the color gradient for this effect.&nbsp;</DD>

<DT>
<A NAME="FgPlasma"></A><TT>FgPlasma</TT>&nbsp;</DT>

<DD>
The text is seen to be like a window into an area filled with a PlasmaCloud.
Use <TT><A HREF="#.fgPlasmaNCol">.fgPlasmaNCol</A></TT> to select number
of colors for the PlasmaCloud. The color gradient of the PlasmaCloud can
be selected with <TT><A HREF="#.fgPlasmaGrad">.fgPlasmaGrad</A></TT>, and
the graininess factor for the <TT>FgPlasma</TT> effect can be set with
<TT><A HREF="#.fgPlasmaGrain">.fgPlasmaGrain</A></TT>.&nbsp;</DD>

<DT>
<A NAME="FunnyOutline"></A><TT>FunnyOutline</TT>&nbsp;</DT>

<DD>
Like taking a marker and coloring the outermost line of the letters
from the inside. Only wide parts of the font keep their original color,
and the outcome is somewhat like an outline. Here the <TT><A HREF="#.hiColor">.hiColor</A></TT>
resource selects the outline color.&nbsp;</DD>

<DT>
<A NAME="None"></A><TT>None</TT>&nbsp;</DT>

<DD>
No effect. Text is drawn as it is.&nbsp;</DD>

<DT>
<A NAME="Outline"></A><TT>Outline</TT>&nbsp;</DT>

<DD>
Text appears with an outline. Use the <TT><A HREF="#.hiColor">.hiColor</A></TT>
resource to select the color of the outline.&nbsp;</DD>

<DT>
<A NAME="Popart"></A><TT>PopArt</TT>&nbsp;</DT>

<DD>
The text is surrounded by 1-pixel wide outlines with their colors alternating
between <TT><A HREF="#.hiColor">.hiColor</A></TT> and <TT><A HREF="#.shadowColor">.shadowColor</A></TT>.
The number of outlines is selected by the <TT><A HREF="#.thickness">.thickness</A></TT>
resource.&nbsp;</DD>

<DT>
<A NAME="Shadow"></A><TT>Shadow</TT>&nbsp;</DT>

<DD>
Simple shadow under the text. Use <TT><A HREF="#.shadowColor">.shadowColor</A></TT>.
Use <TT><A HREF="#.shadowXOffset">.shadowXOffset</A></TT> and <TT><A HREF="#.shadowYOffset">.shadowYOffset</A></TT>
to control location of the shadow under the text.&nbsp;</DD>

<DT>
<A NAME="Shadowed-Outline"></A><TT>Shadowed-Outline</TT>&nbsp;</DT>

<DD>
Combination of <TT><A HREF="#Shadow">Shadow</A></TT> and <TT><A HREF="#Outline">Outline</A></TT>.&nbsp;</DD>

<DT>
<A NAME="Shake"></A><TT>Shake</TT>&nbsp;</DT>

<DD>
Lines of pixels in the same color as the text are drawn at 3 pixels
and 6 pixels above the text giving it a sense of shaking. This can create
the infamous "NERVOUS? TENSE? TIRED?" sign.&nbsp;</DD>

<DT>
<A NAME="StandOut"></A><TT>StandOut</TT>&nbsp;</DT>

<DD>
The text seems to have a frame like that of Motif buttons, with shading
which makes it stand out of the surrounding background. The upper and left
sides are colored by <TT><A HREF="#.hiColor">.hiColor</A></TT> and the
bottom and right sides are colored by <TT><A HREF="#.shadowColor">.shadowColor</A></TT>.&nbsp;</DD>

<DT>
<A NAME="StandIn"></A><TT>StandIn</TT>&nbsp;</DT>

<DD>
This is like <TT><A HREF="#StandOut">StandOut</A></TT> but with the
colors inverted.&nbsp;</DD>

<DT>
<A NAME="StandOut2"></A><TT>StandOut2</TT>&nbsp;</DT>

<DD>
Same as <TT><A HREF="#StandOut">StandOut</A></TT> but the effect is
rendered into the letters, rather than outside. This is great for unspaced
text.&nbsp;</DD>

<DT>
<A NAME="StandIn2"></A><TT>StandIn2</TT>&nbsp;</DT>

<DD>
Same as <TT><A HREF="#StandIn">StandIn</A></TT> but the effect is rendered
into the letters, rather than outside. This is great for unspaced text.&nbsp;</DD>

<DT>
<A NAME="Thick"></A><TT>Thick</TT>&nbsp;</DT>

<DD>
Like <TT><A HREF="#Outline">Outline</A></TT> but instead of a shadow,
the letters have a visible thickness. Use <TT><A HREF="#.thickness">.thickness</A></TT>
to control thickness of letters in pixels.&nbsp;</DD>
</DL>
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".font"></A><TT>.font</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Font</TT>
<BR><I>String</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the font to be used for the text you chose with
<TT><A HREF="#.label">.label</A></TT>. Click <A HREF="fonttips.html">here</A>
for some hints on finding fonts.
<BR>Command-line: <TT>-font</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".placement"></A><TT>.placement</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Placement</TT>
<BR><I>Keyword</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource governs where the text will be placed on the
screen. You can choose any of the following:

<PRE>&nbsp;&nbsp; TopLeft&nbsp;&nbsp;&nbsp;&nbsp; TopCenter&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TopRight
&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Center

&nbsp;&nbsp; BottomLeft BottomCenter BottomRight</PRE>
As well as <TT>XY</TT> and <TT>CenteredOnY</TT>.
<BR>When using <TT>XY</TT>, use <TT><A HREF="#.x">.x</A></TT> and <TT><A HREF="#.y">.y</A></TT>
to choose the location of the text.
<BR>When using <TT>CenteredOnY</TT>, only <TT><A HREF="#.y">.y</A></TT> affects
the location, and the text is centered on that <TT>Y</TT> position.
<BR>You can use <TT><A HREF="#.showCalc">.showCalc</A></TT> to help you choose
where to place your text.
<BR>Command-line: <TT>-placement</TT>.&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68061"></A>Information And Debugging Options</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".showErrors"></A><TT>.showErrors</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ShowErrors</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>Display error and warning information by drawing it, black
text on white background on the root window. The line is placed in the
top left corner. This is a <A HREF="#boolean">boolean</A> resource.&nbsp;
<BR>Command-line: <TT>-showerr</TT> and <TT>-noshowerr</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".showCalc"></A><TT>.showCalc</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ShowCalc</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This prints out to standard error information about the
size and position of the text's bounding box. This may be useful in selecting
placement of a second line of text by running XBanner twice. This is a
<A HREF="#boolean">boolean</A> resource.&nbsp;
<BR>Command-line: <TT>-showcalc</TT> and <TT>-hidecalc</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".dumpRes"></A><TT>.dumpRes</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.DumpRes</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This <A HREF="#boolean">boolean</A> resource will tell XBanner
to write to a file the list of all resources it sees, after having merged
in all different sources, like the app-deafults file, the .Xdefaults, etc.&nbsp;
<BR>Command-line: <TT>-dumpres</TT> and <TT>-nodumpres</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".dumpResFile"></A><TT>.dumpResFile</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.DumpResFile</TT>
<BR><I>String</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the file name for the <TT><A HREF="#.dumpRes">.dumpRes</A></TT>
resource.&nbsp;
<BR>Command-line: <TT>-dumpresfile</TT>.&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68062"></A>Background Effects</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgStyle"></A><TT>.bgStyle</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgStyle</TT>
<BR><I>Keyword</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a <A HREF="#keyword">keyword</A> resource which
selects what type of background you want. Most of these background style
use the <TT><A HREF="#.bgGrad">.bgGrad</A></TT> and <TT><A HREF="#.bgGradRepeat">.bgGradRepeat</A></TT>
to select the color gradient, and <TT><A HREF="#.barSize">.barSize</A></TT>
to determine the number of colors in the gradient as a function of the
thickness of each element in the gradient.&nbsp;
<BR>Command-line: <TT>-bgstyle</TT>.&nbsp;
<BR>Valid values:&nbsp;

<DL>
<DT>
<A NAME="bgpix"></A><TT>BgPix</TT></DT>

<DD>
This tiles a pixmap (<TT>.XPM</TT> file) over the root window. Use
<TT><A HREF="#.bgPixFile">.bgPixFile</A></TT> to select the pixmap file.&nbsp;</DD>

<DT>
<A NAME="fan"></A><TT>Fan</TT></DT>

<DD>
This draws a nice fan, whose center is at the center of the bottom
pixel line of the screen.&nbsp;</DD>

<DT>
<A NAME="fill"></A><TT>Fill</TT></DT>

<DD>
This simply fills the background with a single color determined by
the <TT><A HREF="#.bgFillColor">.bgFillColor</A></TT> resource.&nbsp;</DD>

<DT>
<A NAME="leftdiag"></A><TT>LeftDiagonal</TT></DT>

<DD>
This fills the background with a color gradient going from the top-left
corner to the bottom right.&nbsp;</DD>

<DT>
<A NAME="leftright"></A><TT>LeftRight</TT></DT>

<DD>
Fills the screen with a color gradient going from the left side to
the right.&nbsp;</DD>

<DT>
<A NAME="leftsplit"></A><TT>LeftSplit</TT></DT>

<DD>
Like two small <TT><A HREF="#fan">Fan</A></TT> effects one centered
on the top-left corner and the other on the bottom-right corner of the
screen.&nbsp;</DD>

<DT>
<TT>None</TT></DT>

<DD>
No background rendering will be done.&nbsp;</DD>

<DT>
<A NAME="plasma"></A><TT>Plasma</TT></DT>

<DD>
This will fill the bacground with a PlasmaCloud. Use <TT><A HREF="#.plasmaNumColors">.plasmaNumColors</A></TT>
and <TT><A HREF="#.plasmaGraininess">.plasmaGraininess</A></TT> to select
number of color and the graininess factor for the PlasmaCloud.&nbsp;</DD>

<DT>
<TT>RightDiagonal</TT></DT>

<DD>
Same as <TT><A HREF="#leftdiag">LeftDiagonal</A></TT>, but the gradient
is going from the top-right corner to the bottom left.&nbsp;</DD>

<DT>
<TT>RightSplit</TT></DT>

<DD>
Same as <TT><A HREF="#leftsplit">LeftSplit</A></TT> but the little
fans are centered on the top-right corner and bottom-left corner.&nbsp;</DD>

<DT>
<TT>Ripples</TT></DT>

<DD>
Draws intersecting circles that (when color cycled) look like ripples
in a pond.&nbsp;</DD>

<DT>
<A NAME="topdown"></A><TT>TopDown</TT></DT>

<DD>
The color gradient goes from top to bottom.&nbsp;</DD>
</DL>
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgFillColor"></A><TT>.bgFillColor</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgFillColor</TT>
<BR><I>ColorSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the color used for the filling the background if
requested by the <TT><A HREF="#fill">Fill</A></TT> background style or
the <TT><A HREF="#.bgFill">.bgFill</A></TT> resource. This is a <A HREF="#color_res">color</A>
resource.&nbsp;
<BR>Command-line: <TT>-bg</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgGrad"></A><TT>.bgGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a <A HREF="#color_grad">color gradient</A> resoruce
which determines which colors are the anchor colors of the background rendering
effects.&nbsp;
<BR>Command-line: <TT>-bggrad</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgGradRepeat"></A><TT>.bgGradRepeat</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgGradRepeat</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a numerical resource which causes XBanner to use
a smaller number of colors for the background gradient, but use these colors
several times.&nbsp;
<BR>This resource must be a positive integer.&nbsp;
<BR>Command-line: <TT>-bggradrep</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".autoFillBg"></A><TT>.autoFillBg</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.AutoFillBg</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This will cause XBanner to do a background fill before any
of the background style (except <TT>None</TT> of course, <TT><A HREF="#fill">Fill</A></TT>
and <TT><A HREF="#bgpix">BgPix</A></TT>). This resource takes precedence
over <TT><A HREF="#.bgFill">.bgFill</A></TT>.&nbsp;
<BR>Command-line: <TT>-autofill</TT> and <TT>-noautofill</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgFill"></A><TT>.bgFill</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgFill</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource is just like <TT><A HREF="#.autoFillBg">.autoFillBg</A></TT>
but <U><FONT SIZE=+1>you</FONT></U> specifiy the color by <TT><A HREF="#.bgFillColor">.bgFillColor</A></TT>.&nbsp;
<BR>Command-line: <TT>-bgfill</TT> and <TT>-nobgfill</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".barSize"></A><TT>.barSize</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BarSize</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource governs the amount of colors allocated for
the background effects (not including <TT><A HREF="#bgpix">BgPix</A></TT>,
<TT><A HREF="#fill">Fill</A></TT>, <TT>None</TT> and <TT><A HREF="#plasma">Plasma</A></TT>).
For instance, the <TT><A HREF="#topdown">TopDown</A></TT> background style
is drawn by drawing a set of bars from top to bottom each in a different
color. <TT>.barSize</TT> selects the size of these bars in pixels. The
<TT><A HREF="#fan">Fan</A></TT> background style is drawn by drawing triangles
with one vertex at the center of the fan, and the distance between the
other two vertices, which are both on the side of the screen or on top,
is controlled by the <TT>.barSize</TT> resource.&nbsp;
<BR>Command-line: <TT>-barsize</TT> or <TT>-bs</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgPixFile"></A><TT>.bgPixFile</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgPixFile</TT>
<BR><I>String</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is simply the name of the <TT>.XPM</TT> file to be
used for the <TT><A HREF="#bgpix">BgPix</A></TT> background style.&nbsp;
<BR>Command-line: <TT>-bgpixfile</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".ripples"></A><TT>.ripples</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Ripples</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>Selects the number of circles to draw for the <TT>Ripples</TT>
background. Best values are 2 and 3.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".rippleColors"></A><TT>.rippleColors</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.RippleColors</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the number of colors to use for the <TT>Ripples</TT>
background.&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68063"></A>Underlining The Text</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".underlined"></A><TT>.underlined</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Underlined</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This <A HREF="#boolean">boolean</A> resource determines
if the text will be underlined.&nbsp;
<BR>Command-line: <TT>-underline</TT> or <TT>-ul</TT>, and <TT>-noul</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".underlineColor"></A><TT>.underlineColor</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.UnderlineColor</TT>
<BR><I>ColorSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_res">color</A> of the underline.
The word <U>FGC</U> is a special keyword that causes XBanner to use the
same color for the underline as for the text. This also causes the following
rendering effects to be rendered on the underline as well: <TT><A HREF="#Backlight">Backlight</A>,
<A HREF="#Coin">Coin</A>, <A HREF="#Fade">Fade</A>, <A HREF="#FatText">FatText</A>,
<A HREF="#FgGrad">FgGrad</A>, <A HREF="#FgPlasma">FgPlasma</A>, <A HREF="#FunnyOutline">FunnyOutline</A>,
<A HREF="#Popart">PopArt</A>, <A HREF="#Shadow">Shadow</A>, <A HREF="#Shadowed-Outline">Shadowed-Outline</A>,
<A HREF="#Shake">Shake</A>, <A HREF="#StandOut">StandOut</A>, <A HREF="#StandIn">StandIn</A>,
<A HREF="#StandOut2">StandOut2</A>, <A HREF="#StandIn2">StandIn2</A>, <A HREF="#Thick">Thick</A></TT>.&nbsp;
<BR>Command-line: <TT>-ulcolor</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".underlineThickness"></A><TT>.underlineThickness</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.UnderlineThickness</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This numerical value (which must be positive) determines
the number of pixels width of the underline.&nbsp;
<BR>Command-line: <TT>-ulthick</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68064"></A>Putting An Image On The Screen</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".doPixmap"></A><TT>.doPixmap</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.DoPixmap</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a <A HREF="#boolean">boolean</A> resource which
determines whether or not you want a pixmap file put on the screen. If
the pixmap file (<TT>.XPM</TT> file) uses the <TT>None</TT> color, XBanner
will honor it.&nbsp;
<BR>Command-line: <TT>-dopixmap</TT> and <TT>-nopixmap</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".pixFile"></A><TT>.pixFile</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.PixFile</TT>
<BR><I>String</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the name of the pixmap file (<TT>.XPM</TT>) to be
put on the screen. If this file name begins with a @ sign, then this is
the name of a pixmap-list file. The pixmap-list file contains a line for
each pixmap to display, and the location where to display it.
<BR>Example:
<BR>
<BR><TT>XBanner.pixFile: @/usr/local/etc/pix_names.lst</TT>
<BR>
<BR><B><I>File: <TT>/usr/local/etc/pix_names.lst</TT></I></B>&nbsp;

<PRE>/usr/local/lib/pixmaps/Linux_Penguin.xpm 0 600
/usr/lib/3D-Pixmaps/Sponsors.xpm 800 760</PRE>
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".pixmapX"></A><TT>.pixmapX</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.PixmapX</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>The <TT>X</TT> position of the pixmap on the screen.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".pixmapY"></A><TT>.pixmapY</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.PixmapY</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>The <TT>Y</TT> position of the pixmap on the screen.&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68065"></A>The <U>Glint</U> Feature</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glint"></A><TT>.glint</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Glint</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>A <A HREF="#boolean">boolean</A> resource to turn the Glint
feature on or off. This implies <TT><A HREF="#.linger">.linger: True</A></TT>.&nbsp;
<BR>Command-line: <TT>-glint</TT> and <TT>-noglint</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glintSpeed"></A><TT>.glintSpeed</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.GlintSpeed</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This numerical resource governs the speed of each glinting
star appearing on your text. There are 3 different groups of values:&nbsp;

<UL>
<LI>
Positive values make for faster and faster glints, which use up less
CPU time and less network bandwidth.&nbsp;</LI>

<LI>
A value of zero (0) is the fastest, and is actually a "blink" of the
glint star. You can change this speed by editing <TT>xbanner.h</TT> and
changing the definition of <TT>BLINK_SPEED_TIME</TT>.&nbsp;</LI>

<LI>
Negative values mean slower and slower glints.&nbsp;</LI>
</UL>
Command-line: <TT>-glintspeed</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glintMin"></A><TT>.glintMin</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.GlintMin</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource is the smallest size of glint you would like
in pixels. The Glint feature makes glints whose size is randomly chosen
between this value and <TT>.glintMax</TT>.&nbsp;
<BR>Command-line: <TT>-gmin</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glintMax"></A><TT>.glintMax</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.GlintMax</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>See <TT><A HREF="#.glintMin">.glintMin</A></TT>.&nbsp;
<BR>Command-line: <TT>-gmax</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glintTimeMin"></A><TT>.glintTimeMin</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.GlintTimeMin</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the shortest amount of time between glints. XBanner
will wait a random time between glints, which is at least <TT>.glintTimeMin</TT>
milliseconds long, and not longer than <TT>.glintTimeMax</TT> ms.&nbsp;
<BR>Command-line: <TT>-gtimemin</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".glintTimeMax"></A><TT>.glintTimeMax</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.GlintTimeMax</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>See <TT><A HREF="#.glintTimeMin">.glintTimeMin</A></TT>&nbsp;
<BR>Command-line: <TT>-gtimemax</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".cornerMask"></A><TT>.cornerMask</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.CornerMask</TT>
<BR><I>Keyword-list</I>&nbsp;
</TD>

<TD VALIGN=TOP>The corner-mask is a comma separated list of keywords (see
below) that describes which corners you allow / forbid XBanner to glint
on. The default is all corners. Evaluation is done from left to right.&nbsp;
<BR>Keywords:&nbsp;

<DL>
<DT>
<TT>All</TT>&nbsp;</DT>

<DD>
All corners.&nbsp;</DD>

<DT>
<TT>DownLeft</TT>&nbsp;</DT>

<DD>
Add Down-Left corners.&nbsp;</DD>

<DT>
<TT>DownRight</TT>&nbsp;</DT>

<DD>
Add Down-Right corners.&nbsp;</DD>

<DT>
<TT>NoDownLeft</TT>&nbsp;</DT>

<DD>
Remove Down-Left corners from the mask.&nbsp;</DD>

<DT>
<TT>NoDownRight</TT>&nbsp;</DT>

<DD>
Remove Down-Right corners from the mask.&nbsp;</DD>

<DT>
<TT>NoUpLeft</TT>&nbsp;</DT>

<DD>
Remove Up-Left corners from the mask.&nbsp;</DD>

<DT>
<TT>NoUpRight</TT>&nbsp;</DT>

<DD>
Remove Up-Right corners from the mask.&nbsp;</DD>

<DT>
<TT>UpLeft</TT>&nbsp;</DT>

<DD>
Add Up-Left corners.&nbsp;</DD>

<DT>
<TT>UpRight</TT>&nbsp;</DT>

<DD>
Add Up-Right corners.&nbsp;</DD>
</DL>
Command-line: <TT>-cornermask</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68066"></A>Color Cycling Options</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".cycleColors"></A><TT>.cycleColors</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.CycleColors</TT>
<BR><I>Keyword-list</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a comma separated list of keywords, each signifying
a component you want to have color-cycling done on. This implies <TT><A HREF="#.linger">.linger:
True</A></TT>.&nbsp;
<BR>Command-line: <TT>-cycle</TT>&nbsp;
<BR>Valid keywords:&nbsp;

<DL>
<DT>
<TT>Backlight</TT>&nbsp;</DT>

<DD>
Cycle the colors of the <TT><A HREF="#Backlight">Backlight</A></TT>
effect.&nbsp;</DD>

<DT>
<TT>BG</TT>&nbsp;</DT>

<DD>
Cycle the colors of the background. This does not work for the <TT><A HREF="#bgpix">BgPix</A></TT>,
<TT><A HREF="#fill">Fill</A></TT> and <TT>None</TT> background styles.&nbsp;</DD>

<DT>
<TT>Fade</TT>&nbsp;</DT>

<DD>
Cycle the colors of the <TT><A HREF="#Fade">Fade</A></TT> effect.&nbsp;</DD>

<DT>
<TT>FatText</TT>&nbsp;</DT>

<DD>
Cycle the colors of the <TT><A HREF="#FatText">FatText</A></TT> effect.&nbsp;</DD>

<DT>
<TT>FG</TT>&nbsp;</DT>

<DD>
Continually change the color of the main text along a color gradient.
This can be done on any effect, but of course it will have no effect on
<TT><A HREF="#FgPlasma">FgPlasma</A></TT>, and, depending on <TT><A HREF="#.thickness">.thickness</A></TT>,
it might have no effect on <TT><A HREF="#FatText">FatText</A></TT>, <TT><A HREF="#StandOut2">StandOut2</A></TT>
and <TT><A HREF="#StandIn2">StandIn2</A></TT>. Use <TT><A HREF="#.fgCycleGrad">.fgCycleGrad</A></TT>
to select the color gradient.&nbsp;</DD>

<DT>
<TT>FgGrad</TT>&nbsp;</DT>

<DD>
Cycle the colors of the <TT><A HREF="#FgGrad">FgGrad</A></TT> effect's
color gradient.&nbsp;</DD>

<DT>
<TT>FgPlasma</TT>&nbsp;</DT>

<DD>
Cycle the colors of the <TT><A HREF="#FgPlasma">FgPlasma</A></TT> effect.&nbsp;</DD>

<DT>
<TT>None</TT>&nbsp;</DT>

<DD>
No color-cycling.&nbsp;</DD>

<DT>
<B>Important limitation:</B> Color Cycling can be used only in PseudoColor
displays (8-bit). This is a hardware-induced limitation.</DT>
</DL>
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".reverseCycle"></A><TT>.reverseCycle</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ReverseCycle</TT>
<BR><I>Keyword-list</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a comma-separated list of keywords telling which
cycling components should be cycled in reverse direction. for a list of
the keywords see <A HREF="#.cycleColors">.cycleColors</A>.&nbsp;
<BR>Command-line: <TT>-cycrev</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".forwardCycle"></A><TT>.forwardCycle</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ForwardCycle</TT>
<BR><I>Keyword-list</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a comma-separated list of keywords telling which
cycling components should be cycled in forward direction. for a list of
the keywords see <A HREF="#.cycleColors">.cycleColors</A>.&nbsp;
<BR>Command-line: <TT>-cycfor</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".cycleSpeed"></A><TT>.cycleSpeed</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.CycleSpeed</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This numerical resource selects the speed for the color
cycling. This is currently uniform for all cycling components. This value
is actually a divisor to the value passed to the <TT>usleep()</TT> function,
hence it is not linear but suffers greatly from the overhead of the rest
of the operations done around it. Be warned that faster color-cycling means
much larger CPU time consumption! This value must be positive.&nbsp;
<BR>Command-line: <TT>-cycspeed</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".bgGradSteps"></A><TT>.bgGradSteps</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BgGradSteps</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>When this is set to non-zero, the color cycling of the background
will change its cycling direction every number of steps equal to the value
of this resource.&nbsp;
<BR>Command-line: <TT>-bgsteps</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".effectSteps"></A><TT>.bgGradSteps</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.EffectSteps</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>When this is set to non-zero, the color cycling of the foreground
rendering effect will change its cycling direction every number of steps
equal to the value of this resource.&nbsp;
<BR>Command-line: <TT>-effectsteps</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68067"></A>PlasmaCloud Effects</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".plasmaNumColors"></A><TT>.plasmaNumColors</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.PlasmaNumColors</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the number of colors used when making the <TT><A HREF="#plasma">Plasma</A></TT>
background style. Notice that this resource together with <TT><A HREF="#.plasmaGraininess">.plasmaGraininess</A></TT>
define the smoothness of the PlasmaCloud effect, though it is better to
choose a higher graininess factor than a lower number of colors to get
a less smooth effect.&nbsp;
<BR>Command-line: <TT>-plncol</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".plasmaGraininess"></A><TT>.plasmaGraininess</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.PlasmaGraininess</TT>
<BR><I>Float</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a floating-point value which must be positive, and
chooser the graininess factor for the PlasmaCloud.&nbsp;
<BR>Command-line: <TT>-plgrain</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgPlasmaNCol"></A><TT>.fgPlasmaNCol</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgPlasmaNCol</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the number of colors to use for the <TT><A HREF="#FgPlasma">FgPlasma</A></TT>
rendering effect.&nbsp;
<BR>Command-line: <TT>-fgplncol</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgPlasmaGrain"></A><TT>.fgPlasmaGrain</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgPlasmaGrain</TT>
<BR><I>Float</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the graininess factor for the <TT><A HREF="#FgPlasma">FgPlasma</A></TT>
rendering effect. This value must be positive.&nbsp;
<BR>Command-line: <TT>-fgplgrain</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgPlasmaGrad"></A><TT>.fgPlasmaGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgPlasmaGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> of
the <TT><A HREF="#FgPlasma">FgPlasma</A></TT> effect.&nbsp;
<BR>Command-line: <TT>-fgplgrad</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68068"></A>Miscellaneous Effect-Specific Resources</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".shadows"></A><TT>.shadows</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Shadows</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This sets the number of 'shadows' under the main text in
the <TT><A HREF="#3D-Shadow">3D-Shadow</A></TT> effect. This resource must
be positive.&nbsp;
<BR>Command-line: <TT>-shadows</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgCycColors"></A><TT>.fgCycColors</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgCycColors</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the number of colors for the <TT>FG</TT> cycling
effect. Must be positive.&nbsp;
<BR>Command-line: <TT>-fgcyccols</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".backlightGrad"></A><TT>.backlightGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.BacklightGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This determines the <A HREF="#color_grad">color-gradient</A>
for the <TT><A HREF="#Backlight">Backlight</A></TT> effect. The first color
in the specification is furtherst from the letters. So if you want to see
why it is called <TT>Backlight</TT>, try a FG color of black, on a DarkBlue
screen, and use <TT>.backlightGrad: darkblue,cyan</TT>.&nbsp;
<BR>Command-line: <TT>-bkltgrad</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fadeGrad"></A><TT>.fadeGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FadeGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> for
the <TT><A HREF="#Fade">Fade</A></TT> effect. Again, the first color is
furthest from the letters. To gain best results, make the first color in
the specification be very very close to the color of the background around
the letters.&nbsp;
<BR>Command-line: <TT>-fadegrad</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fatTextGrad"></A><TT>.fatTextGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FatTextGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> for
the <TT><A HREF="#FatText">FatText</A></TT> effect. Here the first color
is the inner color.&nbsp;
<BR>Command-line: <TT>-ftgrad</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgGradGrad"></A><TT>.fgGradGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgGradGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> for
the <TT><A HREF="#FgGrad">FgGrad</A></TT> effect. Here the first color
in the specification is near the top of the text.&nbsp;
<BR>Command-line: <TT>-fggrad</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgGradBarSize"></A><TT>.fgGradBarSize</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgGradBarSize</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This numeric resource determines how many pixel-lines of
the <TT><A HREF="#FgGrad">FgGrad</A></TT> effect's main text should use
each color, hence deciding the number of colors used for this effect.&nbsp;
<BR>Command-line: <TT>-fggradbs</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".fgCycleGrad"></A><TT>.fgCycleGrad</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.FgCycleGrad</TT>
<BR><I>GradSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> used
for the <TT>FG</TT> cycling effect.&nbsp;
<BR>Command-line: <TT>-fgcycgrad</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-68069"></A>Other Effects Specific Options</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".foreground"></A><TT>.foreground</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Foreground</TT>
<BR><I>ColorSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the main color for the text, and initial color for
most things.&nbsp;
<BR>Command-line: <TT>-fg</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".shadowColor"></A><TT>.shadowColor</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ShadowColor</TT>
<BR><I>ColorSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is the <A HREF="#color_res">color</A> of the shadow
for the following effects: <TT><A HREF="#FatText">FatText</A></TT>, <TT><A HREF="#FgGrad">FgGrad</A></TT>,
<TT><A HREF="#FgPlasma">FgPlasma</A></TT>, <TT><A HREF="#Shadow">Shadow</A></TT>,
and <TT><A HREF="#Shadowed-Outline">Shadowed-Outline</A></TT>. This also
selects the color of the outlines of the various shadows of the <TT><A HREF="#3D-Shadow">3D-Shadow</A></TT>.
Also, this selects the right and bottom colors for the <TT><A HREF="#StandOut">StandOut/In/Out2/In2</A></TT>
effects.&nbsp;
<BR>Command-line: <TT>-shadowcol</TT> or <TT>-sc</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".hiColor"></A><TT>.hiColor</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.HiColor</TT>
<BR><I>ColorSpec</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the color of the outline in <TT><A HREF="#Outline">Outline</A></TT>
effect, the outline color of the main text in <TT><A HREF="#3D-Shadow">3D-Shadow</A></TT>,
the colors for the left and top sides of the text in <TT><A HREF="#StandOut">StandOut/In/Out2/In2</A></TT>.&nbsp;
<BR>Command-line: <TT>-hicolor</TT> or <TT>-hc</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".thickness"></A><TT>.thickness</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Thickness</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the thickness of the following effects: <TT><A HREF="#Backlight">Backlight</A></TT>,
<TT><A HREF="#Coin">Coin</A></TT>, <TT><A HREF="#Fade">Fade</A></TT>, <TT><A HREF="#FatText">FatText</A></TT>,
<TT><A HREF="#FunnyOutline">FunnyOutline</A></TT>, <TT><A HREF="#PopArt">PopArt</A></TT>,
<TT><A HREF="#StandOut">StandOut/In/Out2/In2</A></TT>, <TT><A HREF="#Thick">Thick</A></TT>.
Notice that while it is obvious what <TT>.thickness</TT> means for some
of the effects, it is not obvious for others. For the <TT>FatText</TT>
and <TT>StandIn/In2</TT>, the <TT>.thickness</TT> selects the number of
pixels along the letters' edge and into the letter that XBanner will draw.
This is also true for <TT>FunnyOutline</TT>.&nbsp;
<BR>Command-line: <TT>-thickness</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".shadowXOffset"></A><TT>.shadowXOffset</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ShadowOffset</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource, which may be negative selects the <TT>X</TT>
offset of the shadow under the text, for those effects that have a shadow:
<TT><A HREF="#3D-Shadow">3D-Shadow</A></TT>, <TT><A HREF="#FatText">FatText</A></TT>,
<TT><A HREF="#FgGrad">FgGrad</A></TT>, <TT><A HREF="#FgPlasma">FgPlasma</A></TT>,
<TT><A HREF="#Shadow">Shadow</A></TT>, <TT><A HREF="#Shadowed-Outline">Shadowed-Outline</A></TT>.
Negative values will cause the shadow to appear on the left.&nbsp;
<BR>No command-line switch, see <TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".shadowYOffset"></A><TT>.shadowYOffset</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.ShadowOffset</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource, which may be negative selects the <TT>Y</TT>
offset of the shadow under the text. See <TT><A HREF="#.shadowXOffset">.shadowXOffset</A></TT>&nbsp;
<BR>No command-line switch, see <TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT>.&nbsp;
</TD>
</TR>

<TR>
<TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I>&nbsp;
</TD>

<TD VALIGN=TOP><A NAME=".ShadowOffset"></A><TT>.ShadowOffset</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This common classname selects how far left and down from
the main text the shadow will appear. It simply sets both <TT><A HREF="#.shadowXOffset">.shadowXOffset</A></TT>
and <TT><A HREF="#.shadowYOffset">.shadowYOffset</A></TT>.&nbsp;
<BR>Command-line: <TT>-shdoffset</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".surroundMin"></A><TT>.surroundMin</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Surround</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the offset to the left and up from the main
text where the outline will start. See <TT><A HREF="#.Surround">.Surround</A></TT>
for detailed description.&nbsp;
<BR>No command-line switch, see <TT><A HREF="#.Surround">.Surround</A></TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".surroundMax"></A><TT>.surroundMax</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Surround</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the offset to the right and down from the main
text where the outline will start. See <TT><A HREF="#.Surround">.Surround</A></TT>
for detailed description.&nbsp;
<BR>No command-line switch, see <TT><A HREF="#.Surround">.Surround</A></TT>.&nbsp;
</TD>
</TR>

<TR>
<TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I>&nbsp;
</TD>

<TD VALIGN=TOP><A NAME=".Surround"></A><TT>.Surround</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This resource selects how the oultline will look. Outlines
are done by simply drawing the text in the outline's color, in severak
locations surrounding the position of the text. If this resource is set
to 1, then the text will be drawn in the outline's color one pixel left-up,
up, right-up, left, right, left-down, down, right-down from the main text.
You can use a <TT><A HREF="#.surroundMin">.surroundMin</A></TT> value of
1 and a <TT><A HREF="#.surroundMax">.surroundMax</A></TT> value of 6 to
generate asymetric outlines. This resource affects the following effects:
<TT><A HREF="#Outline">Outline</A></TT>, <TT><A HREF="#Shadowed-Outline">Shadowed-Outline</A></TT>,
<TT><A HREF="#3D-Shadow">3D-Shadow</A></TT>.&nbsp;
<BR>Command-line: <TT>-surround</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-680610"></A>Miscellaneous Resources</H3></CENTER>

<TABLE BORDER >
<TR>
<TH ALIGN=LEFT VALIGN=TOP>Resource
</TH>

<TH ALIGN=LEFT VALIGN=TOP>Class
<BR><I>Type</I>
</TH>

<TH VALIGN=TOP>Description&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".x"></A><TT>.x</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.X</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the X position of the text for the <TT>XY</TT>
<A HREF="#.placement">placement</A> type.&nbsp;
<BR>Command-line: <TT>-x</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".y"></A><TT>.y</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Y</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects the Y position of the text for the <TT>XY</TT>,
and <TT>CenteredOnY</TT> <A HREF="#.placement">placement</A> types.&nbsp;
<BR>Command-line: <TT>-y</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".defXOffset"></A><TT>.defXOffset</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.DefOffset</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects a minimum distance from the left / right sides
of the screen where the text is allowed to be. This resource mainly guards
against trying to draw outside the screen.&nbsp;
<BR>No command-line switch.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".defYOffset"></A><TT>.defYOffset</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.DefOffset</TT>
<BR><I>Numeric</I>
<BR><I>(common class)</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects a minimum distance from the top / bottom of
the screen where the text is allowed to be. This resource mainly guards
against trying to draw outside the screen.&nbsp;
<BR>No command-line switch.&nbsp;
</TD>
</TR>

<TR>
<TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I>&nbsp;
</TD>

<TD VALIGN=TOP><A NAME=".DefOffset"></A><TT>.DefOffset</TT>
<BR><I>Numeric</I>&nbsp;
</TD>

<TD VALIGN=TOP>This selects both <TT><A HREF="#.defXOffset">.defXOffset</A></TT>
and <TT><A HREF="#.defYOffset">.defYOffset</A></TT> in one resource.&nbsp;
<BR>No command-line switch.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".linger"></A><TT>.linger</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Linger</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a <A HREF="#boolean">boolean</A> resource telling
XBanner to leave behind a process with an open display to the X server,
and wait until the '<B><TT>freetemp</TT></B>' utility is run. This helps
a lot if you want to run XBanner behind a Chooser window for XDMCP over
to X-Terminals and such. Since the Chooser will open the display after
the <TT>Xsetup</TT> script is done, the X server will see no clients, and
reset! This option will prevent this.&nbsp;
<BR>Command-line: <TT>-linger</TT>&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><A NAME=".expose"></A><TT>.expose</TT>&nbsp;
</TD>

<TD VALIGN=TOP><TT>.Expose</TT>
<BR><I>Boolean</I>&nbsp;
</TD>

<TD VALIGN=TOP>This is a <A HREF="#boolean">boolean</A> resource telling
XBanner to redraw any areas of the screen that become uncovered. When you
succeed in logging in, the login-box disappears, and leaves an empty rectangle
until your X login sequence fills the screen with something else. This
feature is also probably necessary if you wish to use the moving XDM3D
(which moves the login-box randomly every few seconds, ala Windows-NT).
You must use the '<B><TT>freetemp</TT></B>' utility if you use this.&nbsp;
<BR><B>Important limitation:</B> If you are running XBanner twice (e.g. for
2 lines) then you must not let the first invocation of XBanner handle expose
events, since this will cause unexpected results!
<BR>Command-line: <TT>-expose</TT>/<TT>-noexpose</TT>&nbsp;
</TD>
</TR>
</TABLE>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="cmdline"></A>Other Command Line Switches</H3></CENTER>

<CENTER><TABLE BORDER COLS=2 >
<TR>
<TH>Switch
</TH>

<TH>Meaning&nbsp;
</TH>
</TR>

<TR>
<TD VALIGN=TOP><TT>-h</TT>
</TD>

<TD VALIGN=TOP>Simple help and version information.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><TT>-v</TT>
</TD>

<TD VALIGN=TOP>Same as <TT>-h</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><TT>-help</TT>
</TD>

<TD VALIGN=TOP>Displays a detailed list of command-line switches to <TT>stdout</TT>.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><TT>-display</TT>
</TD>

<TD VALIGN=TOP>The display to work with.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><TT>-file</TT>
</TD>

<TD VALIGN=TOP>Use a specified resource file.&nbsp;
</TD>
</TR>

<TR>
<TD VALIGN=TOP><TT>-xrm</TT>
</TD>

<TD VALIGN=TOP>Use this option to quote any X resource that XBanner recognizes.&nbsp;
</TD>
</TR>
</TABLE></CENTER>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="prgclass"></A>Program Class Name Hints</H3></CENTER>
The program class is <TT>XBanner</TT>, and the program name is the name
of the binary. This means that if you make a link to <TT>xbanner</TT> and
call it <TT>mybanner</TT> then you can use two resources like:

<PRE>mybanner.thickness:&nbsp;&nbsp;&nbsp;&nbsp; 9
XBanner.thickness:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 5</PRE>
<CENTER>and when you run <TT>xbanner</TT>, you will get a thickness of 5, but if
you run it as <TT>mybanner</TT> the thickness will be 9!</CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="outline_effects"></A>Outline Effects - Detailed Information</H3></CENTER>
All outline effects use the <TT><A HREF="#.surroundMin">.surroundMin</A></TT>
and <TT><A HREF="#.surroundMax">.surroundMax</A></TT> resources. But you
can set both of them together using their common class name - <TT><A HREF="#.Surround">XBanner.Surround</A></TT>.
In general, the outlining is done by drawing the text in the shadow color
first a bit to the left and up, and work your way on all the directions.
This means that if <TT><A HREF="#.surroundMin">.surroundMin</A></TT> is
-1, <TT><A HREF="#.surroundMax">.surroundMax</A></TT> is 2, and the text
should be placed at some <TT>X,Y</TT> location, the outline will be drawn
at:

<PRE>(X-1,Y-1), (X,Y-1), (X+1,Y-1), (X+2,Y-1), (X-1,Y), . . . , (X+2,y+2).</PRE>
<CENTER>This was done mainly because I wanted to enable unbalanced outlines on
the axis going from top-left to down-right. This does not pertain to the
<TT><A HREF="#FunnyOutline">FunnyOutline</A></TT> effect.</CENTER>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="underline_effects"></A>Underline Effects - Detailed
Information</H3></CENTER>
<CENTER>The <TT><A HREF="#.underlined">.underlined</A></TT> resource is a <TT><A HREF="#boolean">boolean</A></TT>
that enables underlining of the text drawn by XBanner. You can choose a
color name / RGB and set it with the <TT><A HREF="#.underlineColor">.underlineColor</A></TT>
resource, but the best is to set this to <TT>FGC</TT> which is a special
keyword. XBanner recognizes this special name and uses the FG color for
the underline. This means that the effects will get rendered on the underline
as well. You can choose the line thickness with the <TT><A HREF="#.underlineThickness">.underlineThickness</A></TT>
resource.</CENTER>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="rootimg"></A>Images On The Root Window</H3></CENTER>
Currently, only pixmap files are supported. I plan to add <TT>.GIF</TT>
support, for <TT>GIF89a</TT> version, since this version (like <TT>.XPM</TT>)
has an option to specify a transparent color. The pixmap pasted on the
screen uses the <TT>None</TT> color specification in the pixmap file. You
can also use an image to be tiled over the entire root window. See the
<A HREF="#bgpix">BgPix</A> background style.
<CENTER><BR></CENTER>
<CENTER>I have supplied a version of Larry Ewing's Penguin Linux Logo in <TT>.XPM</TT>
format with the background set to <TT>None</TT> so it is useable with XBanner!
Another version with a colormap reduced to 32 colors is also supported.
See the demo for the use of pixmaps.</CENTER>
<CENTER></CENTER>
<CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768>&nbsp;</CENTER>

<CENTER>
<H3>
<A NAME="as-h4-680611"></A>Notes And Explanations Of Different
Types Of Resources</H3></CENTER>

<OL>
<LI>
<A NAME="numeric"></A><FONT COLOR="#0000DA">Numeric</FONT> resources
are integer numbers.</LI>

<LI>
<A NAME="float"></A><FONT COLOR="#0000DA">Float</FONT> resources are
simple notation floating-point numbers. Use XX.YY notation only.</LI>

<LI>
<A NAME="boolean"></A><FONT COLOR="#0000DA">Boolean</FONT> resources
are also not case-sensitive and can accept the values: <TT>True, False,
Yes, No, On, Off, 1, 0</TT>. It should be noted that if you use <TT>-file</TT>
to load a resource file, and that resource file specifies a certain boolean
value, then you can override it with another commandline option. Hence
using <TT>-bgstyle None</TT> will definitely make XBanner not render any
background.</LI>

<LI>
<A NAME="keyword"></A><FONT COLOR="#0000DA">Keyword</FONT> resources
are not case sensitive. Using <TT>XBanner.effect: fgplasma</TT> is the
same as using <TT>XBanner.effect: FgPlasma</TT>. This is true for the keywords
to command-line switches as well: <TT>-effect Coin</TT> is the same as
<TT>-effect COIN</TT>. (Be careful, the switches themselves ARE case sensitive
in Unix, so <TT>-Effect</TT> is not <TT>-effect</TT>!).</LI>

<LI>
<A NAME="keyword_list"></A><FONT COLOR="#0000DA">Keyword lists</FONT>
are simply a comma-separated list of keywords. Some resources take this
type of value, like <TT><A HREF="#.cycleColors">.cycleColors</A></TT>.</LI>

<LI>
<A NAME="color_res"></A><FONT COLOR="#0000DA">Color</FONT> resources
are simply a name of a color, or a color RGB representation. You can use
either <TT>#RRGGBB</TT> or <TT>#RRRRGGGGBBBB</TT>.</LI>

<LI>
<A NAME="color_grad"></A><FONT COLOR="#0000DA">Color gradients</FONT>
are simply a comma-separated list of <A HREF="#color_res">color</A> resources.
The limit is currently 8 colors per gradient and can be changed through
editing <TT>xbanner.h</TT> and changing the <TT>MAX_COLORS_PER_GRAD</TT>
definition. Here's an example:</LI>
<BR><TT>XBanner.BgGrad: Red,#00C276,Blue,Green,#000010AC5F42</TT>&nbsp;
</OL>

<HR>

<CENTER>
<H3>
<A NAME="Index"></A>Alphabetical Index Of Resources</H3></CENTER>

<H4>
Common Classes</H4>

<UL>
<LI>
<TT><A HREF="#.DefOffset">.DefOffset</A></TT>&nbsp;</LI>

<LI>
<TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT>&nbsp;</LI>

<LI>
<TT><A HREF="#.Surround">.Surround</A></TT>&nbsp;</LI>
</UL>

<H4>
Resources</H4>

<TABLE>
<TR>
<TD>- A -&nbsp;
</TD>

<TD><TT><A HREF="#.fatTextGrad">.fatTextGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.plasmaGraininess">.plasmaGraininess</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.autoFillBg">.autoFillBg</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgCycColors">.fgCycColors</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.plasmaNumColors">.plasmaNumColors</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD>- B -&nbsp;
</TD>

<TD><TT><A HREF="#.fgCycleGrad">.fgCycleGrad</A></TT>&nbsp;
</TD>

<TD>- R -&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.backlightGrad">.backlightGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgGradBarSize">.fgGradBarSize</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.reverseCycle">.reverseCycle</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.barSize">.barSize</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgGradGrad">.fgGradGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.rippleColors">.rippleColors</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgFill">.bgFill</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgPlasmaGrad">.fgPlasmaGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.ripples">.ripples</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgFillColor">.bgFillColor</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgPlasmaGrain">.fgPlasmaGrain</A></TT>&nbsp;
</TD>

<TD>- S -&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgGrad">.bgGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.fgPlasmaNCol">.fgPlasmaNCol</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.shadowColor">.shadowColor</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgGradRepeat">.bgGradRepeat</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.font">.font</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.shadowXOffset">.shadowXOffset</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgGradSteps">.bgGradSteps</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.foreground">.foreground</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.shadowYOffset">.shadowYOffset</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgPixFile">.bgPixFile</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.forwardCycle">.forwardCycle</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.shadows">.shadows</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.bgStyle">.bgStyle</A></TT>&nbsp;
</TD>

<TD>- G -&nbsp;
</TD>

<TD><TT><A HREF="#.showCalc">.showCalc</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD>- C -&nbsp;
</TD>

<TD><TT><A HREF="#.glint">.glint</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.showErrors">.showErrors</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.cornerMask">.cornerMask</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.glintMax">.glintMax</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.surroundMax">.surroundMax</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.cycleColors">.cycleColors</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.glintMin">.glintMin</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.surroundMin">.surroundMin</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.cycleSpeed">.cycleSpeed</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.glintSpeed">.glintSpeed</A></TT>&nbsp;
</TD>

<TD>- T -&nbsp;
</TD>
</TR>

<TR>
<TD>- D -&nbsp;
</TD>

<TD><TT><A HREF="#.glintTimeMax">.glintTimeMax</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.thickness">.thickness</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.defXOffset">.defXOffset</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.glintTimeMin">.glintTimeMin</A></TT>&nbsp;
</TD>

<TD>- U -&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.defYOffset">.defYOffset</A></TT>&nbsp;
</TD>

<TD>- H -&nbsp;
</TD>

<TD><TT><A HREF="#.underlineColor">.underlineColor</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.doPixmap">.doPixmap</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.hiColor">.hiColor</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.underlineThickness">.underlineThickness</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.dumpRes">.dumpRes</A></TT>&nbsp;
</TD>

<TD>- L -&nbsp;
</TD>

<TD><TT><A HREF="#.underlined">.underlined</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.dumpResFile">.dumpResFile</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.label">.label</A></TT>&nbsp;
</TD>

<TD>- X -&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.effectSteps">.effectSteps</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.linger">.linger</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.x">.x</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD>- E -&nbsp;
</TD>

<TD>- P -&nbsp;
</TD>

<TD>- Y -&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.effect">.effect</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.pixFile">.pixFile</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.y">.y</A></TT>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.expose">.expose</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.pixmapX">.pixmapX</A></TT>&nbsp;
</TD>

<TD>&nbsp;
</TD>
</TR>

<TR>
<TD>- F -&nbsp;
</TD>

<TD><TT><A HREF="#.pixmapY">.pixmapY</A></TT>&nbsp;
</TD>

<TD>&nbsp;
</TD>
</TR>

<TR>
<TD><TT><A HREF="#.fadeGrad">.fadeGrad</A></TT>&nbsp;
</TD>

<TD><TT><A HREF="#.placement">.placement</A></TT>&nbsp;
</TD>

<TD>&nbsp;
</TD>
</TR>
</TABLE>
<A HREF="index.html">Back to documentation index</A>.
<BR>
<HR>
<BR>
<BR><A HREF="../index.html">Back to top</A>.
<BR>
<BR><A HREF="mailto:amitm@netvision.net.il"><IMG SRC="email.gif" ALT="[email]" HEIGHT=26 WIDTH=89></A><A HREF="mailto:amitm@netvision.net.il">Please
email me for any comments.</A>&nbsp;

</BODY>
</HTML>