git.hungrycats.org Git - xscreensaver/blob - hacks/glx/glcells.man

   1 .TH XScreenSaver 1 "June 2007"
   2 .SH NAME
   3 glcells \- growing cells graphics hack
   4 .SH SYNOPSIS
   5 .B glcells
   6 [\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install]
   7 [\-visual \fIvisual\fP]
   8 [\-delay \fInum\fP] [\-pause \fInum\fP] [\-maxcells \fInum\fP]
   9 [\-radius \fInum\fP] [\-seeds \fInum\fP] [\-quality \fInum\fP]
  10 [\-minfood \fInum\fP] [\-maxfood \fInum\fP] [\-divideage \fInum\fP]
  11 [\-mindist \fInum\fP]
  12 [\-keepold]
  13 [\-wireframe]
  14 [\-fps]
  15 .SH DESCRIPTION
  16 The \fIglcells\fP program draws cells that divide exponentially, eat and eventually die.
  17 .SH OPTIONS
  18 .I glcells
  19 accepts the following options:
  20 .TP 8
  21 .B \-window
  22 Draw on a newly-created window.  This is the default.
  23 .TP 8
  24 .B \-root
  25 Draw on the root window.
  26 .TP 8
  27 .B \-install
  28 Install a private colormap for the window.
  29 .TP 8
  30 .B \-visual \fIvisual\fP\fP
  31 Specify which visual to use.  Legal values are the name of a visual class,
  32 or the id number (decimal or hex) of a specific visual.
  33 .TP 8
  34 .B \-pause \fInum\fP\fP
  35 Specifies the pause at the end of the animation (all cells dead or maximum amount of cells reached). Unit is in frames, default 20.
  36 .TP 8
  37 .B \-maxcells \fInum\fP\fP
  38 Specifies the maximum number of cells on screen (dead cells also count, even if invisible). Default is 800.
  39 .TP 8
  40 .B \-radius \fInum\fP\fP
  41 Specifies the radius of the cells. Default is 40.
  42 .TP 8
  43 .B \-seeds \fInum\fP\fP
  44 Specifies the number of cells when animation starts. Default is 1.
  45 .TP 8
  46 .B \-quality \fInum\fP\fP
  47 Specifies subdivision quality of the spheres used to draw the cells [0...5]. Default is 3.
  48 .TP 8
  49 .B \-minfood \fInum\fP\fP
  50 Food is ditributed randomly on the screen (Yes, the cells need to eat). This parameter specifies the
  51 minimum amount of food per pixel. Default is 5.
  52 .TP 8
  53 .B \-maxfood \fInum\fP\fP
  54 Food is ditributed randomly on the screen (Yes, the cells need to eat). This parameter specifies the
  55 maximum amount of food per pixel. Default is 20.
  56 .TP 8
  57 .B \-divideage \fInum\fP\fP
  58 Specifies the minimum age in frames a cell needs to have before beeing able to divide. Default is 20
  59 .TP 8
  60 .B \-mindist \fInum\fP\fP
  61 Specifies the minimum distance between cells. Default 1.4
  62 .TP 8
  63 .B \-delay \fInum\fP
  64 How long to pause between frames.  Default is 20000, or 0.02 second.
  65 .TP 8
  66 .B \-fps
  67 Display a running tally of how many frames per second are being rendered.
  68 In conjunction with \fB\-delay 0\fP, this can be a useful benchmark of
  69 your GL performance.
  70 .TP 8
  71 .B \-wireframe
  72 Draw wireframe only.
  73 .TP 8
  74 .B \-keepold
  75 Dead cells stay on screen.
  76 .SH ENVIRONMENT
  77 .PP
  78 .TP 8
  79 .B DISPLAY
  80 to get the default host and display number.
  81 .TP 8
  82 .B XENVIRONMENT
  83 to get the name of a resource file that overrides the global resources
  84 stored in the RESOURCE_MANAGER property.
  85 .SH SEE ALSO
  86 .BR X (1),
  87 .BR xscreensaver (1)
  88 .BR xscreensaver\-demo (1),
  89 .SH COPYRIGHT
  90 Copyright \(co 2007 by Matthias Toussaint.  Permission to use, copy, modify,
  91 distribute, and sell this software and its documentation for any purpose is
  92 hereby granted without fee, provided that the above copyright notice appear
  93 in all copies and that both that copyright notice and this permission notice
  94 appear in supporting documentation.  No representations are made about the
  95 suitability of this software for any purpose.  It is provided "as is" without
  96 express or implied warranty.
  97 .SH AUTHOR
  98 Matthias Toussaint <glcells@mtoussaint.de>, 17-Jun-2007.
  99