[xscreensaver] / local / man / cat.1 / xscreensaver-demo.1

XScreenSaver(1)                                   XScreenSaver(1)


N\bNA\bAM\bME\bE
       xscreensaver-demo  -  interactively control the background
       xscreensaver daemon

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
       x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br-\b-d\bde\bem\bmo\bo [-display _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn]  [-prefs]
       [-xrm _\br_\be_\bs_\bo_\bu_\br_\bc_\be_\bs]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
       The _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo program is a graphical front-end for
       setting the parameters used  by  the  background  x\bxs\bsc\bcr\bre\bee\ben\bn-\b-
       s\bsa\bav\bve\ber\br(1) daemon.  It is essentially two things: a tool for
       editing the _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br file; and a tool  for  demoing
       the  various  graphics  hacks that the _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br daemon
       will launch.

       The main dialog box contains  a  scrolling  list,  a  text
       field, and a number of buttons.

       Double-clicking  on  one  of the programs in the list will
       run it.  The screen will go black, and  the  program  will
       run  in full-screen mode, just as it would if the _\bx_\bs_\bc_\br_\be_\be_\bn_\b-
       _\bs_\ba_\bv_\be_\br daemon had launched it.  Clicking  the  mouse  again
       will  stop  the  demo  and un-blank the screen, making the
       dialog box visible again.

       Single-clicking in the list will place the indicated  pro-
       gram  and  its  args in the text field to be edited.  Edit
       the arguments and hit return to run the program  with  the
       parameters  you  have specified.  This will also save your
       changes to your _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br file: so any  changes  you
       make in this way are persistent.

       If  one of the lines in the scrolling list begins with the
       character "-", then that means that the  program  is  dis-
       abled:  _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br  will not select it to be run (though
       you can still try it out by clicking on it.)  Rather  than
       just  deleting  the  programs  you  don't want to run, you
       might want to disable them in this way  instead,  so  that
       you can more easily change your mind later.

       If  the line begins with the name of a visual, followed by
       a colon, then that program will only be run on  that  kind
       of visual.  For example, you can specify that a particular
       program should only be run  if  color  is  available,  and
       another should only be run in monochrome.  See the discus-
       sion of the _\bp_\br_\bo_\bg_\br_\ba_\bm_\bs parameter in the  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn  sec-
       tion of the x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1) manual.

       The buttons are:

       R\bRu\bun\bn N\bNe\bex\bxt\bt
               Clicking  this button will run the next program in
               the list after  the  currently-selected  one,  and



X Version 11             20-Jun-99 (3.15)                       1





XScreenSaver(1)                                   XScreenSaver(1)


               will  wrap  around  to the top when it reaches the
               bottom.

       R\bRu\bun\bn P\bPr\bre\bev\bvi\bio\bou\bus\bs
               Opposite of Run Next; at the top, it wraps  around
               to the bottom.

       P\bPr\bre\bef\bfe\ber\bre\ben\bnc\bce\bes\bs
               This  pops  up  a  second dialog box, in which you
               have the option to interactively  change  most  of
               the  screensaver's operational parameters, such as
               its timeouts,  and  whether  it  should  lock  the
               screen.   When  you click OK, your chosen settings
               will take effect immediately,  and  will  also  be
               saved  to  the  _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br  file in your home
               directory, so that the settings will persist  next
               time.

       Q\bQu\bui\bit\bt    Exits  the  _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo  program.  The back-
               ground _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br daemon will  continue  running
               as before.

       The  Preferences  dialog box lets you change the following
       settings.

       (There are more settings available, but these are the most
       commonly used ones; see the manual for x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1) for
       other  parameters  that  can  be  set   by   editing   the
       _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br file, or the X resource database.)

       S\bSa\bav\bve\ber\br T\bTi\bim\bme\beo\bou\but\bt
               After  the  user  has  been  idle  this  long, the
               _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br daemon will blank the screen.

       C\bCy\byc\bcl\ble\be T\bTi\bim\bme\beo\bou\but\bt
               After the screensaver has been  running  for  this
               long,  the currently running graphics demo will be
               killed, and a new one started.  If this is 0, then
               the  graphics demo will never be changed: only one
               demo will run until the screensaver is deactivated
               by user activity.

       V\bVe\ber\brb\bbo\bos\bse\be
               Whether to print lots of debugging information.

       I\bIn\bns\bst\bta\bal\bll\bl C\bCo\bol\blo\bor\brm\bma\bap\bp
               Whether  to  install  a private colormap while the
               screensaver is active, so that the graphics  hacks
               can  get  as  many colors as possible.  (This only
               applies when the screen's default visual is  being
               used, since non-default visuals get their own col-
               ormaps automatically.)  This can also be  overrid-
               den on a per-demo basis.




X Version 11             20-Jun-99 (3.15)                       2





