home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / amiwin / x11 / man / xsetroot.man < prev    next >
Encoding:
Text File  |  1996-07-16  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XSETROOT(1)              USER COMMANDS                XSETROOT(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      xsetroot - root window parameter setting utility for X
  10.  
  11. SYNOPSIS
  12.      xsetroot [-help] [-def] [-display display] [-cursor  cursor-
  13.      file  maskfile] [-cursor_name cursorname] [-bitmap filename]
  14.      [-mod x y] [-gray] [-grey] [-fg color] [-bg color] [-rv]  [-
  15.      solid color] [-name string]
  16.  
  17. DESCRIPTION
  18.      The setroot program allows you to tailor the  appearance  of
  19.      the background ("root") window on a workstation display run-
  20.      ning X.  Normally, you experiment with  xsetroot  until  you
  21.      find  a  personalized  look  that  you  like,  then  put the
  22.      xsetroot command that produces it into your X startup  file.
  23.      If  no  options  are specified, or if -def is specified, the
  24.      window is reset to its default state.  The -def  option  can
  25.      be  specified  along  with  other  options and only the non-
  26.      specified characteristics  will  be  reset  to  the  default
  27.      state.
  28.  
  29.      Only one of the background color/tiling changing options  (-
  30.      solid,  -gray, -grey, -bitmap, and -mod) may be specified at
  31.      a time.
  32.  
  33. OPTIONS
  34.      The various options are as follows:
  35.  
  36.      -help
  37.           Print a usage message and exit.
  38.  
  39.      -def Reset unspecified attributes  to  the  default  values.
  40.           (Restores  the background to the familiar gray mesh and
  41.           the cursor to the hollow x shape.)
  42.  
  43.      -cursor cursorfile maskfile
  44.           This lets you change the pointer cursor to whatever you
  45.           want  when the pointer cursor is outside of any window.
  46.           Cursor and mask files are  bitmaps  (little  pictures),
  47.           and  can be made with the bitmap(1) program.  You prob-
  48.           ably want the mask file to be all black until  you  get
  49.           used to the way masks work.
  50.  
  51.      -cursor_name cursorname
  52.           This lets you change the pointer cursor to one  of  the
  53.           standard cursors from the cursor font.  Refer to appen-
  54.           dix B of the X protocol for the names (except that  the
  55.           XC_ prefix is elided for this option).
  56.  
  57.      -bitmap filename
  58.           Use the bitmap specified in the file to set the  window
  59.           pattern.   You  can  make your own bitmap files (little
  60.  
  61.  
  62.  
  63. X Version 11         Last change: Release 6                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSETROOT(1)              USER COMMANDS                XSETROOT(1)
  71.  
  72.  
  73.  
  74.           pictures) using  the  bitmap(1)  program.   The  entire
  75.           background  will  be made up of repeated "tiles" of the
  76.           bitmap.
  77.  
  78.      -mod x y
  79.           This is used if you want a plaid-like grid  pattern  on
  80.           your  screen.   x  and y are integers ranging from 1 to
  81.           16.  Try the different combinations.  Zero and negative
  82.           numbers are taken as 1.
  83.  
  84.      -gray
  85.           Make the entire background gray.  (Easier on the eyes.)
  86.  
  87.      -grey
  88.           Make the entire background grey.
  89.  
  90.      -fg color
  91.           Use ``color'' as the foreground color.  Foreground  and
  92.           background  colors  are  meaningful only in combination
  93.           with -cursor, -bitmap, or -mod.
  94.  
  95.      -bg color
  96.           Use ``color'' as the background color.
  97.  
  98.      -rv  This exchanges the foreground  and  background  colors.
  99.           Normally  the  foreground  color is black and the back-
  100.           ground color is white.
  101.  
  102.      -solid color
  103.           This sets the background of  the  root  window  to  the
  104.           specified  color.   This option is only useful on color
  105.           servers.
  106.  
  107.      -name string
  108.           Set the name of the root window to  ``string''.   There
  109.           is  no  default value.  Usually a name is assigned to a
  110.           window so that  the  window  manager  can  use  a  text
  111.           representation  when  the  window  is  iconified.  This
  112.           option is unused since  you  can't  iconify  the  back-
  113.           ground.
  114.  
  115.      -display display
  116.           Specifies the server to connect to; see X(1).
  117.  
  118. SEE ALSO
  119.      X(1), xset(1), xrdb(1)
  120.  
  121. AUTHOR
  122.      Mark Lillibridge, MIT Project Athena
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. X Version 11         Last change: Release 6                     2
  130.  
  131.  
  132.  
  133.