KCMS Calibrator Tool Loadable Interface Guide
この本のみを検索
PDF 文書ファイルをダウンロードする

Data Structures

5

This chapter describes the data structures used by Calibrator Tool.

KCMSCData


  typedef struct _KCMSCData {  
    int                   size;/* number of data sets */  
    KcsCalibrationData ** data;/* pointers to data sets */  
  } KCMSCData;  

KCMSCData is a structure that collects data. For monitor calibration, the size element must be equivalent in value to numVisuals in the KCMSCVisuals structure. (For more information on numVisuals, see "KCMSCVisuals" on page 24 in this chapter.)
The members in this structure are described below:
size..........Is the number of sets of data. For monitors, the value must be equivalent to the value of numVisuals.
KcsCalibrationData..Is a variable array of pointers to KcsCalibrationData structures. KcsCalibrationData contains an array of input values for the profiles (supplied by Calibrator Tool) and an array of output values (results of measurements) that represent the color response of the device. (For details on the KcsCalibrationData type, see Chapter 3, "Data Structures" in the KCMS Application Developer's Guide.)
iv>

KCMSCVisuals


  typedef struct _KCMSCVisuals {  
    Display * display;  
    int       screen;  
    int       numVisuals;/* dynamic array size */  
    XVisualInfo ** visuals;/* visuals to get data for */  
  
  } KCMSCVisuals;  

KCMSCVisuals is a structure that identifies to the loadable module the display and visuals upon which to perform measurements. The members in this structure are described below:
displayIs a Display pointer. The Display pointer is for use when the loadable module makes an X library call (such as XCreateWindow) to connect to the local windowing system. (For details on Display, see the XLib Programming Manual.)
screenIs the screen number to be used in Xll calls. Calibrator Tool fills in the value of this field.
numVisualsIs the number of X visuals for which color measurement data is needed. Calibrator Tool fills in the value of this field based on the number of X visuals to be updated. (For details, see "Slow and Fast Mode Measurements" on page 20 in Chapter 4, "Measuring Monitor Response.")
visualsIs an array of XVisualInfo pointers. (See "XVisualInfo" below for the format of this structure.)

XVisualInfo

The XVisualInfo structure has the format shown below. For details on the members of this structure, see the XLib Programming Manual.

  typedef struct {  
       Visual* visual;  
       VisualID visualid;  
       int screen_num;  
       unsigned int depth;  
       int class;  
       unsigned long red_mask;  
       unsigned long green_mask;  
       unsigned long blue_mask;  
       int colormap_size; /* Same as map_entries member of Visual */  
       int bits_per_rgb;  
  } XVisualInfo;