Resources for shading windows, icons, menus, and mattes

The following resources control the shading elements of windows, icons, menus, mattes, and icon images. Shading resources are most valuable when used with a monochrome display.

Shading resources

Name	Class	Value type	Default
Windows, icons, and menus
activeBackgroundPixmap	BackgroundPixmap	pixmap	varies +
activeBottomShadowPixmap	BottomShadowPixmap	pixmap	varies +
activeTopShadowPixmap	TopShadowPixmap	pixmap	varies +
backgroundPixmap	BackgroundPixmap	pixmap	varies +
bottomShadowPixmap	BottomShadowPixmap	pixmap	varies +
topShadowPixmap	TopShadowPixmap	pixmap	varies +
cleanText	CleanText	true/false	true
Mattes
matteBottomShadowPixmap	BottomShadowPixmap	pixmap	*bottomShadowPixmap
matteTopShadowPixmap	TopShadowPixmap	pixmap	*topShadowPixmap
Icon images
iconImageBottomShadowPixmap	BottomShadowPixmap	pixmap	*icon*bottomShadowPixmap
iconImageTopShadowPixmap	TopShadowPixmap	pixmap	*icon*topShadowPixmap

+

The default values for these resources are calculated dynamically, depending on your display and the values assigned to other color resources. For example, a monochrome display is assigned different default values than a color display.

All of the resources in this section, with the exception of cleanText, require a pixmap as a value. The following list describes the pixmap values that you can assign to these resources:

background

the background color (solid)

foreground

the foreground color (solid)

25_foreground

a mix of 25 percent foreground to 75 percent background

50_foreground

a mix of 50 percent foreground to 50 percent background

75_foreground

a mix of 75 percent foreground to 25 percent background

horizontal_tile

horizontal lines alternating between the foreground and background colors

slant_left

diagonal lines slanting to the left, alternating between the foreground and background colors

slant_right

diagonal lines slanting to the right, alternating between the foreground and background colors

vertical_tile

vertical lines alternating between the foreground and background colors

The resources listed in ``Shading resources'' are described in more detail below:

activeBackgroundPixmap (Class: BackgroundPixmap)
This resource specifies the pixmap used as the background in the window manager decorations of an active window. (This is a component appearance resource.)

activeBottomShadowPixmap (Class: BottomShadowPixmap)
This resource specifies the pixmap used for the lower and right bevels of the active window frame. (This is a component appearance resource.)

activeTopShadowPixmap (Class: TopShadowPixmap)
This resource specifies the pixmap used for the upper and left bevels of the active window frame. (This is a component appearance resource.)

backgroundPixmap (Class: BackgroundPixmap)
This resource specifies the background pixmap used to decorate the window frame of an inactive window. (This is a component appearance resource.)

bottomShadowPixmap (Class: BottomShadowPixmap)
This resource specifies the pixmap used in the lower and right bevels of all inactive window manager frames. (This is a component appearance resource.)

cleanText (Class: CleanText)
This resource can be used to make text easier to read on monochrome systems where a backgroundPixmap resource is specified. If this resource is set to ``true,'' text appearing in a window's title and in the window manager's dialog boxes is displayed with a clear background. If this resource is ``false,'' text is drawn directly on top of the existing background, even if the background uses a pattern. The default value for this resource is ``true.'' (This is a specific appearance and behavior resource.)

iconImageBottomShadowPixmap (Class: BottomShadowPixmap)
This resource specifies the pixmap used for the bottom shadow of the icon image. The default value is the pixmap specified by the *icon*bottomShadowPixmap window manager resource. (This is a component appearance resource.)

iconImageTopShadowPixmap (Class: TopShadowPixmap)
This resource specifies the pixmap used for the top shadow of the icon image. The default value is the pixmap specified by the *icon*topShadowPixmap window manager resource. (This is a client-specific resource.)

matteBottomShadowPixmap (Class: BottomShadowPixmap)
This resource specifies the pixmap used for the bottom shadow of the matte. This resource is used only if matteWidth is greater than zero. The default value is the pixmap specified by the *bottomShadowPixmap or the *client*bottomShadowPixmap window manager resource. (This is a client-specific resource.)

matteTopShadowPixmap (Class: TopShadowPixmap)
This resource specifies the pixmap used for the top shadow of the matte. This resource is used only if matteWidth is greater than zero. The default value is the pixmap specified by the *topShadowPixmap or the *client*topShadowPixmap window manager resource. (This is a client-specific resource.)

topShadowPixmap (Class: TopShadowPixmap)
This resource specifies the pixmap used in the top and left bevels of all inactive window frames. (This is a component appearance resource.)