hpux man page for xcmsscreeninitproc

XcmsScreenInitProc()													      XcmsScreenInitProc()

Name
  XcmsScreenInitProc - interface specification for the Function Set routine 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  suc-
  cessful, the procedure fills in the XcmsPerScrnInfo structure as follows:

  o  It sets the screenData member to the address of the created device profile data structure (contents known only by the function set).

  o  It next sets the screenWhitePoint member.

  o  It next sets the functionSet member to the address of the XcmsFunctionSet structure.

  o  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:

  o  XcmsInitNone indicates initialization has not been previously attempted.

  o  XcmsInitFailure indicates initialization has been previously attempted but failed.

  o  XcmsInitSuccess indicates initialization has been previously attempted and succeeded.

See Also
  XcmsFunctionSet, XcmsScreenFreeProc.

Xlib - Device-independent Color 											      XcmsScreenInitProc()