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

   1 .TH XScreenSaver 1 "" "X Version 11"
   2 .SH NAME
   3 mirrorblob - Draws a wobbly blob that distorts the image behind it.
   4 .SH SYNOPSIS
   5 .B mirrorblob
   6 [\-display \fIhost:display.screen\fP]
   7 [\-visual \fIvisual\fP]
   8 [\-window]
   9 [\-root]
  10 [\-wire]
  11 [\-delay \fInumber\fP]
  12 [\-fog]
  13 [\-walls]
  14 [\-colour]
  15 [\-texture]
  16 [\-offset_texture]
  17 [\-blend]
  18 [\-antialias]
  19 [\-x_res \fInumber\fP]
  20 [\-y_res \fInumber\fP]
  21 [\-field_points \fInumber\fP]
  22 [\-fade_time \fInumber\fP]
  23 [\-hold_time \fInumber\fP]
  24 [\-fps]
  25 .SH DESCRIPTION
  26 Draws a wobbling blob, making use of alpha blending, fog,
  27 textures, and lighting, plus a ``frames per second'' meter so that you can
  28 tell how fast your graphics card is... Requires OpenGL.
  29 .SH OPTIONS
  30 .TP 8
  31 .B \-visual \fIvisual\fP
  32 Specify which visual to use.  Legal values are the name of a visual class,
  33 or the id number (decimal or hex) of a specific visual.
  34 .TP 8
  35 .B \-window
  36 Draw on a newly-created window.  This is the default.
  37 .TP 8
  38 .B \-root
  39 Draw on the root window.
  40 .B \-wire
  41 Render in wireframe instead of solid.
  42 .TP 8
  43 .B \-delay \fInumber\fP
  44 Per-frame delay, in microseconds.  Default: 10000 (0.01 seconds.).
  45 .TP 8
  46 .B \-fog | \-no-fog
  47 Whether to enable fog.
  48 .TP 8
  49 .B \-walls | \-no-walls
  50 Add walls for blob to hit.
  51 .TP 8
  52 .B \-colour | \-no-colour
  53 Draw coloured blob.  If also textured, the texture will have color mixed in.
  54 .TP 8
  55 .B \-texture | \-no-texture
  56 Whether to wrap a texture image on the blob.
  57 .TP 8
  58 .B \-offset_texture | \-no-offset_texture
  59 Whether to ofset the texture calculations to only use a region of the image
  60  under the blob.  This works well when blend is enabled.
  61 .TP 8
  62 .B \-blend | \-no-blend
  63 Whether to enable blending. (see also offset_texture above)
  64 .TP 8
  65 .B \-antialias | \-no-antialias
  66 Whether to anti-alias lines.
  67 .TP 8
  68 .B \-x_res \fInumber\fP
  69 Number of verticies around the middle row of the blob (see also y_res).
  70 .TP 8
  71 .B \-y_res \fInumber\fP
  72 Number of rows of verticies used to calculatethe blob, combined with x_res to
  73  indirectly determine the number of triangles used to draw blob.  Larger
  74  numbers give a smoother blob but increase calculation times exponentially.
  75 .TP 8
  76 .B \-field_points \fInumber\fP
  77 Number of points used to distort the blob.
  78 .TP 8
  79 .B \-hold_time \fInumber\fP
  80 Time until loading a new image.
  81 .TP 8
  82 .B \-fade_time \fInumber\fP
  83 Crossfade duration time.
  84 .TP 8
  85 .B \-fps | \-no-fps
  86 Whether to show a frames-per-second display at the bottom of the screen.
  87 .SH ENVIRONMENT
  88 .PP
  89 .TP 8
  90 .B DISPLAY
  91 to get the default host and display number.
  92 .TP 8
  93 .B XENVIRONMENT
  94 to get the name of a resource file that overrides the global resources
  95 stored in the RESOURCE_MANAGER property.
  96 .SH SEE ALSO
  97 .BR X (1),
  98 .BR xscreensaver (1)
  99 .SH COPYRIGHT
 100 Copyright \(co 2003 by Jon Dowdall.  Permission to use, copy, modify,
 101 distribute, and sell this software and its documentation for any purpose is
 102 hereby granted without fee, provided that the above copyright notice appear
 103 in all copies and that both that copyright notice and this permission notice
 104 appear in supporting documentation.  No representations are made about the
 105 suitability of this software for any purpose.  It is provided "as is" without
 106 express or implied warranty.
 107 .SH AUTHOR
 108 Jon Dowdall.