Provided by: xscreensaver-gl_5.08-0ubuntu3_i386 bug
 

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]  [-minra-
        dius  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  sec-
                onds.).
 
        -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.
        X(1), xscreensaver(1)
 

COPYRIGHT

        Copyright (C) 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  war-
        ranty.
 

AUTHOR

        David C. Lambert