<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> <!-- 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> </TD> <TD><A HREF="#as-h4-68068">Miscellaneous Effect-Specific Resources</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68061">Information And Debugging Options</A> </TD> <TD><A HREF="#as-h4-68069">Other Effects Specific Options</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68062">Background Effects</A> </TD> <TD><A HREF="#as-h4-680610">Miscellaneous Resources</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68063">Underlining The Text</A> </TD> <TD><A HREF="#cmdline">Other Command Line Switches</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68064">Putting An Image On The Screen</A> </TD> <TD><A HREF="#prgclass">Program Class And Program Name Hints</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68065">The Glint Feature</A> </TD> <TD><A HREF="#outline_effects">Outline Effects - Detailed Information</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68066">Color Cycling Options</A> </TD> <TD><A HREF="#underline_effects">Underline Effects - Detailed Information</A> </TD> </TR> <TR> <TD><A HREF="#as-h4-68067">PlasmaCloud Effects</A> </TD> <TD><A HREF="#as-h4-680611">Explanations About Resource Types</A> </TD> </TR> </TABLE></CENTER> <CENTER></CENTER> <CENTER>Click <A HREF="#Index">here</A> to see the index. <!-- AS-TOC_END} --></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".label"></A><TT>.label</TT> </TD> <TD VALIGN=TOP><TT>.Label</TT> <BR><I>String</I> </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. <BR> <BR>You can use double-quotes (e.g. <TT>" "</TT>) for leading spaces. <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>. <BR> <BR>Command-line: <TT>-label</TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".effect"></A><TT>.effect</TT> </TD> <TD VALIGN=TOP><TT>.Effect</TT> <BR><I>Keyword</I> </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. <BR>Valid values: <DL> <DT> <A NAME="3D-Shadow"></A><TT>3D-Shadow</TT> </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>. </DD> <DT> <A NAME="Backlight"></A><TT>Backlight</TT> </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. </DD> <DT> <A NAME="Coin"></A><TT>Coin</TT> </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. </DD> <DT> <A NAME="Fade"></A><TT>Fade</TT> </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. </DD> <DT> <A NAME="FatText"></A><TT>FatText</TT> </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. </DD> <DT> <A NAME="FgGrad"></A><TT>FgGrad</TT> </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. </DD> <DT> <A NAME="FgPlasma"></A><TT>FgPlasma</TT> </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>. </DD> <DT> <A NAME="FunnyOutline"></A><TT>FunnyOutline</TT> </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. </DD> <DT> <A NAME="None"></A><TT>None</TT> </DT> <DD> No effect. Text is drawn as it is. </DD> <DT> <A NAME="Outline"></A><TT>Outline</TT> </DT> <DD> Text appears with an outline. Use the <TT><A HREF="#.hiColor">.hiColor</A></TT> resource to select the color of the outline. </DD> <DT> <A NAME="Popart"></A><TT>PopArt</TT> </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. </DD> <DT> <A NAME="Shadow"></A><TT>Shadow</TT> </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. </DD> <DT> <A NAME="Shadowed-Outline"></A><TT>Shadowed-Outline</TT> </DT> <DD> Combination of <TT><A HREF="#Shadow">Shadow</A></TT> and <TT><A HREF="#Outline">Outline</A></TT>. </DD> <DT> <A NAME="Shake"></A><TT>Shake</TT> </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. </DD> <DT> <A NAME="StandOut"></A><TT>StandOut</TT> </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>. </DD> <DT> <A NAME="StandIn"></A><TT>StandIn</TT> </DT> <DD> This is like <TT><A HREF="#StandOut">StandOut</A></TT> but with the colors inverted. </DD> <DT> <A NAME="StandOut2"></A><TT>StandOut2</TT> </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. </DD> <DT> <A NAME="StandIn2"></A><TT>StandIn2</TT> </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. </DD> <DT> <A NAME="Thick"></A><TT>Thick</TT> </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. </DD> </DL> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".font"></A><TT>.font</TT> </TD> <TD VALIGN=TOP><TT>.Font</TT> <BR><I>String</I> </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>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".placement"></A><TT>.placement</TT> </TD> <TD VALIGN=TOP><TT>.Placement</TT> <BR><I>Keyword</I> </TD> <TD VALIGN=TOP>This resource governs where the text will be placed on the screen. You can choose any of the following: <PRE> TopLeft TopCenter TopRight Center 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>. </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".showErrors"></A><TT>.showErrors</TT> </TD> <TD VALIGN=TOP><TT>.ShowErrors</TT> <BR><I>Boolean</I> </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. <BR>Command-line: <TT>-showerr</TT> and <TT>-noshowerr</TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".showCalc"></A><TT>.showCalc</TT> </TD> <TD VALIGN=TOP><TT>.ShowCalc</TT> <BR><I>Boolean</I> </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. <BR>Command-line: <TT>-showcalc</TT> and <TT>-hidecalc</TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".dumpRes"></A><TT>.dumpRes</TT> </TD> <TD VALIGN=TOP><TT>.DumpRes</TT> <BR><I>Boolean</I> </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. <BR>Command-line: <TT>-dumpres</TT> and <TT>-nodumpres</TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".dumpResFile"></A><TT>.dumpResFile</TT> </TD> <TD VALIGN=TOP><TT>.DumpResFile</TT> <BR><I>String</I> </TD> <TD VALIGN=TOP>This is the file name for the <TT><A HREF="#.dumpRes">.dumpRes</A></TT> resource. <BR>Command-line: <TT>-dumpresfile</TT>. </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgStyle"></A><TT>.bgStyle</TT> </TD> <TD VALIGN=TOP><TT>.BgStyle</TT> <BR><I>Keyword</I> </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. <BR>Command-line: <TT>-bgstyle</TT>. <BR>Valid values: <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. </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. </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. </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. </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. </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. </DD> <DT> <TT>None</TT></DT> <DD> No background rendering will be done. </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. </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. </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. </DD> <DT> <TT>Ripples</TT></DT> <DD> Draws intersecting circles that (when color cycled) look like ripples in a pond. </DD> <DT> <A NAME="topdown"></A><TT>TopDown</TT></DT> <DD> The color gradient goes from top to bottom. </DD> </DL> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgFillColor"></A><TT>.bgFillColor</TT> </TD> <TD VALIGN=TOP><TT>.BgFillColor</TT> <BR><I>ColorSpec</I> </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. <BR>Command-line: <TT>-bg</TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgGrad"></A><TT>.bgGrad</TT> </TD> <TD VALIGN=TOP><TT>.BgGrad</TT> <BR><I>GradSpec</I> </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. <BR>Command-line: <TT>-bggrad</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgGradRepeat"></A><TT>.bgGradRepeat</TT> </TD> <TD VALIGN=TOP><TT>.BgGradRepeat</TT> <BR><I>Numeric</I> </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. <BR>This resource must be a positive integer. <BR>Command-line: <TT>-bggradrep</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".autoFillBg"></A><TT>.autoFillBg</TT> </TD> <TD VALIGN=TOP><TT>.AutoFillBg</TT> <BR><I>Boolean</I> </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>. <BR>Command-line: <TT>-autofill</TT> and <TT>-noautofill</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgFill"></A><TT>.bgFill</TT> </TD> <TD VALIGN=TOP><TT>.BgFill</TT> <BR><I>Boolean</I> </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>. <BR>Command-line: <TT>-bgfill</TT> and <TT>-nobgfill</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".barSize"></A><TT>.barSize</TT> </TD> <TD VALIGN=TOP><TT>.BarSize</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-barsize</TT> or <TT>-bs</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgPixFile"></A><TT>.bgPixFile</TT> </TD> <TD VALIGN=TOP><TT>.BgPixFile</TT> <BR><I>String</I> </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. <BR>Command-line: <TT>-bgpixfile</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".ripples"></A><TT>.ripples</TT> </TD> <TD VALIGN=TOP><TT>.Ripples</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>Selects the number of circles to draw for the <TT>Ripples</TT> background. Best values are 2 and 3. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".rippleColors"></A><TT>.rippleColors</TT> </TD> <TD VALIGN=TOP><TT>.RippleColors</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>This is the number of colors to use for the <TT>Ripples</TT> background. </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".underlined"></A><TT>.underlined</TT> </TD> <TD VALIGN=TOP><TT>.Underlined</TT> <BR><I>Boolean</I> </TD> <TD VALIGN=TOP>This <A HREF="#boolean">boolean</A> resource determines if the text will be underlined. <BR>Command-line: <TT>-underline</TT> or <TT>-ul</TT>, and <TT>-noul</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".underlineColor"></A><TT>.underlineColor</TT> </TD> <TD VALIGN=TOP><TT>.UnderlineColor</TT> <BR><I>ColorSpec</I> </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>. <BR>Command-line: <TT>-ulcolor</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".underlineThickness"></A><TT>.underlineThickness</TT> </TD> <TD VALIGN=TOP><TT>.UnderlineThickness</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>This numerical value (which must be positive) determines the number of pixels width of the underline. <BR>Command-line: <TT>-ulthick</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".doPixmap"></A><TT>.doPixmap</TT> </TD> <TD VALIGN=TOP><TT>.DoPixmap</TT> <BR><I>Boolean</I> </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. <BR>Command-line: <TT>-dopixmap</TT> and <TT>-nopixmap</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".pixFile"></A><TT>.pixFile</TT> </TD> <TD VALIGN=TOP><TT>.PixFile</TT> <BR><I>String</I> </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> <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> </TD> <TD VALIGN=TOP><TT>.PixmapX</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>The <TT>X</TT> position of the pixmap on the screen. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".pixmapY"></A><TT>.pixmapY</TT> </TD> <TD VALIGN=TOP><TT>.PixmapY</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>The <TT>Y</TT> position of the pixmap on the screen. </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".glint"></A><TT>.glint</TT> </TD> <TD VALIGN=TOP><TT>.Glint</TT> <BR><I>Boolean</I> </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>. <BR>Command-line: <TT>-glint</TT> and <TT>-noglint</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".glintSpeed"></A><TT>.glintSpeed</TT> </TD> <TD VALIGN=TOP><TT>.GlintSpeed</TT> <BR><I>Numeric</I> </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: <UL> <LI> Positive values make for faster and faster glints, which use up less CPU time and less network bandwidth. </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>. </LI> <LI> Negative values mean slower and slower glints. </LI> </UL> Command-line: <TT>-glintspeed</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".glintMin"></A><TT>.glintMin</TT> </TD> <TD VALIGN=TOP><TT>.GlintMin</TT> <BR><I>Numeric</I> </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>. <BR>Command-line: <TT>-gmin</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".glintMax"></A><TT>.glintMax</TT> </TD> <TD VALIGN=TOP><TT>.GlintMax</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>See <TT><A HREF="#.glintMin">.glintMin</A></TT>. <BR>Command-line: <TT>-gmax</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".glintTimeMin"></A><TT>.glintTimeMin</TT> </TD> <TD VALIGN=TOP><TT>.GlintTimeMin</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-gtimemin</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".glintTimeMax"></A><TT>.glintTimeMax</TT> </TD> <TD VALIGN=TOP><TT>.GlintTimeMax</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>See <TT><A HREF="#.glintTimeMin">.glintTimeMin</A></TT> <BR>Command-line: <TT>-gtimemax</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".cornerMask"></A><TT>.cornerMask</TT> </TD> <TD VALIGN=TOP><TT>.CornerMask</TT> <BR><I>Keyword-list</I> </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. <BR>Keywords: <DL> <DT> <TT>All</TT> </DT> <DD> All corners. </DD> <DT> <TT>DownLeft</TT> </DT> <DD> Add Down-Left corners. </DD> <DT> <TT>DownRight</TT> </DT> <DD> Add Down-Right corners. </DD> <DT> <TT>NoDownLeft</TT> </DT> <DD> Remove Down-Left corners from the mask. </DD> <DT> <TT>NoDownRight</TT> </DT> <DD> Remove Down-Right corners from the mask. </DD> <DT> <TT>NoUpLeft</TT> </DT> <DD> Remove Up-Left corners from the mask. </DD> <DT> <TT>NoUpRight</TT> </DT> <DD> Remove Up-Right corners from the mask. </DD> <DT> <TT>UpLeft</TT> </DT> <DD> Add Up-Left corners. </DD> <DT> <TT>UpRight</TT> </DT> <DD> Add Up-Right corners. </DD> </DL> Command-line: <TT>-cornermask</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".cycleColors"></A><TT>.cycleColors</TT> </TD> <TD VALIGN=TOP><TT>.CycleColors</TT> <BR><I>Keyword-list</I> </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>. <BR>Command-line: <TT>-cycle</TT> <BR>Valid keywords: <DL> <DT> <TT>Backlight</TT> </DT> <DD> Cycle the colors of the <TT><A HREF="#Backlight">Backlight</A></TT> effect. </DD> <DT> <TT>BG</TT> </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. </DD> <DT> <TT>Fade</TT> </DT> <DD> Cycle the colors of the <TT><A HREF="#Fade">Fade</A></TT> effect. </DD> <DT> <TT>FatText</TT> </DT> <DD> Cycle the colors of the <TT><A HREF="#FatText">FatText</A></TT> effect. </DD> <DT> <TT>FG</TT> </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. </DD> <DT> <TT>FgGrad</TT> </DT> <DD> Cycle the colors of the <TT><A HREF="#FgGrad">FgGrad</A></TT> effect's color gradient. </DD> <DT> <TT>FgPlasma</TT> </DT> <DD> Cycle the colors of the <TT><A HREF="#FgPlasma">FgPlasma</A></TT> effect. </DD> <DT> <TT>None</TT> </DT> <DD> No color-cycling. </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> </TD> <TD VALIGN=TOP><TT>.ReverseCycle</TT> <BR><I>Keyword-list</I> </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>. <BR>Command-line: <TT>-cycrev</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".forwardCycle"></A><TT>.forwardCycle</TT> </TD> <TD VALIGN=TOP><TT>.ForwardCycle</TT> <BR><I>Keyword-list</I> </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>. <BR>Command-line: <TT>-cycfor</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".cycleSpeed"></A><TT>.cycleSpeed</TT> </TD> <TD VALIGN=TOP><TT>.CycleSpeed</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-cycspeed</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".bgGradSteps"></A><TT>.bgGradSteps</TT> </TD> <TD VALIGN=TOP><TT>.BgGradSteps</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-bgsteps</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".effectSteps"></A><TT>.bgGradSteps</TT> </TD> <TD VALIGN=TOP><TT>.EffectSteps</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-effectsteps</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".plasmaNumColors"></A><TT>.plasmaNumColors</TT> </TD> <TD VALIGN=TOP><TT>.PlasmaNumColors</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-plncol</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".plasmaGraininess"></A><TT>.plasmaGraininess</TT> </TD> <TD VALIGN=TOP><TT>.PlasmaGraininess</TT> <BR><I>Float</I> </TD> <TD VALIGN=TOP>This is a floating-point value which must be positive, and chooser the graininess factor for the PlasmaCloud. <BR>Command-line: <TT>-plgrain</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgPlasmaNCol"></A><TT>.fgPlasmaNCol</TT> </TD> <TD VALIGN=TOP><TT>.FgPlasmaNCol</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>This is the number of colors to use for the <TT><A HREF="#FgPlasma">FgPlasma</A></TT> rendering effect. <BR>Command-line: <TT>-fgplncol</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgPlasmaGrain"></A><TT>.fgPlasmaGrain</TT> </TD> <TD VALIGN=TOP><TT>.FgPlasmaGrain</TT> <BR><I>Float</I> </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. <BR>Command-line: <TT>-fgplgrain</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgPlasmaGrad"></A><TT>.fgPlasmaGrad</TT> </TD> <TD VALIGN=TOP><TT>.FgPlasmaGrad</TT> <BR><I>GradSpec</I> </TD> <TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> of the <TT><A HREF="#FgPlasma">FgPlasma</A></TT> effect. <BR>Command-line: <TT>-fgplgrad</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".shadows"></A><TT>.shadows</TT> </TD> <TD VALIGN=TOP><TT>.Shadows</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-shadows</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgCycColors"></A><TT>.fgCycColors</TT> </TD> <TD VALIGN=TOP><TT>.FgCycColors</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>This is the number of colors for the <TT>FG</TT> cycling effect. Must be positive. <BR>Command-line: <TT>-fgcyccols</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".backlightGrad"></A><TT>.backlightGrad</TT> </TD> <TD VALIGN=TOP><TT>.BacklightGrad</TT> <BR><I>GradSpec</I> </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>. <BR>Command-line: <TT>-bkltgrad</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fadeGrad"></A><TT>.fadeGrad</TT> </TD> <TD VALIGN=TOP><TT>.FadeGrad</TT> <BR><I>GradSpec</I> </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. <BR>Command-line: <TT>-fadegrad</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fatTextGrad"></A><TT>.fatTextGrad</TT> </TD> <TD VALIGN=TOP><TT>.FatTextGrad</TT> <BR><I>GradSpec</I> </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. <BR>Command-line: <TT>-ftgrad</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgGradGrad"></A><TT>.fgGradGrad</TT> </TD> <TD VALIGN=TOP><TT>.FgGradGrad</TT> <BR><I>GradSpec</I> </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. <BR>Command-line: <TT>-fggrad</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgGradBarSize"></A><TT>.fgGradBarSize</TT> </TD> <TD VALIGN=TOP><TT>.FgGradBarSize</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-fggradbs</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".fgCycleGrad"></A><TT>.fgCycleGrad</TT> </TD> <TD VALIGN=TOP><TT>.FgCycleGrad</TT> <BR><I>GradSpec</I> </TD> <TD VALIGN=TOP>This is the <A HREF="#color_grad">color gradient</A> used for the <TT>FG</TT> cycling effect. <BR>Command-line: <TT>-fgcycgrad</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".foreground"></A><TT>.foreground</TT> </TD> <TD VALIGN=TOP><TT>.Foreground</TT> <BR><I>ColorSpec</I> </TD> <TD VALIGN=TOP>This is the main color for the text, and initial color for most things. <BR>Command-line: <TT>-fg</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".shadowColor"></A><TT>.shadowColor</TT> </TD> <TD VALIGN=TOP><TT>.ShadowColor</TT> <BR><I>ColorSpec</I> </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. <BR>Command-line: <TT>-shadowcol</TT> or <TT>-sc</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".hiColor"></A><TT>.hiColor</TT> </TD> <TD VALIGN=TOP><TT>.HiColor</TT> <BR><I>ColorSpec</I> </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>. <BR>Command-line: <TT>-hicolor</TT> or <TT>-hc</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".thickness"></A><TT>.thickness</TT> </TD> <TD VALIGN=TOP><TT>.Thickness</TT> <BR><I>Numeric</I> </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>. <BR>Command-line: <TT>-thickness</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".shadowXOffset"></A><TT>.shadowXOffset</TT> </TD> <TD VALIGN=TOP><TT>.ShadowOffset</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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. <BR>No command-line switch, see <TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".shadowYOffset"></A><TT>.shadowYOffset</TT> </TD> <TD VALIGN=TOP><TT>.ShadowOffset</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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> <BR>No command-line switch, see <TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT>. </TD> </TR> <TR> <TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I> </TD> <TD VALIGN=TOP><A NAME=".ShadowOffset"></A><TT>.ShadowOffset</TT> <BR><I>Numeric</I> </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>. <BR>Command-line: <TT>-shdoffset</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".surroundMin"></A><TT>.surroundMin</TT> </TD> <TD VALIGN=TOP><TT>.Surround</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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. <BR>No command-line switch, see <TT><A HREF="#.Surround">.Surround</A></TT>. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".surroundMax"></A><TT>.surroundMax</TT> </TD> <TD VALIGN=TOP><TT>.Surround</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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. <BR>No command-line switch, see <TT><A HREF="#.Surround">.Surround</A></TT>. </TD> </TR> <TR> <TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I> </TD> <TD VALIGN=TOP><A NAME=".Surround"></A><TT>.Surround</TT> <BR><I>Numeric</I> </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>. <BR>Command-line: <TT>-surround</TT> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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 </TH> </TR> <TR> <TD VALIGN=TOP><A NAME=".x"></A><TT>.x</TT> </TD> <TD VALIGN=TOP><TT>.X</TT> <BR><I>Numeric</I> </TD> <TD VALIGN=TOP>This selects the X position of the text for the <TT>XY</TT> <A HREF="#.placement">placement</A> type. <BR>Command-line: <TT>-x</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".y"></A><TT>.y</TT> </TD> <TD VALIGN=TOP><TT>.Y</TT> <BR><I>Numeric</I> </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. <BR>Command-line: <TT>-y</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".defXOffset"></A><TT>.defXOffset</TT> </TD> <TD VALIGN=TOP><TT>.DefOffset</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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. <BR>No command-line switch. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".defYOffset"></A><TT>.defYOffset</TT> </TD> <TD VALIGN=TOP><TT>.DefOffset</TT> <BR><I>Numeric</I> <BR><I>(common class)</I> </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. <BR>No command-line switch. </TD> </TR> <TR> <TD ALIGN=CENTER VALIGN=TOP><I>Common Class</I> </TD> <TD VALIGN=TOP><A NAME=".DefOffset"></A><TT>.DefOffset</TT> <BR><I>Numeric</I> </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. <BR>No command-line switch. </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".linger"></A><TT>.linger</TT> </TD> <TD VALIGN=TOP><TT>.Linger</TT> <BR><I>Boolean</I> </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. <BR>Command-line: <TT>-linger</TT> </TD> </TR> <TR> <TD VALIGN=TOP><A NAME=".expose"></A><TT>.expose</TT> </TD> <TD VALIGN=TOP><TT>.Expose</TT> <BR><I>Boolean</I> </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. <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> </TD> </TR> </TABLE> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </CENTER> <CENTER> <H3> <A NAME="cmdline"></A>Other Command Line Switches</H3></CENTER> <CENTER><TABLE BORDER COLS=2 > <TR> <TH>Switch </TH> <TH>Meaning </TH> </TR> <TR> <TD VALIGN=TOP><TT>-h</TT> </TD> <TD VALIGN=TOP>Simple help and version information. </TD> </TR> <TR> <TD VALIGN=TOP><TT>-v</TT> </TD> <TD VALIGN=TOP>Same as <TT>-h</TT>. </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>. </TD> </TR> <TR> <TD VALIGN=TOP><TT>-display</TT> </TD> <TD VALIGN=TOP>The display to work with. </TD> </TR> <TR> <TD VALIGN=TOP><TT>-file</TT> </TD> <TD VALIGN=TOP>Use a specified resource file. </TD> </TR> <TR> <TD VALIGN=TOP><TT>-xrm</TT> </TD> <TD VALIGN=TOP>Use this option to quote any X resource that XBanner recognizes. </TD> </TR> </TABLE></CENTER> <CENTER></CENTER> <CENTER><IMG SRC="red_line.gif" ALT="-" HEIGHT=7 WIDTH=768> </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: 9 XBanner.thickness: 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> </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> </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> </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> </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> </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> </LI> <LI> <TT><A HREF="#.ShadowOffset">.ShadowOffset</A></TT> </LI> <LI> <TT><A HREF="#.Surround">.Surround</A></TT> </LI> </UL> <H4> Resources</H4> <TABLE> <TR> <TD>- A - </TD> <TD><TT><A HREF="#.fatTextGrad">.fatTextGrad</A></TT> </TD> <TD><TT><A HREF="#.plasmaGraininess">.plasmaGraininess</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.autoFillBg">.autoFillBg</A></TT> </TD> <TD><TT><A HREF="#.fgCycColors">.fgCycColors</A></TT> </TD> <TD><TT><A HREF="#.plasmaNumColors">.plasmaNumColors</A></TT> </TD> </TR> <TR> <TD>- B - </TD> <TD><TT><A HREF="#.fgCycleGrad">.fgCycleGrad</A></TT> </TD> <TD>- R - </TD> </TR> <TR> <TD><TT><A HREF="#.backlightGrad">.backlightGrad</A></TT> </TD> <TD><TT><A HREF="#.fgGradBarSize">.fgGradBarSize</A></TT> </TD> <TD><TT><A HREF="#.reverseCycle">.reverseCycle</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.barSize">.barSize</A></TT> </TD> <TD><TT><A HREF="#.fgGradGrad">.fgGradGrad</A></TT> </TD> <TD><TT><A HREF="#.rippleColors">.rippleColors</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgFill">.bgFill</A></TT> </TD> <TD><TT><A HREF="#.fgPlasmaGrad">.fgPlasmaGrad</A></TT> </TD> <TD><TT><A HREF="#.ripples">.ripples</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgFillColor">.bgFillColor</A></TT> </TD> <TD><TT><A HREF="#.fgPlasmaGrain">.fgPlasmaGrain</A></TT> </TD> <TD>- S - </TD> </TR> <TR> <TD><TT><A HREF="#.bgGrad">.bgGrad</A></TT> </TD> <TD><TT><A HREF="#.fgPlasmaNCol">.fgPlasmaNCol</A></TT> </TD> <TD><TT><A HREF="#.shadowColor">.shadowColor</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgGradRepeat">.bgGradRepeat</A></TT> </TD> <TD><TT><A HREF="#.font">.font</A></TT> </TD> <TD><TT><A HREF="#.shadowXOffset">.shadowXOffset</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgGradSteps">.bgGradSteps</A></TT> </TD> <TD><TT><A HREF="#.foreground">.foreground</A></TT> </TD> <TD><TT><A HREF="#.shadowYOffset">.shadowYOffset</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgPixFile">.bgPixFile</A></TT> </TD> <TD><TT><A HREF="#.forwardCycle">.forwardCycle</A></TT> </TD> <TD><TT><A HREF="#.shadows">.shadows</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.bgStyle">.bgStyle</A></TT> </TD> <TD>- G - </TD> <TD><TT><A HREF="#.showCalc">.showCalc</A></TT> </TD> </TR> <TR> <TD>- C - </TD> <TD><TT><A HREF="#.glint">.glint</A></TT> </TD> <TD><TT><A HREF="#.showErrors">.showErrors</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.cornerMask">.cornerMask</A></TT> </TD> <TD><TT><A HREF="#.glintMax">.glintMax</A></TT> </TD> <TD><TT><A HREF="#.surroundMax">.surroundMax</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.cycleColors">.cycleColors</A></TT> </TD> <TD><TT><A HREF="#.glintMin">.glintMin</A></TT> </TD> <TD><TT><A HREF="#.surroundMin">.surroundMin</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.cycleSpeed">.cycleSpeed</A></TT> </TD> <TD><TT><A HREF="#.glintSpeed">.glintSpeed</A></TT> </TD> <TD>- T - </TD> </TR> <TR> <TD>- D - </TD> <TD><TT><A HREF="#.glintTimeMax">.glintTimeMax</A></TT> </TD> <TD><TT><A HREF="#.thickness">.thickness</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.defXOffset">.defXOffset</A></TT> </TD> <TD><TT><A HREF="#.glintTimeMin">.glintTimeMin</A></TT> </TD> <TD>- U - </TD> </TR> <TR> <TD><TT><A HREF="#.defYOffset">.defYOffset</A></TT> </TD> <TD>- H - </TD> <TD><TT><A HREF="#.underlineColor">.underlineColor</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.doPixmap">.doPixmap</A></TT> </TD> <TD><TT><A HREF="#.hiColor">.hiColor</A></TT> </TD> <TD><TT><A HREF="#.underlineThickness">.underlineThickness</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.dumpRes">.dumpRes</A></TT> </TD> <TD>- L - </TD> <TD><TT><A HREF="#.underlined">.underlined</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.dumpResFile">.dumpResFile</A></TT> </TD> <TD><TT><A HREF="#.label">.label</A></TT> </TD> <TD>- X - </TD> </TR> <TR> <TD><TT><A HREF="#.effectSteps">.effectSteps</A></TT> </TD> <TD><TT><A HREF="#.linger">.linger</A></TT> </TD> <TD><TT><A HREF="#.x">.x</A></TT> </TD> </TR> <TR> <TD>- E - </TD> <TD>- P - </TD> <TD>- Y - </TD> </TR> <TR> <TD><TT><A HREF="#.effect">.effect</A></TT> </TD> <TD><TT><A HREF="#.pixFile">.pixFile</A></TT> </TD> <TD><TT><A HREF="#.y">.y</A></TT> </TD> </TR> <TR> <TD><TT><A HREF="#.expose">.expose</A></TT> </TD> <TD><TT><A HREF="#.pixmapX">.pixmapX</A></TT> </TD> <TD> </TD> </TR> <TR> <TD>- F - </TD> <TD><TT><A HREF="#.pixmapY">.pixmapY</A></TT> </TD> <TD> </TD> </TR> <TR> <TD><TT><A HREF="#.fadeGrad">.fadeGrad</A></TT> </TD> <TD><TT><A HREF="#.placement">.placement</A></TT> </TD> <TD> </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> </BODY> </HTML>