Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
xpenguins(1)
Edit
PageHistory
Diff
Info
LikePages
XPenguins !!!XPenguins NAME SYNOPSIS DESCRIPTION OPTIONS THEMES AUTHOR CREDITS NOTES BUGS FILES SEE ALSO ---- !!NAME xpenguins - cute little penguins that walk along the tops of your windows !!SYNOPSIS __xpenguins__ [[-option ...] !!DESCRIPTION ''XPenguins'' is a program for animating cute cartoons/animals in your root window. By default it will be penguins - they drop in from the top of the screen, walk along the tops of your windows, up the side of your windows, levitate, skateboard, and do other similarly exciting things. Be careful when you move windows as the little guys squash easily. If you send the program an interupt signal (such as by hitting Ctrl-C) they will burst. ''XPenguins'' is now themeable, so it is easy to select something else to animate instead of penguins, or even (with a little artistic talent) define your own; see the __THEMES__ section below. !!OPTIONS In all the following cases a double dash can be replaced by a single dash. __-a, --no-angels__ Do not show any cherubim flying up to heaven when a toon gets squashed. __-b, --no-blood__ Do not show any gory death sequences. __-c__ ''dir''__, --config-dir__ ''dir'' Look for config files and themes in this directory. The default is usually ''/usr/share/xpenguins''. __-d__ ''display''__, --display__ ''display'' Send the toons to the specified X display. In the absence of this option, the display specified by the __DISPLAY__ environment variable is used. __-h, --help__ Print out a message describing the available options. __-i, --theme-info__ Print out the auxiliary information about a theme and exit. Use the __-t__ option to select the theme to describe. __-l, --list-themes__ List the available themes, one on each line, and exit. __-m__ ''delay''__, --delay__ ''delay'' Set the delay between each frame in milliseconds. The default is defined by the theme. __-n__ ''number''__, --penguins__ ''number'' The number of toons to start, up to a maximum of 256. The default is defined by the theme. __-p, --ignorepopups__ Toons fall through `popup' windows (those with the save-under attribute set), such as tooltips. Note that this also includes the KDE panel. __-r, --rectwin__ Toons regard all windows as rectangular. This option results in faster calculation of window positions, but if you use one of those fancy new window managers with shaped windows then your toons might sometimes look like they're walking on thin air. __-s, --squish__ Enable the penguins to be squished using any of the mouse buttons. Note that this disables any existing function of the mouse buttons on the root window. __-t__ ''theme''__, --theme__ ''theme'' Use the named theme. The default is __Penguins__. If the theme has spaces in its name then you can use underscores instead, or alternatively just put the name in double quotes. This option can be called multiple times to run several themes simultaneously. __-q, --quiet__ Suppress the exit message when an interupt is received. __-v, --version__ Print out the current version number and quit. __--all__ Load all available themes and run them simultaneously. __--id__ ''window'' Send toons to the window with this ID, instead of the root window or whichever window is appropriate for the current desktop environment. Note that the ID of X clients reported by ''xwininfo'' is rarely that of the foremost visible window that should be used here. __--nice__ ''loadaverage1 loadaverage2'' Start killing toons when the 1-min averaged system load exceeds ''loadaverage1''; when it exceeds ''loadaverage2'' kill them all. The toons will reappear when the load average comes down. The load is checked every 5 seconds by looking in ''/proc/loadavg'', so this option only works under unices that implement this particular pseudo file (probably just Linux). When there are no toons on the screen, ''XPenguins'' uses only a miniscule amount of CPU time - it just wakes up every 5 seconds to recheck the load. !!THEMES The system themes are usually kept in ''/usr/share/xpenguins/themes'', and these can be augmented or overridden by the user's themes in ''$HOME/.xpenguins/themes''. Each theme has its own subdirectory which to be valid must contain a file called ''config''. The name of the theme is taken from the directory name, although because many install scripts choke on directory names containing spaces, all spaces in a theme name are represented in the directory name by underscores. Any directory name containing spaces is inaccessible by ''xpenguins''. In addition to the ''config'' file, the theme directory contains the toon images that make up the theme in the form of ''xpm image files''. Additionally, there should be an ''about'' file which gives information on the creator of the theme, the license under which it is distributed and various other things. This file is principally for use by ''xpenguins_applet'', an applet for ''GNOME'' that allows different themes to be selected at the click of a button. The ''config'' file has a reasonably straightforward format. You can either read this rather terse description of it or you can have a look at the config file for the default __Penguins__ theme, which is usually installed at ''/usr/share/xpenguins/themes/Penguins/config'', and is reasonably well commented. We'll first establish some simple terminology. Say you have a Farmyard theme with cows and sheep. The cows and sheep are types of __toon__, while the various things they get up to (walking, mooing and so on) are termed __activities__. Each __activity__ has its own ''xpm image file'', in which the __frames__ of the animation are laid out horizontally. Some activities (notably walking) use different images depending on the __direction__ the toon is moving in. In this case the frames for the two directions are laid out one above the other in the image. As in shell scripts, comments are initiated with the __#__ character and hide the remainder of the line. The format is entirely free except that there is an arbitrary limit on the length of a line of 512 characters. Spaces, tabs and newlines all count equally as white space. Data is entered as a sequence of __key value__ pairs, all separated by white space. Neither the __keys__ nor the __values__ are case sensitive, except where the __value__ is a filename. The following __keys__ are understood: __delay__ ''delay'' Set the recommended delay between frames in milliseconds. __toon__ ''toon'' Begin defining a new toon called ''toon''. If only one type of toon is present in the theme then this key may be omitted. __number__ ''number'' Set the default number of toons of the current type to start. __define__ ''activity'' Begin defining an ''activity'' for the current toon. The currently understood activities are __walker__, __faller__, __tumbler__, __climber__, __floater__, __runner__, __explosion__, __squashed__, __zapped__, __splatted__, __angel__, __exit__ and __action?__, where __?__ is a number between __0__ and __6__. Once you've seen the program in action you should be able to guess which is which. A valid theme must contain at least __walkers__ and __fallers__. Additionally, you may define a default activity (with __define default__); any properties (such as __width__ and __speed__) set here are then adopted by the activities defined from then on, if they do not themselves explicitly define those properties. After an activity has been declared with __define__, the following properties may be assigned: __pixmap__ ''xpmfile'' The file containing the image data for the activity. Note that you may not set a __default__ pixmap. __width__ ''width'' The width of each frame of the animation in pixels. __height__ ''height'' The height of each frame of the animation in pixels. __frames__ ''frames'' The number of frames in the animation. __directions__ ''directions'' The number of directions for the activity (can be 1 or 2). __speed__ ''speed'' The initial speed of the toon when engaged in this activity, in pixels per frame. __acceleration__ ''acceleration'' The rate at which the speed increases, in pixels per frame squared. This property is not utilised by all activities. __terminal_velocity__ ''terminal_velocity'' The maximum speed in pixels per frame, again not utilised by all activities. __loop__ ''loop'' Only understood by the __actions__; indicates how many times to repeat the action. If negative, then the probility of stopping the action every time the action is complete is -1/''loop''. Some notes regarding the various activities. If you design a new theme, feel free to make the __splatted__, __squashed__, __zapped__ and __exit__ animations as gory and bloody as you like, but please keep the __explosion__ activity nice and tame; that way those of a nervous disposition can employ the __--no-blood__ option which replaces all these violent deaths with a tasteful explosion that wouldn't offend your grandmother. Xpm images files are a factor of two smaller if you can limit the number of colours in the image such that only one character need be used to represent each colour; this also makes ''XPenguins'' start up much more rapidly. Rarely are more than 64 colours required. So that's about it for the ''config'' file, now for the ''about'' file. This is very simple. Again comments are initialised by a __#__. An entry consists of a __key__ at the start of a line, followed by the corresponding __value__ which is read up to the next newline. The following __keys__ are understood, although none are compulsory. __artist__ Used to list the artist(s) who created the original images. __maintainer__ The person who compiled the images into an ''XPenguins'' theme. It is useful if an email address can also be provided. __date__ The date when the theme was last modified. My preferred format is ''day of the month'', ''name of the month in english'', ''full year''. For example: 24 April 2001. __icon__ The name of an image file that can be used as an icon for the theme; XPM and PNG are suitable formats. __license__ The name of the license under which the theme is distributed (e.g. GPL). __copyright__ The year and holder of the copyright. __comment__ Any other essential information, such as the theme's web site, as brief as possible. Please test any ''about'' files you create by looking at how the information is displayed by the ''xpenguins_applet'' program. !!AUTHOR Robin Hogan !!CREDITS Inspiration provided by Rick Jansen xsnow''. Most penguin images were taken from ''Pingus'', a free lemmings clone that can be found at '' !!NOTES ''XPenguins'' can load an X server and/or network (although the CPU time used is small), and if a large number of penguins are spawned then they may begin to flicker, depending on the speed of the X server. The ''xpenguins'' homepage is located at: http://xpenguins.seul.org/ !!BUGS A new feature since version 2.1 is the ability to draw to windows other than the root window in situations where the window manager or desktop environment places a large window over the root window that would otherwise obscure the toons. Currently ''XPenguins'' can draw to the KDE Desktop (KDE 2.0 and 2.1), Enlightenment desktops greater than 0 (E16), the Nautilus desktop and the virtual root window of certain window managers like amiwm. Of course, simpler window managers that don't mess around like this will still work (sawfish, blackbox and countless others). It cannot work with CDE and probably never will. Future versions of KDE, Enlightenment and Nautilus may not work; the classic symptom of this is that ''XPenguins'' sits there as if it's doing something, but no toons are visible. If this happens, try running the program with one of the simpler window manager listed above, or visit the ''XPenguins'' web site and download the latest version. If there are icons drawn on the root window then the toons will erase them when they walk over them, although an expose event will be sent to the window every 100 frames to redraw them. !!FILES $HOME/.xpenguins/themes/* /usr/share/xpenguins/themes/* /proc/loadavg !!SEE ALSO xsnow(1), xroach(1), xwininfo(1) pingus(6) ----
One page links to
xpenguins(1)
:
Man1x
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
