cde/programs/dtstyle/dtstyle.man

   1 .\" $XConsortium: dtstyle.man /main/2 1995/07/17 10:51:43 drk $
   2 .TH DTSTYLE 1X
   3 .ds ]W HP DT 3.0
   4 .SH NAME
   5 \fBdtstyle - HP DT Style Manager.\fP
   6 .sp 1
   7 .SH SYNOPSIS
   8 .B dtstyle
   9 .sp 1
  10 .SH DESCRIPTION
  11 \fIDtstyle\fP is the HP DT Style Manager application that provides
  12 an interactive method of customizing the visual elements and system behavior
  13 of HP DT.  The Style Manager buttons represent customization tasks
  14 for the following:
  15 .sp 1
  16 .IP "\fBColor\fP"
  17 Select workspace colors and palettes.
  18 .IP "\fBFonts\fP"
  19 Select application font sizes.
  20 .IP "\fBBackdrop\fP"
  21 Select workspace backdrop patterns.
  22 .IP "\fBKeyboard\fP"
  23 Set key click volume or character repeat capability.
  24 .IP "\fBMouse\fP"
  25 Change mouse button order, double-click speed, pointer
  26 acceleration or pointer movement threshold.
  27 .IP "\fBAudio\fP"
  28 Change the beeper volume, tone, or duration.
  29 .IP "\fBScreen\fP"
  30 Choose the number of minutes before your screen times out or
  31 whether or not your screen is covered and locked at time out.
  32 .IP "\fBWindow\fP"
  33 Specify how a window aquires focus, if the window raises when it
  34 receives focus, or where window icons are placed.
  35 .IP "\fBStartup\fP"
  36 Specify how your session begins and ends.
  37 .sp 1
  38 .SH STYLE MANAGER SPECIFIC RESOURCES
  39 The following resources control the appearance and behavior of
  40 \fIStyle Manager\fP.
  41 .sp 1
  42 .TS
  43 center;
  44 cB sss
  45 lB lB lB lB
  46 l l l l.
  47 Style Manager Resources
  48 Name    Class   Type    Default
  49 _
  50 componentList   ComponentList   string  see below*
  51 paletteDirectories      PaletteDirectories      string  NULL
  52 writeXrdbImmediate      WriteXrdbImmeidate      Boolean true
  53 .TE
  54 .sp 1
  55 .IP "\fBcomponentList\fP"
  56 Specifies the Style Manager components with a list of component keywords
  57 separated by spaces.  Valid component keywords include:
  58 Color, Font, Backdrop, Keybaord, Mouse, Audio, Screen, Dtwm, and Startup.
  59 The default componentList value is: Color Font Backdrop Keyboard Mouse Audio
  60 Screen Dtwm Startup.
  61 The componentList resource for a Dtlite session is: Color Backdrop
  62 Font Dtwm.
  63 .sp 1
  64 .IP "\fBpaletteDirectories\fP"
  65 Specifies a list of the directories (separated by spaces) where additional
  66 color palettes are located.
  67 These palette files are used to generate the list of color
  68 palettes that a user may select from in the Color dialog.
  69 In addition to this list palettes are also searched for in
  70 /usr/dt/palettes and $HOME/.dt/palettes.
  71 .sp 1
  72 .IP "\fBwriteXrdbImmediate\fP"
  73 Controls when new font size or new mouse double-click time resources are
  74 used.  If True, new resources are used when new clients start.  If False,
  75 new resources are used at the next session (after logout, with "Resume
  76 Current Session" selected in the Startup dialog, and login).
  77 .sp 3
  78 .SH "COLOR AND BACKDROP RESOURCES: GLOBAL TO HP DT"
  79 The following resources are used by more than one HP DT component.
  80 The syntax for specifying global resources is:
  81 .EX
  82     \fB*\fIresource_id\fR
  83 .EE
  84 .sp 1
  85 .TS
  86 center;
  87 cB sss
  88 lB lB lB lB
  89 l l l l.
  90 Color and Backdrop Resources: Global
  91 Name    Class   Type    Default
  92 _
  93 backdropDirectory       BackdropDirectory       string  /usr/dt/icons/Dtbackdrops
  94 colorUse        ColorUse        int     dynamic*
  95 dynamicColor    DynamicColor    Boolean true
  96 foregroundColor ForegroundColor int     dynamic*
  97 shadowPixmaps   ShadowPixmaps   int     dynamic*
  98 writeXrdbColors WriteXrdbColors Boolean true
  99 .TE
 100 .ps 7
 101 \h'50p'*The display type determines default.
 102 .ps
 103 .sp 1
 104 .IP "\fBbackdropDirectory\fP"
 105 Specifies the directory location for the backdrops listed
 106 in the backdrop dialog.  This resource is also used
 107 by dtwm.
 108 .sp 1
 109 .IP "\fBcolorUse\fP"
 110 Specifies the number of colors to use for the user interface.
 111 The default value for this resource is determined by querying
 112 the X server for the number of color cells on the system.
 113 Valid values are:
 114 .RS
 115 .IP \(bu 3
 116 \fBB_W\fP \(em  Specifies a black and white system.
 117 The color palettes use only Black and Whte (color cells 0 and 1) and
 118 icons are displayed as bitonal images.
 119 In this configuration four color palettes are available:
 120 Black, White, BlackWhite and WhiteBlack.
 121 These palettes do not dynamically change.  To change a palette,
 122 the HP Dt session must be restarted.
 123 This resource value forces \fBshadowPixmaps\fP to True, and
 124 \fBforegroundColor\fP to either black or white depending on the palette
 125 chosen.
 126 .IP \(bu 3
 127 \fBLOW_COLOR\fP \(em Specifies a low color system.
 128 The color palettes use 2 color sets and icons are displayed as bitonal
 129 images.
 130 The number of color cells can be further reduced by using the resources
 131 \fBshadowPixmaps\fP and \fBforegroundColor\fP.
 132 .IP \(bu 3
 133 \fBMEDIUM_COLOR\fP \(em Specifies a medium color system.
 134 The color palettes use 4 color sets and icons are displayed as bitonal
 135 images.
 136 The number of color cells can be further reduced by using the resources
 137 \fBshadowPixmaps\fP and \fBforegroundColor\fP.
 138 .IP \(bu 3
 139 \fBHIGH_COLOR\fP \(em Specifies a high color system.
 140 The color palettes use 8 color sets and icons are displayed as
 141 multi-color images.
 142 The number of color cells can be reduced by using the resources
 143 \fBshadowPixmaps\fP and \fBforegroundColor\fP.
 144 .RE
 145 .sp 1
 146 .TS
 147 center;
 148 RC
 149 cB| Bc.
 150 planes  ColorUse
 151 _
 152 2-3     B_W
 153 4       LOW_COLOR
 154 6       MEDIUM_COLOR
 155 8+      HIGH_COLOR
 156 .TE
 157 .sp 1
 158
 159 .IP "\fBdynamicColor\fP"
 160 This resource can have values of True or False.  \fBdynamicColor\fP is
 161 used to reduce the number of color cells being used.  Once a palette has
 162 been selected and it is not likely to be changed,  \fBdynamicColor\fP can
 163 be set to False.
 164 If set to False colors cannot be dynamically changed using the DT
 165 style manager. A selected
 166 palette will take effect the next session.
 167 The next time the session comes up, the color server uses Read Only
 168 color cells that can be shared by all clients, thus reducing
 169 the number of color cells used.
 170
 171 .IP "\fBforegroundColor\fP"
 172 This resource can have values of White, Black or Dynamic.
 173 \fBforegroundColor\fP causes all text (foreground) to use either pixel 0
 174 or 1 (Black
 175 or White) or to have a color cell dedicated to foreground that changes in
 176 response to the background color (Dynamic) for each ColorSet.
 177 If set to White or Black, the number of color cells used per ColorSet is
 178 reduced by 1.
 179 .IP "\fBshadowPixmaps\fP"
 180 For color systems, this resource can have a value of True or False.
 181 If True, \fBtopShadowColor\fP and \fBbottomShadowColor\fP use the same
 182 pixel as background and \fBtopShadowPixmap\fP and
 183 \fBbottomShadowPixmap\fP are specified
 184 instead of solid color to create the 3D look.
 185 This reduces the number of color cells per ColorSet by 2.
 186 \fBshadowPixmaps\fP defaults to True for systems with 4 or less color planes
 187 (16 or less color cells),
 188 and False for systems with more than 4 color planes.
 189 .IP "\fBwriteXrdbColors\fP"
 190 This resource should only be used if you are running non HP Motif 1.1 clients
 191 that have color schemes that conflict with HP DT colors.  This has no
 192 impact on clients linked with the Motif 1.1 library.  This resource
 193 specifies whether color resource information should be written out.
 194 If set to False, \fBbackground\fP and \fBforeground\fP resources are not
 195 written out with the values of the current palette.  This means that
 196 non HP Motif 1.1 clients do not get HP DT colors when they are started.
 197 The default value is True.
 198 .RE
 199 .sp 1
 200 .SH "COLOR RESOURCES: CLIENT SPECIFIC"
 201 The following resources are specified on a per client bases.
 202 The syntax for specifying client-specific resources is
 203 .EX
 204    \fB\fIclient_name_or_class\fB*\fIresource_id\fR
 205 .EE
 206 .sp 1
 207 .TS
 208 center;
 209 cB sss
 210 lB lB lB lB
 211 l l l l.
 212 Color Resource Set: Client Specific
 213 Name    Class   Type    Default
 214 _
 215 primaryColorSetId       PrimaryColorSetId       int     3
 216 secondaryColorSetId     SecondaryColorSetId     int     4
 217 .TE
 218 .sp 1
 219 .RS
 220 .IP "\fBprimaryColorSetId\fP"
 221 This resource specifies the primary color for an application.
 222 The primary color is used for the main background areas of the application
 223 and all children of the main area.
 224 The value of this resource is a number from one to eight that represents
 225 a specific color set in a palette.
 226 .IP "\fBsecondaryColorSetId\fP"
 227 This resource specifies the secondary color for an application.
 228 The secondary color is used for the menubar and all menus and dialogs
 229 of the application.
 230 This allows dialogs on the screen to be visually associated with its parent
 231 application by matching the dialog color to the menubar.
 232 The value of this resource is a number from one to eight that represents
 233 a specific color set in a palette.
 234 .RE
 235 .sp 1
 236 .SH "COLOR RESOURCES: DTWM SPECIFIC"
 237 The following are Dtwm-specific resources.
 238 .sp 1
 239 .TS
 240 center;
 241 cB sss
 242 lB lB lB lB
 243 l l l l.
 244 Color Resource Set: Dtwm specific
 245 Name    Class   Type    Default
 246 _
 247 activeColorSetId        ActiveColorSetId        int     1
 248 inactiveColorSetId      InactiveColorSetId      int     2
 249 .TE
 250 .sp 1
 251 .RS
 252 .IP "\fBactiveColorSetId\fP"
 253 Specifies the active frame color for \fIdtwm\fP.  The value
 254 of this resource is a number from one to eight, which represents a specific
 255 color set in a palette.
 256 .IP "\fBinactiveColorSetId\fP"
 257 Specifies the inactive frame color for \fIdtwm\fP.  The value
 258 of this resource is a number from one to eight, which represents a specific
 259 color set in a palette.
 260 .RE
 261 .sp2
 262 .TS
 263 center;
 264 cB sss
 265 lB lB lB lB
 266 l l l l.
 267 Font Resource Set
 268 Name    Class   Type    Default
 269 _
 270 numFonts        NumFonts        int     7
 271 systemFont1     SystemFont1     FontList        -bitstream-swiss*742-medium-r-normal--13-100-72-72-p-75-hp-roman8
 272 systemFont2     SystemFont2     FontList        -bitstream-swiss*742-medium-r-normal--14-90-85-85-p-81-hp-roman8
 273 systemFont3     SystemFont3     FontList        -bitstream-swiss*742-bold-r-normal--16-120-72-72-p-94-hp-roman8
 274 systemFont4     SystemFont4     FontList        -bitstream-swiss*742-bold-r-normal--17-140-85-85-p-100-hp-roman8
 275 systemFont5     SystemFont5     FontList        -bitstream-swiss*742-medium-r-normal--19-140-85-85-p-110-hp-roman8
 276 systemFont6     SystemFont6     FontList        -bitstream-swiss*742-medium-r-normal--23-196-85-85-p-133-hp-roman8
 277 systemFont7     SystemFont7     FontList        -bitstream-swiss*742-medium-r-normal--26-171-110-110-p-150-hp-roman8
 278 userFont1       UserFont1       FontList        -adobe-courier-medium-r-normal--10-100-75-75-m-60-hp-roman8
 279 userFont2       UserFont2       FontList        -adobe-courier-medium-r-normal--12-120-75-75-m-70-hp-roman8
 280 userFont3       UserFont3       FontList        -bitstream-prestige-medium-r-normal--16-120-72-72-m-80-hp-roman8
 281 userFont4       UserFont4       FontList        -bitstream-prestige-medium-r-normal--17-128-72-72-m-90-hp-roman8
 282 userFont5       UserFont5       FontList        -bitstream-prestige-medium-r-normal--19-160-72-72-m-110-hp-roman8
 283 userFont6       UserFont6       FontList        -bitstream-prestige-medium-r-normal--23-179-85-85-m-120-hp-roman8
 284 userFont7       UserFont7       FontList        -bitstream-prestige-medium-r-normal--26-171-110-110-m-140-hp-roman8
 285 .TE
 286 .sp 1
 287 .RS
 288 .IP "\fBnumFonts\fP"
 289 Specifies the number of System/User Font pairs presented in the Font dialog.
 290 .IP "\fBsystemFont[1-7]\fP"
 291 Specifies a SystemFont for a particular font size that can be selected in
 292 the Font dialog.
 293 .IP "\fBuserFont[1-7]\fP"
 294 Specifies a UserFont for a particular font size that can be selected in
 295 the Font dialog.
 296 .RE
 297 .sp1
 298 .SH COPYRIGHT
 299 Copyright 1990 Hewlett-Packard Company.
 300 .sp1
 301 .SH ORIGIN
 302 Hewlett-Packard Company UTD-CV.
 303 .sp 1
 304 .SH SEE ALSO
 305 \fBX(1)\fP, \fBdtsession(1X)\fP, \fBdtwm(1X)\fP.