![Index](../TOC.GIF) |
Index for Section 1 |
|
![Index](../INDEX.GIF) |
Alphabetical listing for D |
|
![Bottom of page](../FF.GIF) |
Bottom of page |
|
dtstyle(1)
CDE
NAME
dtstyle - the CDE Style Manager
SYNOPSIS
dtstyle
OPTIONS
There are no style manage specific options that can be set from the command
line.
DESCRIPTION
The dtstyle command lets you customize desktop visual elements and system
behavior with the Style Manager.
This component consists of the user interface and supporting code that
allows you to interactively customize most of the visual elements and
system behavior for the CDE. This component also helps define some resource
utilization conventions. The Style Manager's main window is invoked from
the Front Panel and contains icons representing customization of several
areas.
Key Supported Tasks
Colors
Sets the color palette that is used for window colors in the workspace.
Fonts
Sets the application font sizes as applications 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.
Beep
Sets the beeper volume, tone, and duration.
Screen
Sets the screen lock and time-out intervals, chooses the screen saver
clients to be run at time out and screen lock and previews the selected
screen saver clients.
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.
RESOURCES
Style Manager-specific resources
The Style Manager used the following resources to control its appearance
and behavior.
___________________________________________________________
Name Class Type Default
___________________________________________________________
Boolean true
writeXrdbImmediate
WriteXrdbImmediate
___________________________________________________________
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 (the dtstyle app-defaults
file).
_________________________________________________________________
Name Class Type Default
_________________________________________________________________
XmNorientation string HORIZONTAL
mainRC.orientation
componentList ComponentList string see below*
componentList ComponentList string see below*
int 6
secondaryColorSetId
SecondaryColorSetId
toneScale.maximum XmCMaximum int 9000
toneScale.minimum XmCMaximum int 82
XmCMaximum int 25
durationScale.maximum
_________________________________________________________________
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 component
keywords separated by spaces. Valid component keywords include: Color,
Font, Backdrop, Keyboard, Mouse, Beep, Screen, Window, and Startup. The
default componentList value is: Color Font Backdrop Keyboard Mouse Beep
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 in the Beep
dialog.
toneScale.minimum
Specifies the minimum value to be used for the tone slider in the Beep
dialog.
durationScale.maximum
Specifies 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
systemFont2 SystemFont2 FontList see SF2 below
systemFont3 SystemFont3 FontList see SF3 below
systemFont4 SystemFont4 FontList see SF4 below
systemFont5 SystemFont5 FontList see SF5 below
systemFont6 SystemFont6 FontList see SF6 below
systemFont7 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:
-dt-interface system-medium-r-normal-xxs*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-xs*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-s*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-m*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-l*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-xl*-*-*-*-*-*-*-*-*:
-dt-interface system-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:
userFont\V[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:
-dt-interface user-medium-r-normal-xxs*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-xs*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-s*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-m*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-l*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-xl*-*-*-*-*-*-*-*-*:
-dt-interface user-medium-r-normal-xxl*-*-*-*-*-*-*-*-*:
Color and backdrop resources: Global to the desktop
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
______________________________________________________
The display type determines default.
ColorUse
Specifies the number of colors to use for the user interface. The
default value for this resource is dependent 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 system. 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 two 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 system. The color palettes use four
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 system. The color palettes use eight
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 ColorUse
_____________________
2-3 B_W
4 LOW_COLOR
6 MEDIUM_COLOR
8+ HIGH_COLOR
_____________________
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 session. 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 dedicated
to foreground that changes in response to the background 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
bottomShadowPixmap 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
four or fewer color planes (16 or fewer color cells), and False
for systems with more than fewer color planes.
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 written 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
__________________________________________________________
int 3
primaryColorSetId
PrimaryColorSetId
int 4
secondaryColorSetId
SecondaryColorSetId
__________________________________________________________
primaryColorSetId
This resource specifies the primary color for an application.
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 application.
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
________________________________________________________
activeColorSetId ActiveColorSetId int 1
int 2
inactiveColorSetId
InactiveColorSetId
________________________________________________________
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.
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 style manager
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.
*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 available 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 you push Set Home
Session...
palette named `%s' already exists. This new palette will
overwrite the old one. Is this what you want to do?
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 applications
are restarted. Other mouse values take effect immediately.
Mouse dialog - Message appears in a warning dialog after you select 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 immediately.
Mouse dialog - Message appears in a warning dialog after you select 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 you select 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 you select 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 you click on an area outside of the Style Manager main window
area.
Couldn't open bitmap directory `%s'.
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.
RESTRICTIONS
Only a single copy of dtstyle is permitted to run per CDE session. Attempts
to start a second copy of dtstyle will fail and log an error to the
$HOME/.dt/errorlog file.
Color palettes cannot be customized in the current version if the graphics
adapter is running in Truecolor or Directcolor visual mode. These devices
provide a read-only colormap. In this mode, the buttons for Add, Delete,
and Modify are dimmed in the Style Manager Color dialog box. The workaround
for creating custom color palettes is to start the X server in Pseudocolor
visual mode by modifying the X server startup line in
/etc/dt/config/Xservers. See the Common Desktop Environment: Advanced
User's and System Administrator's Guide for more information on customizing
startup files.
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 customization.
SEE ALSO
Dtsession
Acts as a color server and runs the screen saver clients.
Dtwm
The window manager can be restarted when certain environment
customization operations are performed so that changes can take effect.
![Index](../TOC.GIF) |
Index for Section 1 |
|
![Index](../INDEX.GIF) |
Alphabetical listing for D |
|
![Top of page](../REW.GIF) |
Top of page |
|