glschool
Section: XScreenSaver manual (6x)
Updated: 6.00-1.fc34 (02-Apr-2021)
Page Index
NAME
glschool - a 3D schooling simulation
SYNOPSIS
glschool
[-display
host:display.screen]
[-visual
visual]
[-window]
[-root]
[-wireframe]
[-fps]
[-delay
number]
[-nfish
number]
[-maxvel
number]
[-minvel
number]
[-acclimit
number]
[-avoidfact
number]
[-matchfact
number]
[-centerfact
number]
[-targetfact
number]
[-minradius
number]
[-momentum
number]
[-distexp
number]
[-goalchgf
number]
[-fog]
[-drawgoal]
[-drawbbox]
DESCRIPTION
Uses Craig Reynolds Boids algorithm to simulate a 3d school of
fish. See <
http://www.red3d.com/cwr/boids> for a description
of the algorithm and the original paper. This is a lightly modified
version of the algorithm that supports goal attraction.
Many different behaviors are possible by tweaking the parameters. No sanity checking is performed
on the command line params, so if you want to use negative accelerations or minimum velocity that is
larger than maximum velocity or that sort of thing, the simulation will try to digest it.
It looks best with the highest number of fish that will give you an FPS of > 25 or so.
OPTIONS
- -visual visual
-
Specify which visual to use. Legal values are the name of a visual class,
or the id number (decimal or hex) of a specific visual.
- -window
-
Draw on a newly-created window. This is the default.
- -root
-
Draw on the root window.
- -delay number
-
Per-frame delay, in microseconds. Default: 20000 (0.020 seconds.).
- -wireframe | -no-wireframe
-
Render in wireframe instead of solid.
- -fps
-
Display the current frame rate, CPU load, and polygon count.
- -fog | -no-fog
-
Whether to show foggy (cloudy) water.
- -drawgoal | -no-drawgoal
-
Whether to show the school's attraction goal.
- -drawbbox | -no-drawbbox
-
Whether to show the bounding box.
- -fog | -no-fog
-
Whether to show foggy (cloudy) water.
- -nfish number
-
Number of fish. Defaults to 100
- -acclimit number
-
Acceleration limit. Defaults to 8.0
- -minvel number
-
Minimum velocity. Defaults to 1.0
- -maxvel number
-
Minimum velocity. Defaults to 7.0
- -goalchgf number
-
Goal change frequency. Defaults to 50 (frames)
- -avoidfact number
-
Avoidance acceleration factor. Defaults to 1.5
- -matchfact number
-
Match avg velocity acceleration factor. Defaults to 0.15
- -centerfact number
-
School centering acceleration factor. Defaults to 0.1
- -targetfact number
-
Target attraction acceleration factor. Defaults to 80
- -distexp number
-
Distance weighting exponent. Defaults to 2.2
- -momentum number
-
Momentum. Defaults to 0.9
ENVIRONMENT
- DISPLAY
-
to get the default host and display number.
- XENVIRONMENT
-
to get the name of a resource file that overrides the global resources
stored in the RESOURCE_MANAGER property.
SEE ALSO
X(1),
xscreensaver(1)
COPYRIGHT
Copyright © 2005-2006 by David C. Lambert. Permission to use, copy, modify,
distribute, and sell this software and its documentation for any purpose is
hereby granted without fee, provided that the above copyright notice appear
in all copies and that both that copyright notice and this permission notice
appear in supporting documentation. No representations are made about the
suitability of this software for any purpose. It is provided "as is" without
express or implied warranty.
AUTHOR
David C. Lambert