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

   1 .TH XScreenSaver 1 "" "X Version 11"
   2 .SH NAME
   3 tessellimage - Converts an image to triangles using Delaunay tessellation.
   4 .SH SYNOPSIS
   5 .B tessellimage
   6 [\-display \fIhost:display.screen\fP]
   7 [\-visual \fIvisual\fP]
   8 [\-window]
   9 [\-root]
  10 [\-delay \fInumber\fP]
  11 [\-duration \fInumber\fP]
  12 [\-duration2 \fInumber\fP]
  13 [\-max-depth \fInumber\fP]
  14 [\-no-outline]
  15 [\-no-fill-screen]
  16 [\-fps]
  17 .SH DESCRIPTION
  18 Converts an image to triangles using Delaunay tessellation, and animates
  19 the result at various depths. More triangles are allocated to visually
  20 complex parts of the image. This is accomplished by first computing the
  21 first derivative of the image: the distance between each pixel and its
  22 neighbors. Then the Delaunay control points are chosen by selecting those
  23 pixels whose distance value is above a certain threshold: those are the
  24 pixels that have the largest change in color/brightness.
  25 .SH OPTIONS
  26 .TP 8
  27 .B \-visual \fIvisual\fP
  28 Specify which visual to use.  Legal values are the name of a visual class,
  29 or the id number (decimal or hex) of a specific visual.
  30 .TP 8
  31 .B \-window
  32 Draw on a newly-created window.  This is the default.
  33 .TP 8
  34 .B \-root
  35 Draw on the root window.
  36 .TP 8
  37 .B \-delay \fInumber\fP
  38 Per-frame delay, in microseconds.  Default: 30000 (0.03 seconds).
  39 .TP 8
  40 .B \-duration \fInumber\fP
  41 Length of time until loading a new image. Default: 2 minutes.
  42 .TP 8
  43 .B \-duration2 \fInumber\fP
  44 Length of time until increasing or decreasing the triangulation depth.
  45 Default: 0.4 seconds.
  46 .TP 8
  47 .B \-max-depth \fInumber\fP
  48 The maximum number of triangles to render.  Default: 40000.
  49 .TP 8
  50 .B \-outline | \-no-outline
  51 Whether to outline the triangles.
  52 .TP 8
  53 .B \-fill-screen | \-no-fill-screen
  54 Whether to zoom in on the image to completely fill the screen,
  55 or to center it.
  56 .TP 8
  57 .B \-fps | \-no-fps
  58 Whether to show a frames-per-second display at the bottom of the screen.
  59 .SH ENVIRONMENT
  60 .PP
  61 .TP 8
  62 .B DISPLAY
  63 to get the default host and display number.
  64 .TP 8
  65 .B XENVIRONMENT
  66 to get the name of a resource file that overrides the global resources
  67 stored in the RESOURCE_MANAGER property.
  68 .SH SEE ALSO
  69 .BR X (1),
  70 .BR xscreensaver (1)
  71 .SH COPYRIGHT
  72 Copyright \(co 2014 by Jamie Zawinski.  Permission to use, copy, modify,
  73 distribute, and sell this software and its documentation for any purpose is
  74 hereby granted without fee, provided that the above copyright notice appear
  75 in all copies and that both that copyright notice and this permission notice
  76 appear in supporting documentation.  No representations are made about the
  77 suitability of this software for any purpose.  It is provided "as is" without
  78 express or implied warranty.
  79 .SH AUTHOR
  80 Jamie Zawinski.