
 How to install Sherman's aquarium as a Xscreensaver hack
==========================================================

First make sure that you have libSDL 1.2.x (www.libsdl.org) and
xscreensaver (www.jwz.org/xscreensaver) and that you have compiled
Sherman's aquarium with fullscreen support.

(The rest of the text in this file assumes that you have a 
working xscreensaver installation.)

Then try:
sherman -l -K

(If you have sherman's aquarium in your path)
This will show you sherman's aquarium in fullscreen mode.


Experiment with command line options until you get a configuration
that you like.
Notice that all command line options overrides saved preferences, and
that the command line options are not saved as default preferneces.
(This is only true if you compiled Sherman's aquarium with Gnome support.)
So you can have Sherman's aquarium configured for suiting a gnome applet
and give command line options for suiting as xscreensaver.

Interesting options for fullscreen mode are:
 -f			Have a sea floor
 -s X			Size of fish in %.
 -n X			Number of fish
 -b X			Background type (1=solid color, 2=shaded blue, 
			3=Wateralike)  
 -bf <file>		Background image.
 
Find some settings that you like. Notice that you have to run Sherman's
aquarium a couple of seconds atleast before you quite, if you want that
the frames per second calculation is more or less correct. 

I have an old Pentium II, 300MHz with a TNT2 MX(the diet version of TNT2) 
and it preformes good with size 50% and 40 fish in 1024x768, 24 bits.

Then go on and edit ~/.xscreensaver (Generated by xscreensaver-demo)

Find the line "programs:"
Insert after that line a new line that says:
"Sherman's aquarium" sherman -xscreensaver [your options] \n\
But without the options -l and -K! That is important.
Example:
"Sherman's aquarium"  sherman --xscreensaver -f                   \n\

Save the changes.
Then run xscreensaver-demo, configure xscreeensaver and then restart 
the xscreensaver daemon.

Notice that "Sherman's aquarium" can't be configured from xscreensaver-demo
and that you can't use a grabbed image as background. 
Use sherman -p instead to start the preference window. (If you have compiled
it with gnome.)

Any questions? Mail then to Jonas Aaberg <cja@gmx.net>






 


