mirror of
https://github.com/gryf/wmaker.git
synced 2025-12-19 20:38:08 +01:00
121 lines
4.3 KiB
Plaintext
121 lines
4.3 KiB
Plaintext
# README.definable-cursor: How to use definable-cursor patch for Window Maker
|
|
# created 1999-Apr-24 14:53 jmk
|
|
# autodate: 2001-Sep-05 22:40
|
|
|
|
+------------------------------------------+
|
|
| Definable Mouse Cursors for Window Maker |
|
|
+------------------------------------------+
|
|
|
|
The definable-cursor patch for Window Maker
|
|
<http://www.windowmaker.org/> allows user-definable mouse cursors; the
|
|
cursors can either be the built-in ones from the X11 cursor font, or
|
|
they can be bitmap (XBM) files. User-definable cursors can be useful
|
|
for theme-builders, lefthanders, and the visually impaired.
|
|
|
|
This README describes how to enable user-definable cursors in Window
|
|
Maker as well as how to use them.
|
|
|
|
+----------------------------+
|
|
| Enabling Definable Cursors |
|
|
+----------------------------+
|
|
|
|
If you want to enable definable mouse cursors in Window Maker, you must
|
|
do so before you configure and build Window Maker. Here's how:
|
|
|
|
(1) Edit src/wconfig.h.in and change the following line:
|
|
|
|
#undef DEFINABLE_CURSOR
|
|
|
|
to:
|
|
|
|
#define DEFINABLE_CURSOR
|
|
|
|
(2) Configure and build Window Maker as you normally would:
|
|
|
|
./configure
|
|
make
|
|
|
|
+---------------------------+
|
|
| Defining Your Own Cursors |
|
|
+---------------------------+
|
|
|
|
A cursor specification takes one of the following forms in the
|
|
~/GNUstep/Defaults/WindowMaker file:
|
|
|
|
(none)
|
|
(builtin, <cursor-name>)
|
|
(bitmap, <bitmap-filename>, <mask-filename>)
|
|
|
|
They have the following meanings:
|
|
|
|
none The cursor is inherited from the parent window (often,
|
|
this means the root window).
|
|
|
|
builtin Use the cursor named <cursor-name> from X11's set of
|
|
built-in cursors. The names are the same as you use
|
|
with 'xsetroot -cursor_name'. See the xsetroot(1) man
|
|
page for more information.
|
|
|
|
bitmap Use the bitmap in <bitmap-filename> as the foreground
|
|
cursor bitmap, and the one in <mask-filename> as the
|
|
background (mask) bitmap. This is pretty much the same
|
|
as 'xsetroot -cursor', except that Window Maker searches
|
|
for the bitmaps along its PixmapPath.
|
|
|
|
You can set the following cursor types (they're shown here with their
|
|
defaults):
|
|
|
|
NormalCursor = (builtin, left_ptr);
|
|
ArrowCursor = (builtin, top_left_arrow);
|
|
MoveCursor = (builtin, fleur);
|
|
TopLeftResizeCursor = (builtin, top_left_corner);
|
|
TopRightResizeCursor = (builtin, top_right_corner);
|
|
BottomLeftResizeCursor = (builtin, bottom_left_corner);
|
|
BottomRightResizeCursor = (builtin, bottom_right_corner);
|
|
VerticalResizeCursor = (builtin, sb_v_double_arrow);
|
|
HorizontalResizeCursor = (builtin, sb_h_double_arrow);
|
|
WaitCursor = (builtin, watch);
|
|
QuestionCursor = (builtin, question_arrow);
|
|
TextCursor = (builtin, xterm);
|
|
SelectCursor = (builtin, cross);
|
|
|
|
The following cursor types are allowed, but they're deprecated (Window
|
|
Maker used them in the past, but doesn't use them anymore):
|
|
|
|
ResizeCursor = (builtin, sizing);
|
|
|
|
+----------------------------------------------+
|
|
| Using Cursors with 'getstyle' and 'setstyle' |
|
|
+----------------------------------------------+
|
|
|
|
The 'getstyle' and 'setstyle' style- and theme-management utilities
|
|
can handle user-definable cursors. By default, 'getstyle' ignores
|
|
cursor definitions; using 'getstyle -t' to get theme-related settings
|
|
will also include any cursors you've defined in the resulting
|
|
stylefile.
|
|
|
|
However, by default, 'setstyle' does *not* ignore cursor settings. If
|
|
you wish to set a style or theme without installing cursor settings,
|
|
you can use 'setstyle --no-cursors' to ignore the cursor definitions.
|
|
|
|
+--------------+
|
|
| Random Notes |
|
|
+--------------+
|
|
|
|
Most X11 cursors are 16x16 bitmaps. Many X servers can actually handle
|
|
larger cursors, though. To check, use:
|
|
|
|
xdpyinfo
|
|
|
|
and in the resulting output look for a line such as:
|
|
|
|
largest cursor: 64x64
|
|
|
|
The example above indicates that my X server can handle cursors up to
|
|
64 pixels wide by 64 pixels high.
|
|
|
|
You can create your own bitmap cursors using the 'bitmap' program that
|
|
accompanies most X11 distributions. For example bitmap cursors and
|
|
masks, see <http://www.pobox.com/~jmknoble/WindowMaker/cursors/>.
|
|
|