Previous: , Up: Screens   [Contents][Index]


4.2 Screen Attributes

In CLX, each display screen is represented by a screen structure. The display-roots function returns the list of screen structures for the display. The following paragraphs discuss the attributes of CLX screen structures.

Function: screen-backing-stores screen
screen

A screen.

Returns a value indicating when the screen supports backing stores, although it may be storage limited in the number of windows it can support at once. The value returned can be one of :always, :never, or :when-mapped.

backing-stores-type

One of :always, :never, or :when-mapped.

Function: screen-black-pixel screen
screen

A screen.

Returns the black pixel value for the specified screen.

black-pixel

Type pixel.

Function: screen-default-colormap screen
screen

A screen.

Returns the default-colormap for the specified screen. The default-colormap is initially associated with the root window. Clients with minimal color requirements creating windows of the same depth as the root may want to allocate from this map by default. Most routine allocations of color should be made out of this colormap.

default-colormap

Type colormap.

Function: screen-depths screen
screen

A screen.

Returns an association list that specifies what drawable depths are supported on the specified screen. Elements of the returned association list have the form (depth visual*), where each visual is a visual-info structure. Pixmaps are supported for each depth listed, and windows of that depth are supported if at least one visual type is listed for the depth. A pixmap depth of one is always supported and listed, but windows of depth one might not be supported. A depth of zero is never listed, but zero-depth :input-only windows are always supported.

depths

Type alist.

Function: screen-event-mask-at-open screen
screen

A screen.

Returns the initial root event mask for the specified screen.

event-mask-at-open

Type mask32.

Function: screen-height screen
screen

A screen.

Returns the height of the specified screen in pixel units.

height

Type card16.

Function: screen-height-in-millimeters screen
screen

A screen.

Returns the height of the specified screen in millimeters. The returned height can be used with the width in millimeters to determine the physical size and the aspect ratio of the screen.

height-in-millimeters

Type card16.

Function: screen-max-installed-maps screen
screen

A screen.

Returns the maximum number of colormaps that can be installed simultaneously with install-colormap.

max-installed-colormaps

Type card16.

Function: screen-min-installed-maps screen
screen

A screen.

Returns the minimum number of colormaps that can be guaranteed to be installed simultaneously.

min-installed-colormaps

Type card16.

Function: screen-p screen
screen-p

Type boolean.

Returns non-nil if the screen argument is a

Function: screen-plist screen
screen

A screen.

Returns and (with setf) sets the property list for the specified screen. This function provides a hook where extensions can add data.

plist

Type list.

Function: screen-root screen
screen

A screen.

Returns the root-window for the specified screen. This function is useful with functions that take a parent window as an argument. The class of the root window is always :input-output.

root-window

Type window or null.

Function: screen-root-depth screen
screen

A screen.

Returns the depth of the root window for the specified screen. Other depths can also be supported on this screen.

root-window-depth

Type image-depth.

Function: screen-root-visual screen
screen

A screen.

Returns the default visual type for the root window for the specified screen.

root-window-visual

Type card29.

Function: screen-save-unders-p screen
screen

A screen.

If true, the server can support the save-under mode in create-window and in changing window attributes.

save-unders-p

Type boolean.

Function: screen-white-pixel screen
screen

A screen.

Returns the white pixel value for the specified screen.

white-pixel

Type pixel.

Function: screen-width screen
screen

A screen.

Returns the width of the specified screen in pixel units.

width

Type card16.

Function: screen-width-in-millimeters screen
screen

A screen.

Returns the width of the specified screen in millimeters. The returned width can be used with the height in millimeters to determine the physical size and the aspect ratio of the screen.

width-in-millimeters

Type card16.


Previous: , Up: Screens   [Contents][Index]