screen

screen Class

Summary

An object that represents a known monitor screen.

Package

capi

Superclasses

capi-object

Subclasses

color-screen
mono-screen

Initargs

`:width`	The width in pixels of the screen.
`:height`	The height in pixels of the screen.
`:number`	The screen number.
`:depth`	The number of color planes in the screen.
`:interfaces`	A list of all of the interfaces visible on the screen.

Readers

screen-width
screen-height
screen-number
screen-depth
screen-interfaces
screen-width-in-millimeters
screen-height-in-millimeters

Description

The class screen represents the screen of a monitor.

When the CAPI initializes itself it creates one or more screen objects and they are then used to specify where a window is to appear. A screen object can also be queried for information that the program may need to know about the screen that it is working on, such as its width, height and depth.

On Microsoft Windows and Cocoa there is exactly one CAPI screen. When there are multiple monitors, there are several rectangles of pixels within the single CAPI screen.

On Motif, there is one CAPI screen for each X11 screen.

Compatibility note

In LispWorks for Macintosh 4.3 there is one CAPI screen for each Cocoa screen. In LispWorks for Macintosh 4.4 and later, there is exactly one CAPI screen.

Examples

(setq screen (capi:convert-to-screen))

(capi:screen-width screen)

(capi:screen-height screen)

(capi:display (make-instance 
               'capi:interface :title "Test")
                               :screen screen)

(capi:screen-interfaces screen)