scoScreenInfo(D4nfb)

scoScreenInfo -- screen information

Synopsis

#include "scoext.h"

Description

The scoScreenInfo structure communicates information between the OS layer of the X server and the display driver. The structure is primarily used for screen switching and server shutdown. The display driver code must set up this structure in its xxxData.c file. It is then passed to the ScoOSInit routine along with a screen pointer.

Structure definition

typedef struct _scoScreenInfo {
	ScreenPtr pScreen;
	void (*SetGraphics) (ScreenPtr pScreen);
	void (*SetText) (ScreenPtr pScreen);
	void (*SaveGState) (ScreenPtr pScreen);
	void (*RestoreGstate) (ScreenPtr pScreen);
	void (*CloseScreen) (ScreenPtr pScreen);
	Bool exposeScreen;
	Bool isConsole;
	Bool runSwitched;
	float version;
} scoScreenInfo;

Structure members

The members are:

pScreen: pointer to the Screen structure associated with this screen. This member can only be modified by the SYS later.
SetGraphics: pointer and prototype for driver's SetGraphics(D3nfb) function.
SetText: pointer and prototype for driver's SetText(D3nfb) function.
SaveGState: saves the current state of the graphics adapter, if necessary. The graphics memory itself may not need to be saved; see the exposeScreen member.
RestoreGstate: restores the state of the graphics adapter particularly, the current colormap, from the information saved by SaveGState.
CloseScreen: pointer and prototype for driver's CloseScreen(D3nfb) function.
exposeScreen: The caller sets this if the entire screen is to receive an expose event when the current multiscreen is regained. On some adapters, this can be used to refresh video memory completely because the server is forced to redraw all windows.
isConsole: TRUE if this screen is the console screen. Reserved for future use.
runSwitched: TRUE if the DDX layer can continue to draw while the server is not the current multiscreen.
version: Link Kit version number with which the DDX was developed. Set this to the constant XSCO_VERSION defined in the scoext.h file.

Version applicability

This structure is supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.

References

scoSysInfoInit(D3nfb)