1glschool(6x)                  XScreenSaver manual                 glschool(6x)
2
3
4

NAME

6       glschool - a 3D schooling simulation
7

SYNOPSIS

9       glschool  [--display  host:display.screen] [--visual visual] [--window]
10       [--root] [--window-id number] [--wireframe]  [--fps]  [--delay  number]
11       [--nfish  number]  [--maxvel number] [--minvel number] [--acclimit num‐
12       ber] [--avoidfact number] [--matchfact  number]  [--centerfact  number]
13       [--targetfact number] [--minradius number] [--momentum number] [--dist‐
14       exp number] [--goalchgf number] [--fog] [--drawgoal] [--drawbbox]
15

DESCRIPTION

17       Uses the Craig Reynolds Boids algorithm to  simulate  a  3D  school  of
18       fish.   This  is  a lightly modified version of the algorithm that sup‐
19       ports goal attraction.
20
21       Many different behaviors are possible by tweaking the  parameters.   No
22       sanity checking is performed on the command line params, so if you want
23       to use negative accelerations or minimum velocity that is  larger  than
24       maximum  velocity or that sort of thing, the simulation will try to di‐
25       gest it.
26
27       It looks best with the highest number of fish that will give you an FPS
28       of > 25 or so.
29

OPTIONS

31       --visual visual
32               Specify  which  visual  to use.  Legal values are the name of a
33               visual class, or the id number (decimal or hex) of  a  specific
34               visual.
35
36       --window
37               Draw on a newly-created window.  This is the default.
38
39       --root  Draw on the root window.
40
41       --window-id number
42               Draw on the specified window.
43
44       --delay number
45               Per-frame  delay,  in microseconds.  Default: 20000 (0.020 sec‐
46               onds.).
47
48       --wireframe | --no-wireframe
49               Render in wireframe instead of solid.
50
51       --fps   Display the current frame rate, CPU load, and polygon count.
52
53       --fog | --no-fog
54                Whether to show foggy (cloudy) water.
55
56       --drawgoal | --no-drawgoal
57                Whether to show the school's attraction goal.
58
59       --drawbbox | --no-drawbbox
60                Whether to show the bounding box.
61
62       --fog | --no-fog
63                Whether to show foggy (cloudy) water.
64
65       --nfish number
66               Number of fish.  Defaults to 100
67
68       --acclimit number
69               Acceleration limit.  Defaults to 8.0
70
71       --minvel number
72               Minimum velocity.  Defaults to 1.0
73
74       --maxvel number
75               Minimum velocity.  Defaults to 7.0
76
77       --goalchgf number
78               Goal change frequency.  Defaults to 50 (frames)
79
80       --avoidfact number
81               Avoidance acceleration factor.  Defaults to 1.5
82
83       --matchfact number
84               Match avg velocity acceleration factor.  Defaults to 0.15
85
86       --centerfact number
87               School centering acceleration factor.  Defaults to 0.1
88
89       --targetfact number
90               Target attraction acceleration factor.  Defaults to 80
91
92       --distexp number
93               Distance weighting exponent.  Defaults to 2.2
94
95       --momentum number
96               Momentum.  Defaults to 0.9
97

ENVIRONMENT

99       DISPLAY to get the default host and display number.
100
101       XENVIRONMENT
102               to get the name of a resource file that  overrides  the  global
103               resources stored in the RESOURCE_MANAGER property.
104
105       XSCREENSAVER_WINDOW
106               The window ID to use with --root.
107

SEE ALSO

109       X(1), xscreensaver(1),
110       https://www.red3d.com/cwr/boids
111
113       Copyright  ©  2005-2006  by David C. Lambert.  Permission to use, copy,
114       modify, distribute, and sell this software and  its  documentation  for
115       any  purpose  is  hereby  granted  without fee, provided that the above
116       copyright notice appear in all copies and that both that copyright  no‐
117       tice and this permission notice appear in supporting documentation.  No
118       representations are made about the suitability of this software for any
119       purpose.  It is provided "as is" without express or implied warranty.
120

AUTHOR

122       David C. Lambert
123
124
125
126X Version 11               6.08-1.fc38 (17-Oct-2023)              glschool(6x)
Impressum