CDE/cde/doc/C/guides/man/man4/dtdpfile.sgm

<!-- $XConsortium: dtdpfile.sgm /main/6 1996/09/08 20:17:29 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->

<RefEntry Id="CDEMX.MAN79.rsml.1">
<RefMeta>
<RefEntryTitle>dtdpfile</RefEntryTitle>
<ManVolNum>special file</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Filename>dtdpfile</Filename></RefName>
<RefPurpose>format and location of desktop palette files
</RefPurpose>
</RefNameDiv>
<!-- CDE Common Source Format, Version 1.0.0-->
<!-- *************************************************************************-->
<!-- **  (c) Copyright 1993, 1994 Hewlett-Packard Company-->
<!-- **  (c) Copyright 1993, 1994 International Business Machines Corp.-->
<!-- **  (c) Copyright 1993, 1994 Sun Microsystems, Inc.-->
<!-- **  (c) Copyright 1993, 1994 Novell, Inc.-->
<!-- *************************************************************************-->
<RefSynopsisDiv>
<Synopsis>#<Emphasis>color 1 background RBG data
#</Emphasis><Emphasis>color 2 background RBG data
#</Emphasis><Emphasis>color 3 background RBG data
#</Emphasis><Emphasis>color 4 background RBG data
#</Emphasis><Emphasis>color 5 background RBG data
#</Emphasis><Emphasis>color 6 background RBG data
#</Emphasis><Emphasis>color 7 background RBG data
#</Emphasis><Emphasis>color 7 background RBG data</Emphasis></Synopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>A palette is a color scheme used to color a CDE
workspace and the CDE components.
</Para>
<Para>A <Literal>palette</Literal> file provides the set of eight background colors that
make up a color palette.
</Para>
<Para>A variety of palettes are provided with the CDE.
As part of the default palette set there are several palettes designed
specifically to work well on monochrome and gray scale displays.
</Para>
<Para>The <Emphasis>Style Manager</Emphasis> is the desktop graphical user interface tool
which is used to add, delete, or modify a color palette.
The end user should never need to act on the palette file directly.
</Para>
<Para>All palette files have a <Filename>.dp</Filename> suffix.
The file contents are the
eight colors of the palette, specified as RGB values in hexadecimal.
</Para>
<Para>The palette files provided with the system are located in the directory
<Filename>/usr/dt/palettes/C</Filename>.
</Para>
<Para>User specific palette files are located in <SystemItem Class="EnvironVar">HOME</SystemItem><Filename>/.dt/palettes</Filename>.
</Para>
<Para>The <Emphasis>Style Manager</Emphasis> resource <Literal>paletteDirectories</Literal> can be used
to specify additional directories where palettes are located.
</Para>
<Para>When a user creates a new palette, it is located in <SystemItem Class="EnvironVar">HOME</SystemItem><Filename>/.dt/palettes</Filename>.
System palettes that the user has modified are also located in this directory.
When a user deletes a palette, that palette is placed in the
<SystemItem Class="EnvironVar">HOME</SystemItem><Filename>/.dt/palettes</Filename> directory with a <Literal>~</Literal> prefix.
If it was a user
specified palette, the original file is removed.
System palettes are never
removed.
If the user has a <Literal>~</Literal> copy of a system palette, that palette
will not appear in the list of available palettes in the <Emphasis>Style Manager</Emphasis>.
</Para>
</RefSect1>
<RefSect1>
<Title>RETURN VALUE</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>EXAMPLES</Title>
<Para>The following is an example of a palette file named <Literal>Julie.dp</Literal>:
</Para>
<InformalExample Remap="indent">
<ProgramListing>#a200e500c600
#3ffc93008d77
#2d2d4e4e7600
#78008900a500
#63ea7e189500
#3ec670ec8a00
#3d157d008400
#61006d098e00
</ProgramListing>
</InformalExample>
</RefSect1>
<RefSect1>
<Title>APPLICATION USAGE</Title>
<Para>None.
</Para>
</RefSect1>
<RefSect1>
<Title>SEE ALSO</Title>
<Para>&cdeman.dtsession;, &cdeman.dtstyle;.
</Para>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 01:31:55-->