XScreenSaver(1)                                   XScreenSaver(1)


       F\bFa\bad\bde\be C\bCo\bol\blo\bor\brm\bma\bap\bp
               If  selected, then when the screensaver activates,
               the current contents of the screen  will  fade  to
               black  instead  of  simply winking out.  This only
               works on displays with  writable  colormaps,  that
               is,  if  the  screen's default visual is a Pseudo-
               Color visual.  A  fade  will  also  be  done  when
               switching  graphics  hacks (when the _\bC_\by_\bc_\bl_\be _\bT_\bi_\bm_\be_\bo_\bu_\bt
               expires.)

       U\bUn\bnf\bfa\bad\bde\be C\bCo\bol\blo\bor\brm\bma\bap\bp
               The complement to _\bF_\ba_\bd_\be _\bC_\bo_\bl_\bo_\br_\bm_\ba_\bp: if selected, then
               when  the  screensaver  deactivates,  the original
               contents of the screen will  fade  in  from  black
               instead of appearing immediately.  This only works
               on displays with writable colormaps, and when _\bF_\ba_\bd_\be
               _\bC_\bo_\bl_\bo_\br_\bm_\ba_\bp is also selected.

       F\bFa\bad\bde\be D\bDu\bur\bra\bat\bti\bio\bon\bn
               When  fading  or  unfading are selected, this con-
               trols how long the fade will take.

       F\bFa\bad\bde\be T\bTi\bic\bck\bks\bs
               This controls how many times a second the colormap
               will  be changed to effect a fade.  Higher numbers
               yield smoother fades, but may make the fades  take
               longer  than  the  specified number of seconds, if
               your server isn't fast enough to keep up.

       R\bRe\beq\bqu\bui\bir\bre\be P\bPa\bas\bss\bsw\bwo\bor\brd\bd
               Whether the screen saver should  lock  the  screen
               when it activates.

       L\bLo\boc\bck\bk T\bTi\bim\bme\beo\bou\but\bt
               If _\bR_\be_\bq_\bu_\bi_\br_\be _\bP_\ba_\bs_\bs_\bw_\bo_\br_\bd is selected, this controls the
               length of the ``grace period''  between  when  the
               screensaver activates, and when the screen becomes
               locked.  For example,  if  this  is  0:05:00,  and
               _\bS_\ba_\bv_\be_\br  _\bT_\bi_\bm_\be_\bo_\bu_\bt  is 0:10:00, then after 10 minutes,
               the screen would blank.  If there was user  activ-
               ity  at  12 minutes, no password would be required
               to un-blank the screen.  But, if  there  was  user
               activity  at  15  minutes  or later (that is, _\bL_\bo_\bc_\bk
               _\bT_\bi_\bm_\be_\bo_\bu_\bt minutes after activation) then a  password
               would be required.  The default is 0, meaning that
               if locking is enabled, then  a  password  will  be
               required as soon as the screen blanks.

       P\bPa\bas\bss\bsw\bwo\bor\brd\bd T\bTi\bim\bme\beo\bou\but\bt
               When  the screensaver is prompting for a password,
               the prompt dialog box will stay on the screen  for
               this  long  before  giving  up,  and  reverting to
               screen-saving mode.




X Version 11             20-Jun-99 (3.15)                       3





XScreenSaver(1)                                   XScreenSaver(1)


C\bCO\bOM\bMM\bMA\bAN\bND\bD-\b-L\bLI\bIN\bNE\bE O\bOP\bPT\bTI\bIO\bON\bNS\bS
       _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo  accepts  the  following  command   line
       options.

       -\b-d\bdi\bis\bsp\bpl\bla\bay\by _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn
               The  X display to use.  The _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo pro-
               gram will open its window  on  that  display,  and
               also  control the _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br daemon that is man-
               aging that same display.

       -\b-p\bpr\bre\bef\bfs\bs  Start up in Preferences mode: this  is  just  like
               launching  the program with no arguments, and then
               pressing the _\bP_\br_\be_\bf_\be_\br_\be_\bn_\bc_\be_\bs button.

       It  is  important  that  the  _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br  and   _\bx_\bs_\bc_\br_\be_\be_\bn_\b-
       _\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo processes be running on the same machine, or at
       least, on two machines that share  a  file  system.   When
       _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo  writes a new version of the _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\b-
       _\bs_\ba_\bv_\be_\br file, it's important that the _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br see  that
       same  file.   If  the  two  processes are seeing different
       _\b~_\b/_\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br files, things will malfunction.

E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
       D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.

       P\bPA\bAT\bTH\bH    to find the sub-programs to  run.   However,  note
               that the sub-programs are actually launched by the
               _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br  daemon,  not  by   _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br_\b-_\bd_\be_\bm_\bo
               itself.   So,  what  matters  is  what  $\b$P\bPA\bAT\bTH\bH  the
               _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br program sees.

       H\bHO\bOM\bME\bE    for the directory in which to read and  write  the
               _\b._\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br file.

       X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
               to  get the name of a resource file that overrides
               the global resources stored in  the  RESOURCE_MAN-
               AGER property.

U\bUP\bPG\bGR\bRA\bAD\bDE\bES\bS
       The    latest    version    can   always   be   found   at
       http://www.jwz.org/xscreensaver/

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
       X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br-\b-c\bco\bom\bmm\bma\ban\bnd\bd(1)

C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
       Copyright (C) 1992, 1993, 1997, 1998, 1999 by Jamie Zawin-
       ski.   Permission  to  use,  copy, modify, distribute, and
       sell this software and its documentation for  any  purpose
       is  hereby  granted  without  fee, provided that the above
       copyright notice appear in all copies and that  both  that
       copyright notice and this permission notice appear in sup-
       porting documentation.  No representations are made  about



X Version 11             20-Jun-99 (3.15)                       4





XScreenSaver(1)                                   XScreenSaver(1)


       the  suitability  of this software for any purpose.  It is
       provided "as is" without express or implied warranty.

A\bAU\bUT\bTH\bHO\bOR\bR
       Jamie Zawinski <jwz@jwz.org>, 13-aug-92.

       Please let me know if  you  find  any  bugs  or  make  any
       improvements.

















































X Version 11             20-Jun-99 (3.15)                       5