1glschool(6x) XScreenSaver manual glschool(6x)
2
6 glschool - a 3D schooling simulation
7
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
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 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 It looks best with the highest number of fish that will give you an FPS
28 of > 25 or so.
29
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 --window
37 Draw on a newly-created window. This is the default.
38 --root Draw on the root window.
40 --window-id number
42 Draw on the specified window.
43 --delay number
45 Per-frame delay, in microseconds. Default: 20000 (0.020 sec‐
46 onds.).
47 --wireframe | --no-wireframe
49 Render in wireframe instead of solid.
50 --fps Display the current frame rate, CPU load, and polygon count.
52 --fog | --no-fog
54 Whether to show foggy (cloudy) water.
55 --drawgoal | --no-drawgoal
57 Whether to show the school's attraction goal.
58 --drawbbox | --no-drawbbox
60 Whether to show the bounding box.
61 --fog | --no-fog
63 Whether to show foggy (cloudy) water.
64 --nfish number
66 Number of fish. Defaults to 100
67 --acclimit number
69 Acceleration limit. Defaults to 8.0
70 --minvel number
72 Minimum velocity. Defaults to 1.0
73 --maxvel number
75 Minimum velocity. Defaults to 7.0
76 --goalchgf number
78 Goal change frequency. Defaults to 50 (frames)
79 --avoidfact number
81 Avoidance acceleration factor. Defaults to 1.5
82 --matchfact number
84 Match avg velocity acceleration factor. Defaults to 0.15
85 --centerfact number
87 School centering acceleration factor. Defaults to 0.1
88 --targetfact number
90 Target attraction acceleration factor. Defaults to 80
91 --distexp number
93 Distance weighting exponent. Defaults to 2.2
94 --momentum number
96 Momentum. Defaults to 0.9
97
99 DISPLAY to get the default host and display number.
100 XENVIRONMENT
102 to get the name of a resource file that overrides the global
103 resources stored in the RESOURCE_MANAGER property.
104 XSCREENSAVER_WINDOW
106 The window ID to use with --root.
107
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
122 David C. Lambert
123X Version 11 6.08-1.fc38 (17-Oct-2023) glschool(6x)