File: index.html

package info (click to toggle)
xpenguins-applet 1.0-4
links: PTS
area: main
in suites: woody
size: 1,552 kB
ctags: 1,300
sloc: sh: 7,325; ansic: 5,517; makefile: 228; sed: 93
file content (482 lines) | stat: -rw-r--r-- 8,633 bytes
parent folder | download | duplicates (2)
<HTML
><HEAD
><TITLE
>XPenguins Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.52"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>XPenguins Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2001 by <SPAN
CLASS="HOLDER"
>Robin Hogan</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#XPENGUINSAPPLET"
>XPenguins Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="XPENGUINSAPPLET"
>XPenguins Applet</A
></H1
><P
> 
    The <TT
CLASS="APPLICATION"
>XPenguins Applet</TT
>, shown in <A
HREF="index.html#XPENGUINSAPPLET-FIG"
>Figure 1</A
>, sits in a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and when you click the `play' button,
    will animate a number of cute little penguins in your background
    window that fall from the top of the screen, walk along the top of
    windows, up the side of windows, up the side of the screen, and
    sometimes even levitate. If you get bored of penguins, you can
    select an alternative theme such as Turtles.

    To add this applet to a
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, right-click on the
    <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
    <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Amusements</B
>-&gt;<B
CLASS="GUIMENUITEM"
>XPenguins</B
>
    or you can issue this command at a command prompt:
    <B
CLASS="COMMAND"
>xpenguins_applet &#38; </B
>
  </P
><DIV
CLASS="FIGURE"
><A
NAME="XPENGUINSAPPLET-FIG"
></A
><P
><IMG
SRC="xpenguins_applet.png"></P
><P
><B
>Figure 1. XPenguins Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="XPENGUINSAPPLET-USAGE"
>Usage</A
></H2
><P
>      The lower two buttons on the applet can be used to start, stop
      or pause the penguins, and clicking on the larger penguin button
      brings up the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog.
    </P
><P
>      Right-clicking on the applet brings up a menu containing the
      following items:
      <P
></P
><UL
><LI
><P
>          <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
          opens the <A
HREF="index.html#XPENGUINSAPPLET-PREFS"
>          <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
        </P
></LI
><LI
><P
>          <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
          displays this document.
        </P
></LI
><LI
><P
>          <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212; shows basic
          information about <TT
CLASS="APPLICATION"
>XPenguins
          Applet</TT
>, including the applet's version and the
          author's name.
        </P
></LI
></UL
>
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="XPENGUINSAPPLET-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>XPenguins Applet</TT
> by
      right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open
      the <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog (shown in <A
HREF="index.html#XPENGUINSAPPLET-SETTINGS-FIG"
>Figure 2</A
>, which allows you to
      change various settings.
    </P
><P
>      The <SPAN
CLASS="INTERFACE"
>properties dialog box</SPAN
> is divided into
      two sections, one for general options, and one for themes.

      <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>General</DT
><DD
><DIV
CLASS="FIGURE"
><A
NAME="XPENGUINSAPPLET-SETTINGS-FIG"
></A
><P
><IMG
SRC="xpenguins_applet_settings.png"></P
><P
><B
>Figure 2. Properties dialog</B
></P
></DIV
><P
>            The properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
            <P
></P
><UL
><LI
><P
>                  Override theme &#8212; each theme sets a default
                  number and speed for the animations, but you can
                  override this here.
                </P
></LI
><LI
><P
>                  Number of toons &#8212; can be between 1 and 100. 
                </P
></LI
><LI
><P
>                  Frame rate (Hz) &#8212; can be between 1 and 100 frames per
                  second. Beware that trying to update 100 penguins 100 times a
                  second may reduce the responsiveness of the buttons on the
                  applet and the properties dialog.
                </P
></LI
><LI
><P
>                  Ignore popup windows &#8212; if this is selected then the
                  penguins will walk under some transient `popup' windows such
                  as tooltips.
                </P
></LI
><LI
><P
>                  Do not show gory death sequences &#8212; in some
		  themes when the toons die (e.g. when a window is
		  moved over them) the death sequences can be a bit
		  unpleasant.
                </P
></LI
></UL
>
           </P
></DD
><DT
>Themes</DT
><DD
><DIV
CLASS="FIGURE"
><A
NAME="XPENGUINSAPPLET-THEMES-FIG"
></A
><P
><IMG
SRC="xpenguins_applet_themes.png"></P
><P
><B
>Figure 3. Theme selector</B
></P
></DIV
><P
>	    The <TT
CLASS="GUILABEL"
><B
>theme preferences tab</B
></TT
>, shown in
	    <A
HREF="index.html#XPENGUINSAPPLET-THEMES-FIG"
>Figure 3</A
>, has a variety
	    of themes you can choose from. They are found by default
	    in <TT
CLASS="FILENAME"
>/usr/share/xpenguins</TT
>. Note that no
	    themes are provided by
	    <TT
CLASS="APPLICATION"
>xpenguins_applet</TT
> package; you
	    must have the <TT
CLASS="APPLICATION"
>xpenguins</TT
> package
	    for the basic themes. Also get the
	    <TT
CLASS="APPLICATION"
>xpenguins_themes</TT
> package for
	    some juicy extras like The Simpsons and Sonic the
	    Hedgehog.
	  </P
></DD
></DL
></DIV
>
  </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="BUGS"
>Possible Bugs</A
></H2
><P
>&#13;     Normally the <TT
CLASS="APPLICATION"
>XPenguins Applet</TT
> will
     draw to the root X window of your display. If you run the
     Nautilus file manager or the Enlightenment window manager then a
     large `desktop' window may be placed over it, which is drawn to
     instead. Currently the <TT
CLASS="APPLICATION"
>XPenguins
     Applet</TT
> can work with Nautilus 1.0 and Enlightenment
     0.16, although it may not work with future versions of these
     applications.
  </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>   The <TT
CLASS="APPLICATION"
>XPenguins Applet</TT
> was written by
   Robin Hogan (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:R.J.Hogan@reading.ac.uk"
>R.J.Hogan@reading.ac.uk</A
>&#62;</TT
>). The penguin
   images in the default theme were taken from <A
HREF="http://pingus.seul.org"
TARGET="_top"
>Pingus</A
>, a free
   lemmings clone for Linux. You can download more themes from the
   <A
HREF="http://xpenguins.seul.org"
TARGET="_top"
>XPenguins homepage</A
>.
 </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>