README.definable-cursor

   1 # README.definable-cursor: How to use definable-cursor patch for Window Maker
   2 # created 1999-Apr-24 14:53 jmk
   3 # autodate: 1999-Apr-24 16:29
   4
   5 __________________________________________________
   6 |O|  Definable Mouse Cursors for Window Maker  |X|
   7 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   8
   9 The definable-cursor patch for Window Maker
  10 <http://www.windowmaker.org/> allows user-definable mouse cursors; the
  11 cursors can either be the built-in ones from the X11 cursor font, or
  12 they can be bitmap (XBM) files.  User-definable cursors can be useful
  13 for theme-builders, lefthanders, and the visually impaired.
  14
  15 This README describes how to apply the patch to Window Maker and how to
  16 use the features it enables.
  17
  18 ____________________________
  19 |O|  Applying the Patch  |X|
  20 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  21
  22 The definable-cursor patch is available from
  23 <http://www.pobox.com/~jmknoble/WindowMaker/patches/>.
  24
  25 To apply the patch, do the following (where `XX' is the version of
  26 Window Maker you're patching):
  27
  28     (0) gzip -dc WindowMaker-XX.tar.gz | tar -xvf -
  29
  30     (1) cd ./WindowMaker-XX
  31
  32     (2) patch </wherever/you/put/WindowMaker-XX-definable-cursor.patch
  33
  34     (3) Build Window Maker according to the instructions in the
  35         accompanying `INSTALL' file.
  36
  37 ___________________________________
  38 |O|  Defining Your Own Cursors  |X|
  39 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  40
  41 A cursor specification is one of:
  42
  43     (none)
  44     (builtin, <cursor-name>)
  45     (bitmap, <bitmap-filename>, <mask-filename>)
  46
  47 where <cursor-name> uses the same syntax as for `xsetroot -cursor_name',
  48 and <bitmap-filename> and <mask-filename> are the same as for
  49 `xsetroot -cursor'; <bitmap-filename> and <mask-filename> are searched
  50 for along WM's PixmapPath.  If you use `(none)', the cursor will be
  51 inherited from the parent window (which often ends up being the root
  52 window).
  53
  54 You can set the following cursor types (they're shown here with their
  55 defaults):
  56
  57     NormalCursor = (builtin, left_ptr);
  58     MoveCursor   = (builtin, fleur);
  59     ResizeCursor = (builtin, sizing);
  60     WaitCursor   = (builtin, watch);
  61
  62 ______________________
  63 |O|  Random Notes  |X|
  64 ^^^^^^^^^^^^^^^^^^^^^^
  65
  66 Most X11 cursors are 16x16 bitmaps.  Many X servers can actually handle
  67 larger cursors, though.  To check, use:
  68
  69     xdpyinfo
  70
  71 and in the resulting output look for a line such as:
  72
  73     largest cursor:    64x64
  74
  75 The example above indicates that my X server can handle cursors up to
  76 64 pixels wide by 64 pixels high.
  77
  78 You can create your own bitmap cursors using the `bitmap' program that
  79 accompanies most X11 distributions.  For example bitmap cursors, see
  80 <http://www.pobox.com/~jmknoble/WindowMaker/cursors/>.
  81
  82 For an example
  83
  84 --jim
  85
  86 %%%%%%%%%%%%%%% jim knoble %%%%%%%% jmknoble@pobox.com %%%%%%%%%%%%%%%%%