XcmsScreenInitProc()XcmsScreenInitProc()NameXcmsScreenInitProc – interface specification for the Function Set rou‐
tine that obtains and initializes per-screen information.
Synopsis
typedef Status (*XcmsScreenInitProc)(display, screen_number,
screen_info)
Display *display;
int screen_number;
XcmsPerScrnInfo *screen_info;
Arguments
display Specifies the connection to the X server.
screen_number
Specifies the appropriate screen number on the host server.
screen_info
Specifies the XcmsPerScrnInfo structure, which contains the
per-screen information.
Returns
Zero on failure, non-zero on success.
Availability
Release 5 and later.
Description
The screen initialization function in the XcmsFunctionSet structure
fetches the Color Characterization Data (device profile) for the speci‐
fied screen, typically off properties on the screen's root window; then
it initializes the specified XcmsPerScrnInfo structure. If successful,
the procedure fills in the XcmsPerScrnInfo structure as follows:
· It sets the screenData member to the address of the created device
profile data structure (contents known only by the function set).
· It next sets the screenWhitePoint member.
· It next sets the functionSet member to the address of the XcmsFunc‐
tionSet structure.
· It then sets the state member to XcmsInitSuccess and finally returns
XcmsSuccess.
If unsuccessful, the procedure sets the state member to XcmsInitFailure
and returns XcmsFailure.
Structures
The XcmsPerScrnInfo structure contains:
typedef struct _XcmsPerScrnInfo {
XcmsColor screenWhitePoint;
XPointer functionSet;
XPointer screenData;
unsigned char state;
char pad[3];
} XcmsPerScrnInfo;
The screenWhitePoint member specifies the white point inherent to the
screen. The functionSet member specifies the appropriate Function Set.
The screenData member specifies the device profile. The state member
is set to one of the following:
· XcmsInitNone indicates initialization has not been previously
attempted.
· XcmsInitFailure indicates initialization has been previously
attempted but failed.
· XcmsInitSuccess indicates initialization has been previously
attempted and succeeded.
See Also
XcmsFunctionSet, XcmsScreenFreeProc.
Xlib - Device-independent Color XcmsScreenInitProc()