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] [-wireframe] [-fps] [-delay number]  [-nfish  number]  [-maxvel
11       number]   [-minvel   number]  [-acclimit  number]  [-avoidfact  number]
12       [-matchfact number] [-centerfact number] [-targetfact number]  [-minra‐
13       dius  number]  [-momentum  number] [-distexp number] [-goalchgf number]
14       [-fog] [-drawgoal] [-drawbbox]
15

DESCRIPTION

17       Uses Craig Reynolds Boids algorithm to simulate a 3d  school  of  fish.
18       See <http://www.red3d.com/cwr/boids> for a description of the algorithm
19       and the original paper.  This is a  lightly  modified  version  of  the
20       algorithm that supports goal attraction.
21
22       Many  different  behaviors are possible by tweaking the parameters.  No
23       sanity checking is performed on the command line params, so if you want
24       to  use  negative accelerations or minimum velocity that is larger than
25       maximum velocity or that sort of thing,  the  simulation  will  try  to
26       digest it.
27
28       It looks best with the highest number of fish that will give you an FPS
29       of > 25 or so.
30
31

OPTIONS

33       -visual visual
34               Specify which visual to use.  Legal values are the  name  of  a
35               visual  class,  or the id number (decimal or hex) of a specific
36               visual.
37
38       -window Draw on a newly-created window.  This is the default.
39
40       -root   Draw on the root window.
41
42       -delay number
43               Per-frame delay, in microseconds.  Default: 20000  (0.020  sec‐
44               onds.).
45
46       -wireframe | -no-wireframe
47               Render in wireframe instead of solid.
48
49       -fps | -no-fps
50               Whether  to  show  a frames-per-second display at the bottom of
51               the screen.
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

SEE ALSO

106       X(1), xscreensaver(1)
107
109       Copyright  ©  2005-2006  by David C. Lambert.  Permission to use, copy,
110       modify, distribute, and sell this software and  its  documentation  for
111       any  purpose  is  hereby  granted  without fee, provided that the above
112       copyright notice appear in all copies  and  that  both  that  copyright
113       notice  and  this permission notice appear in supporting documentation.
114       No representations are made about the suitability of this software  for
115       any  purpose.   It  is provided "as is" without express or implied war‐
116       ranty.
117

AUTHOR

119       David C. Lambert
120
121
122
123X Version 11                 5.05-3 (06-Apr-2008)                 glschool(6x)
Impressum