XPREF(1) X Version 11 (Release 5) XPREF(1)
NAME
xpref - X Window System user preference tool
SYNOPSIS
xpref [-nowindow]
DESCRIPTION
With the xpref tool you can interactively set the attributes
of the following categories:
Bell,
Cursor,
Font Path,
Host Access,
Keyboard,
Mouse,
Root Tile,
Screen
If you execute xpref without the -nowindow option you will
see one window. The window will contain a scrolled list and
a menu bar. The scrolled list will contain eight graphic
buttons and the menu bar will contain File and Help pulldown
menus. Each graphic button in the scrolled list represents
each previously listed category.
If the .Xpref file is present in your home directory, xpref
will set the attributes of the server as defined by the
.Xpref file. Each category will then display information as
defined by the .Xpref file. If the .Xpref file is not
present then the attributes for the Bell, Font Path, Host
Access, Keyboard, Mouse and Screen categories will be
supplied by the server. You can create the .Xpref file by
selecting the Save option from the File menu.
When you select an option with a button from the scrolled
list, the window displaying the previous category will be
closed and a new window showing the present selection will
be displayed by default. See the RESOURCES section.
When you make any change in the Bell, Keyboard, Mouse and
Screen categories, the change takes place immediately.
Page 1 (printed 1/22/93)
XPREF(1) X Version 11 (Release 5) XPREF(1)
OPTIONS
xpref accepts all of the standard X Toolkit command line
options along with the additional option listed below:
-nowindow
This option is useful only if you have a .Xpref file
in the home directory. This option will cause xpref
to set the attributes of the server as defined by
the .Xpref file and then exit. No windows will be
displayed.
COLORS Window
You can select foreground and background colors for the
cursor and root tile categories by selecting:
the Color... option from the File menu
or
the Color... button from the Cursor category
or
the Color... button from the Root Tile category
To select the foreground move the cursor to the Foreground
window and click. A border will appear around the Foreground
window. You then select a color name from the scrolled list.
After you select a color name the Foreground window will be
filled with the selected color.
To select the background, move the cursor to the Background
window and click. A border will appear around the Background
window. You then select a color name from the scrolled list.
After you select a color name the Background window will be
filled with the selected color.
CATEGORIES
BELL With the BELL category, you can control the Volume,
Pitch and the Duration features using the scale
widgets.
NOTE: On the AViiON 300 and 400 series with the
DG/UX Release 5.4 system the Volume will be off if
set to 0% and on otherwise. The Pitch and Duration
features are not supported.
CURSOR With the CURSOR category, you can browse through the
list of cursors that are already defined by X or
through user-defined bitmap files.
Page 2 (printed 1/22/93)
XPREF(1) X Version 11 (Release 5) XPREF(1)
You can select a cursor from two subcategories: X
Pre Defined and User Defined. After you select the
subcategory, appropriate information will be
displayed in the scrolled list.
If you choose the X Pre Defined subcategory then you
can select the desired cursor name from the scrolled
list and the cursor's data and mask will be
displayed in the Data and Mask windows respectively.
If you choose the User Defined subcategory and you
want to select the data for the cursor, move the
cursor inside the Data window and click. A border
will appear around the Data window. Then select the
bitmap file from the scrolled list. After you select
the bitmap file the Data window will display its
contents.
To select the mask for the cursor, move the cursor
inside the Mask window and click. A border will
appear around the Mask window. Then select the
bitmap file from the scrolled list. After you select
the bitmap file the Mask window will display its
contents.
If xpref is being displayed on a color display you
can reverse the background and the foreground of the
cursor by selecting the button labelled
Background/Foreground.
Apply: After you select the data and mask for the
cursor you can change the root cursor by selecting
the button labelled Apply.
Color...: When you select this button, you will see
the window labelled COLORS.
Whenever you select a cursor from the scrolled
list, the background and the foreground will be
set to the color displayed in this window.
FONTPATH
With the FONTPATH category, you can modify the font
lookup directory search path for all clients.
You can type a directory path in the scrolled text
window, after which you may select:
Apply: Changes the font path.
Reset: Sets the font path to its default state,
which is the path used before the application
Page 3 (printed 1/22/93)
XPREF(1) X Version 11 (Release 5) XPREF(1)
started.
HOSTACCESS
With the HOSTACCESS category, you can control a list
of hosts that have permission to display information
on your screen.
Names Shown: By selecting Names Shown, you allow
only the hosts in the scrolled list to display
information.
Everybody: By selecting Everybody, you allow
everybody(all hosts) to display information.
Add...: A dialog box labelled 'Enter Host Name'
will appear. Enter the name of the host in the
text area and press the Enter key or select the
OK button. If the name is valid, it will appear in
the list. If the name is invalid, another dialog
box labelled 'Unknown Host Name' will appear
after about five seconds.
Delete: To delete a host name select the name from
the scrolled list and select the Delete button.
NOTE: When you select the Save option from the File
menu, the list of hosts is not saved but only the
choice Names Shown or Everybody is saved.
KEYBOARD
With the KEYBOARD category, you can control the Auto
Repeat and the Key Click features of a keyboard. The
Auto Repeat is controlled by using a toggle button
and the Key Click is controlled by using a scale
widget.
Auto Repeat: You can set the Auto Repeat to On or
Off. If the Auto Repeat is set to On, holding down
any non-modal key will result in multiple KeyPress
and KeyRelease event pairs with the same keycode
member. Keys such as Shift Lock, however, will
still not repeat. If the auto repeat is set to
Off, holding down any non-modal key will not
result in multiple KeyPress event pairs.
Key Click: You can set the Key Click from 0(off) to
100(loud).
NOTE: On the AViiON 300 and 400 series with the
DG/UX Release 5.4 system the Key Click feature is
Page 4 (printed 1/22/93)
XPREF(1) X Version 11 (Release 5) XPREF(1)
not supported.
MOUSE With the MOUSE category, you can control the
Acceleration and the Threshold features using the
scale widgets. You can set the Acceleration and
Threshold from 1 to 100.
Acceleration takes effect only when a particular
mouse distance is greater than the set Threshold
pixels during one mouse motion. The Acceleration
specifies the factor by which the mouse moves beyond
the Threshold pixels.
Example
If the Threshold = 6 and the Acceleration = 4 and
the mouse has moved a distance of 10 pixels, then
the mouse will move a net distance of 22:
6 + (10 - 6) * 4 = 22
ROOT TILE
With the ROOT TILE category, you can set the tile of
the root window to any bitmap file. Select the
bitmap file from the scrolled list. After you select
the bitmap file, the Tile window will be filled with
the bitmap file.
You can reverse the background and the foreground by
selecting the button labelled Background/Foreground.
Apply: Changes the tile of the root window.
Color...: When you select this button, you will see
the window labelled COLORS.
Whenever you select a bitmap file from the
scrolled list, the background and the
foreground will be set to the color displayed in
this window.
SCREEN With the SCREEN category, you can control the
Blanking, Exposures, Time-Out and Period features of
the server by using toggle buttons and scale
widgets. These features take effect when the server
is left idle for Time-Out number of seconds.
You can set Blanking and Exposures features to On or
Page 5 (printed 1/22/93)
XPREF(1) X Version 11 (Release 5) XPREF(1)
Off. Time-Out and Period are specified in seconds.
You can set Time-Out and Period from 0 to 10,000
seconds.
If you set Exposures and Blanking to Off the screen
will never go blank. If you set Blanking to Off,
Exposures to On and the server is left idle for
Time-Out seconds, then a random pattern will be
displayed on the screen after Time-Out seconds and
the design will change every Period seconds. If you
set Balnking to On and the server is left idle for
Time-Out seconds, then the screen will go blank.
RESOURCES
XPref.NumOfTools : 1
If this resource is set to 1, then you will see
only the window of the last selected category.
Otherwise, you will be able to see all the windows
of the category selected. By default this resource
will be set to 1.
XPref.DisplayInitialTool : 0
If this resource is set to 1, then when
xpref window is displayed, the window corresponding
to the first category will also be displayed. To
enable this feature, set the resource to 1. By
default this resource will be set to 0.
SEE ALSO
X(1), xset(1), xsetroot(1), xhost(1)
BUGS
The DG/UX server does not support the BELL and KEYBOARD
categories.
COPYRIGHT
Copyright (C) 1990, 1991, 1992, 1993, Data General
Corporation.
Page 6 (printed 1/22/93)