glschool(6)

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