/usr/man/cat.1/dtstyle.1
dtstyle(1) USER COMMANDS dtstyle(1)
NAME
dtstyle - the TED Style Manager
SYNOPSIS
dtstyle
NOTE: There are no style manager specific options that can
be specified in the command line.
DESCRIPTION
Dtstyle provides interactive customization of visual ele-
ments and system behavior for the desktop through the style
manager. This component consists of the UI and supporting
code that allows the end user to interactively customize
most of the visual elements and system behavior for the TED.
This component also helps define some resource utilization
conventions. The style manager's main window which consists
of an iconic interface is invoked from the Front Panel. The
style manager window contains icons representing customiza-
tion in several areas.
Key Supported Tasks
Colors Sets the color palette that is used for win-
dow colors in the workspace.
Fonts Sets the application font sizes as applica-
tions are started.
Backdrop Sets the backdrops for workspaces.
Keyboard Sets the keyboard's key click volume and
character repeat capability.
Mouse Sets the mouse button click settings,
double-click speed, pointer acceleration and
pointer movement threshold.
Audio Sets the beeper volume, tone, and duration.
Screen Sets the screen lock and time-out intervals,
chooses the screen saver client(s) to be run
at time out and/or screen lock and previews
the selected screen saver client(s) to the
user.
Window Sets the window focus policy, window raise
policy and iconification policy (in an icon
box or on the desktop).
Startup Sets the session startup policy.
Unix System LaboratoLast change: 1 August 1995 1
dtstyle(1) USER COMMANDS dtstyle(1)
OPTIONS
There are no style manage specific options that can be set
from the command line.
RESOURCES
Style Manager specific resources
The style manager used the following resources to control
its appearance and behavior.
Name Class type Default
writeXrdbImmediate WriteXrdbImmediate Boolean true
writeXrdbImmediate
Controls when new font size or new mouse double-click time
resources are used. If True, new resources are used when new
clients start. If False, new resources are used at the next
session (after logout, with "Resume Current Session"
selected in the Startup dialog).
The following resources are specified in Dtstyle (dtstyle's
app-defaults file).
Name Class Type Default
mainRC.orientation XmNorientation string HORIZONTAL
componentList ComponentList string see below*
componentList ComponentList string see below*
secondaryColorSetId SecondaryColorSetId int 6
toneScale.maximum XmCMaximum int 9000
toneScale.minimum XmCMaximum int 82
durationScale.maximum XmCMaximum int 25
mainRC.orientation
Controls the layout of the style manager main window. If
this resource is set to VERTICAL then the style manager main
window is displayed vertically.
componentList
Specifies the Style Manager components with a list of com-
ponent keywords separated by spaces. Valid component key-
words include: Color, Font, Backdrop, Keyboard, Mouse,
Audio, Screen, Window, and Startup. The default com-
ponentList value is: Color Font Backdrop Keyboard Mouse
Audio Screen Window Startup.
secondaryColorSetId
Specifies the color to be used for the menubar and all menus
and dialogs of the dtstyle application.
toneScale.maximum
Specifies the maximum value to be used for the tone slider
Unix System LaboratoLast change: 1 August 1995 2
dtstyle(1) USER COMMANDS dtstyle(1)
in the Beep dialog.
toneScale.minimum
Specifies the minimum value to be used for the tone slider
in the Beep dialog.
durationScale.maximum
Specifces the maximum value to be used for the duration
slider in the Beep dialog.
fileMenu.exit.accelerator
Specifies the accelerator key for the Exit menu option of
the style manager main window.
fileMenu.exit.acceleratorText
Specifies the text for the accelerator key that appears next
to the Exit menu option of the style manager main window.
dtstyle Specific Resources
The following font resources are specified in Dtstyle
Name Class Type Default
numFonts NumFonts int 6
systemFont1 SystemFont1 FontList see SF1 below sys-
temFont2 SystemFont2 FontList see SF2 below system-
Font3 SystemFont3 FontList see SF3 below system-
Font4 SystemFont4 FontList see SF4 below system-
Font5 SystemFont5 FontList see SF5 below system-
Font6 SystemFont6 FontList see SF6 below system-
Font7 SystemFont7 FontList see SF7 below
userFont1 UserFont1 FontList see UF1 below
userFont2 UserFont2 FontList see UF2 below
userFont3 UserFont3 FontList see UF3 below
userFont4 UserFont4 FontList see UF4 below
userFont5 UserFont5 FontList see UF5 below
userFont6 UserFont6 FontList see UF6 below
userFont7 UserFont7 FontList see UF7 below
numFonts
Specifies the number of System/User Font alias pairs
presented in the Font dialog. The default is 7.
systemFont[1-7]
Specifies a SystemFont alias for a particular font size that
can be selected in the Font dialog. The default system font
aliases are:
SF1 -dt-interface system-medium-r-normal-xxs*-*-*-*-*-
*-*-*-*: SF2 -dt-interface system-medium-r-normal-xs*-*-*-*-
Unix System LaboratoLast change: 1 August 1995 3
dtstyle(1) USER COMMANDS dtstyle(1)
*-*-*-*-*: SF3 -dt-interface system-medium-r-normal-s*-*-*-
*-*-*-*-*-*: SF4 -dt-interface system-medium-r-normal-m*-*-
*-*-*-*-*-*-*: SF5 -dt-interface system-medium-r-normal-l*-
*-*-*-*-*-*-*-*: SF6 -dt-interface system-medium-r-normal-
xl*-*-*-*-*-*-*-*-*: SF7 -dt-interface system-medium-r-
normal-xxl*-*-*-*-*-*-*-*-*:
userFont[1-6]
Specifies a UserFont for a particular font size that can be
selected in the Font dialog. The default user fonts are
local specific. For English language-US the defaults are:
UF1 -dt-interface user-medium-r-normal-xxs*-*-*-*-*-*-*-*-*:
UF2 -dt-interface user-medium-r-normal-xs*-*-*-*-*-*-*-*-*:
UF3 -dt-interface user-medium-r-normal-s*-*-*-*-*-*-*-*-*:
UF4 -dt-interface user-medium-r-normal-m*-*-*-*-*-*-*-*-*:
UF5 -dt-interface user-medium-r-normal-l*-*-*-*-*-*-*-*-*:
UF6 -dt-interface user-medium-r-normal-xl*-*-*-*-*-*-*-*-*:
UF7 -dt-interface user-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:
Color and backdrop resources: Global to
The following resources are used by more than one desktop
component. The syntax for specifying global resources is:
*resource_id.
Name Class Type Default
colorUse ColorUse int dynamic*
dynamicColor DynamicColor Boolean true
foregroundColor ForegroundColor int dynamic*
shadowPixmaps ShadowPixmaps int dynamic*
writeXrdbColors WriteXrdbColors Boolean true
NOTE: The display type determines default.
ColorUse
Specifies the number of colors to use for the user inter-
face. The default value for this resource is dependant on
the number of bit planes available in the display. However,
to reduce the number of col- ors used by the desktop, the
default color use for a high color display is MEDIUM_COLOR.
Valid values are: " B_W" - Specifies a black and white sys-
tem. The color palettes use only Black and White (color
cells 0 and 1) and icons are displayed as bitonal images. In
this configuration four color palettes are available: Black,
White, BlackWhite and WhiteBlack. These palettes do not
dynamically change. To change a palette, the session must be
restarted. This resource value forces shadowPixmaps to
True, and foregroundColor to either black or white depending
on the palette chosen. " LOW_COLOR" - Specifies a low color
system. The color palettes use 2 color sets and icons are
displayed as bitonal images. The number of color cells can
be further reduced by using the resources shadowPixmaps and
foregroundColor. MEDIUM_COLOR - Specifies a medium color
Unix System LaboratoLast change: 1 August 1995 4
dtstyle(1) USER COMMANDS dtstyle(1)
system. The color palettes use 4 color sets and icons are
displayed as bitonal images. The number of color cells can
be further reduced by using the resources shadowPixmaps and
foregroundColor. HIGH_COLOR - Specifies a high color sys-
tem. The color palettes use 8 color sets and icons are
displayed as multi-color images. The number of color cells
can be reduced by using the resources shadowPixmaps and
foregroundColor.
planes
2-3
4
6
8
dynamicColor
This resource can have values of True or False. dynamicColor
is used to reduce the number of color cells being used. Once
a palette has been selected and it is not likely to be
changed, dynamicColor can be set to False. If set to False
colors cannot be dynamically changed using the Style
Manager. A selected palette will take effect the next ses-
sion. The next time the session comes up, the color server
uses Read Only color cells that can be shared by all
clients, thus reducing the number of color cells used.
foregroundColor
This resource can have values of White, Black or Dynamic.
foregroundColor causes all text (foreground) to use either
pixel 0 or 1 (Black or White) or to have a color cell dedi-
cated to foreground that changes in response to the back-
ground color (Dynamic) for each ColorSet. If set to White or
Black, the number of color cells used per ColorSet is
reduced by 1.
shadowPixmaps
For color systems, this resource can have a value of True or
False. If True, topShadowColor and bottomShadowColor use the
same pixel as background and topShadowPixmap and bottomSha-
dowPixmap are specified instead of solid color to create the
3D look. This reduces the number of color cells per ColorSet
by 2. shadowPixmaps defaults to True for systems with 4 or
less color planes (16 or less color cells), and False for
systems with more than 4 color planes.
Unix System LaboratoLast change: 1 August 1995 5
dtstyle(1) USER COMMANDS dtstyle(1)
writeXrdbColors
This resource should only be used if non desktop Motif
clients are to be run that have color schemes that conflict
with the desktop colors. This resource has no impact on
clients linked with the desktop Motif library. This resource
specifies whether color resource information should be writ-
ten out. If set to False, background and foreground
resources are not written out with the values of the current
palette. This means that the above-mentioned clients do not
get the desktop colors when they are started. The default
value is True.
Color resources: client specific
The following resources are specified on a per client basis.
The syntax for specifying client-specific resources is:
client_name_or_class*resource_id.
Name Class Type
Default
primaryColorSetId PrimaryColorSetId int 3
secondaryColorSetId SecondaryColorSetId int 4
primaryColorSetId
This resource specifies the primary color for an applica-
tion. The primary color is used for the main background
areas of the application and all children of the main area.
The value of this resource is a number from one to eight
that represents a specific color set in a palette.
secondaryColorSetId
This resource specifies the secondary color for an applica-
tion. The secondary color is used for the menubar and all
menus and dialogs of the application. This allows dialogs on
the screen to be visually associated with their parent
applications by matching the dialog color to the menubar.
The value of this resource is a number from one to eight
that represents a specific color set in a palette.
Color resources: dtwm specific
The following are dtwm-specific resources.
Name Class Type Default
Name ClassClass Type Default
activeColorSetId ActiveColorSetId int 1
inactiveColorSetId InactiveColorSetId int 2
activeColorSetId
Specifies the active frame color for dtwm. The value of this
resource is a number from one to eight, which represents a
specific color set in a palette.
Unix System LaboratoLast change: 1 August 1995 6
dtstyle(1) USER COMMANDS dtstyle(1)
inactiveColorSetId
Specifies the inactive frame color for dtwm. The value of
this resource is a number from one to eight, which
represents a specific color set in a palette.
Resources saved to xrdb by the
The following resources are written out to xrdb by the style
manager.
*HelpColorUse
color use mode for help.
*ColorUse
color use mode.
*ColorPalette
value of current color palette
*MonochromePalette
value of the current palette if it is monochrome.
*background
motif resource.
*foreground
motif resource.
Dtwm.keyboardFocusPolicy
motif resource.
Dtwm*focusAutoRaise
motif resource.
Dtwm*moveOpaque
motif resource.
Dtwm*useIconBox
motif resource.
*multiClickTime
motif resource.
*enableBtn1Transfer
when set to true button 2 performs adjust operation at the
next session.
Unix System LaboratoLast change: 1 August 1995 7
dtstyle(1) USER COMMANDS dtstyle(1)
*systemFont: <systemFont[1-7]>
font displayed in labels and other non-editable text areas.
*userFont: <userFont[1-7]>
font displayed in text widgets.
*FontList: <systemFont[1-7]>
motif resource.
*XmText*FontList: <userFont[1-7]>
motif resource.
*XmTextField*FontList: <userFont[1-7]>
motif resource.
*Font: <systemFont[1-7]>
motif resource.
*FontSet: <systemFont[1-7]>
font resource.
*DtEditor*textFontList: <userFont[1-7]>
dtpad resource.
ENVIRONMENT
DTSCREENSAVERLIST
This environment variable specifies the names of the avail-
able screen saver actions (separated by a blank space).
Using this variable allows the style manager to query the
actions data base and display a list of the available screen
saver clients for the user and to invoke screen saver
actions for preview of selected screen savers.
BROADCAST MESSAGES
None.
PROPERTIES AND SELECTIONS
The style manager uses X properties to communicate with the
session manager and the window manager.
DIAGNOSTICS
- This will replace your home session with the current
session. Continue?
Startup dialog - Message appears in a warning dialog when
the user pushes Set Home Session...
- A palette named `%s' already exists. This new palette
will overwrite the old one. Is this what you want to
do?
Unix System LaboratoLast change: 1 August 1995 8
dtstyle(1) USER COMMANDS dtstyle(1)
Add Palette dialog - Message appears in a warning dialog
when an existing palette name is specified.
- Delete palette `%s'?
Delete Palette dialog - Message appears in a warning dialog
when a palette is being deleted.
- The new double-click time will take effect as appli-
cations are restarted. Other mouse values take effect
immediately.
Mouse dialog - Message appears in a warning dialog after the
user selects a new double- click time and presses OK (and
the resource *WriteXrdbImmediate is True).
- The new double-click time will take effect at your
next session. Other mouse values take effect immedi-
ately.
Mouse dialog - Message appears in a warning dialog after the
user selects a new double- click time and presses OK (and
the resource *WriteXrdbImmediate is False).
- The right and left mouse buttons will switch function
immediately after you push OK below. Look at the mouse
visual in Style Manager Mouse window for indication of
current handedness.
Mouse dialog - Message appears in a warning dialog after the
user selects the left- handed or right-handed toggle to
change mouse handedness.
- The function of the middle button will switch at your
next session if you push OK below. Note that when the
middle button is set to perform the adjust operation,
the transfer operation is integrated with the select
button by holding down the select button and dragging.
Mouse dialog - Message appears in a warning dialog after the
user selects the transfer or adjust toggles to change the
function of the middle button.
- The new Color Use value will take effect at your next
session.
ColorUse dialog - Message appears in a warning dialog when
the color use mode is changed and OK is pushed.
- The selected palette will take effect at your next
session.
Color dialog - Message appears in a warning dialog when the
desktop is running in black and White mode and a new palette
is selected in the Color dialog.
ERROR MESSAGES
- You must select an item within the Style Manager.
Main window - Message appears in an error dialog when On
Item Help is being used and the user clicks on an area out-
side of the style manager main window area.
- Couldn't open bitmap directory `%s'.
Unix System LaboratoLast change: 1 August 1995 9
dtstyle(1) USER COMMANDS dtstyle(1)
Backdrop dialog - Message appears in an error dialog when
the bitmap directory could not be loaded.
- There are no backdrop icons available in `%s'. See
your System Administrator or the User's Guide for more
details.
Backdrop dialog - Message appears in an error dialog when
the bitmap directory is empty.
- The palette name cannot contain these characters: :(
) [ ] { } < > ! | ` / \
Color dialog- Messages appear in an error dialog when the
specified palette name is not acceptable.
- The palette name must be 10 characters or less.
Color dialog- Messages appear in an error dialog when the
specified palette name is not acceptable.
- The color portion of the Style Manager will not
operate because the color server is not running. Check
$HOME/.dt/errorlog.
Color dialog- Messages appear in an error dialog when the
color icon is selected and the color server is not running
for some reason.
- The color portion of the Style Manager will not
operate because the resource useColorObj is set to
False.
Color dialog- Messages can be caused to appear in an error
dialog by setting the resource *useColorObj to False and
then running dtstyle and trying to post the Color Dialog.
- The color portion of the Style Manager will not
operate because there are no palette files available.
Check $HOME/.dt/errorlog.
Color dialog- Messages appears in an error dialog when the
color icon is selected and there are no palette files to be
found.
FILES
Icon files Icons used in the style manger.
App-default file
Dtstyle - contains application resources for
the style manager.
Palette files Files that contain the default and customized
palettes.
Backdrop file Files containing the data for backdrop cus-
tomization.
SEE ALSO
Dtsession Acts as a color server and runs the screen
saver clients.
Unix System LaboratoLast change: 1 August 1995 10
dtstyle(1) USER COMMANDS dtstyle(1)
Dtwm The window manager can be restarted when cer-
tain environment customization operations are
performed so that changes can take effect.
Unix System LaboratoLast change: 1 August 1995 11
See also dtstyle(1)
Man(1) output converted with
man2html