git.hungrycats.org Git - xscreensaver/blob - hacks/cloudlife.man

   1 .TH XScreenSaver 6 "20-May-2003" "X Version 11"
   2 .SH NAME
   3 cloudlife - a cellular automaton based on Conway's Life
   4 .SH SYNOPSIS
   5 .B cloudlife
   6 [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-cycle-delay \fImicroseconds\fP] [\-cycle-colors \fIinteger\fP][\-cell-size \fIinteger\fP] [\-initial-density \fIinteger\fP] [\-max-age \fIinteger\fP]
   7
   8 [\-fps]
   9 .SH DESCRIPTION
  10 The \fIcloudlife\fP program draws a cellular
  11 automaton based on Conway's Life, except that
  12 cells have a maximum age, and only one pixel per
  13 cell is drawn every tick.
  14 .SH OPTIONS
  15 .I cloudlife
  16 accepts the following options:
  17 .TP 8
  18 .B \-window
  19 Draw on a newly-created window.  This is the default.
  20 .TP 8
  21 .B \-root
  22 Draw on the root window.
  23 .TP 8
  24 .B \-mono
  25 If on a color display, pretend we're on a monochrome display.
  26 .TP 8
  27 .B \-install
  28 Install a private colormap for the window.
  29 .TP 8
  30 .B \-visual \fIvisual\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 \-cycle-delay \fIinteger\fP
  35 Time in microseconds to sleep between ticks.  Default 25000.
  36 .TP 8
  37 .B \-cycle-colors \fIinteger\fP
  38 How many ticks should elapse between cycling colors.  0 to disable
  39 color cycling.  Default 2.
  40 .TP 8
  41 .B \-ncolors \fIinteger\fP
  42 How many colors should be used (if possible).  Default 64.
  43 The colors are chosen randomly.
  44 .TP 8
  45 .B \-cell-size \fIinteger\fP
  46 Size of each cell, in powers of 2.  Default 3 (8-pixel cells).
  47 .TP 8
  48 .B \-initial-density \fIinteger\fP
  49 Percentage of cells that are alive at start and when the
  50 field is repopulated.  Default 30.
  51 .TP 8
  52 .B \-max-age \fIinteger\fP
  53 Maximum age for a cell.  Default 64.
  54 .TP 8
  55 .B \-fps
  56 Display the current frame rate and CPU load.
  57 .SH ENVIRONMENT
  58 .PP
  59 .TP 8
  60 .B DISPLAY
  61 to get the default host and display number.
  62 .TP 8
  63 .B XENVIRONMENT
  64 to get the name of a resource file that overrides the global resources
  65 stored in the RESOURCE_MANAGER property.
  66 .SH SEE ALSO
  67 .BR X (1),
  68 .BR xscreensaver (1),
  69 .BR xlock (1)
  70 .SH COPYRIGHT
  71
  72 Copyright \(co 2003 by Don Marti.  Based on
  73 examples from the hacks directory of xscreensaver,
  74 Copyright (c) 1997, 1998, 2002 Jamie Zawinski
  75 <jwz@jwz.org>
  76
  77 This man page based on the man page of sierpinski,
  78 Copyright \(co 1996 by Desmond Daignault.
  79
  80 Permission to use, copy, modify, and distribute this software and its
  81 documentation for any purpose and without fee is hereby granted,
  82 provided that the above copyright notice appear in all copies and that
  83 both that copyright notice and this permission notice appear in
  84 supporting documentation.
  85 .SH AUTHOR
  86 Don Marti <dmarti@zgp.org> 20 May 2003.
  87