Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.8.1.15  vs_calibrate                                             TOS

 Name:         »Set calibration« - Set colour calibration.

 Opcode:       5 (Escape 76)

 Syntax:       int16_t vs_calibrate ( int16_t handle, int16_t flag, 
               int16_t *rgb );

 Description:  The call vs_calibrate switches colour calibration on or 
               off and can be used to set a calibration table.

                Parameter  Meaning

                handle     Workstation identifier
                flag       Calibration:
                            0 =     Turn off
                            1 =     Turn on
                rgb        Pointer to calibration table, or NULL

               Note: A calibration table consists of 1001 RGB entries, 
               that allocate for the value range 0- to 1000- 
               thousandths of each input value a corrected thousandth 
               value. Before calling this function, one should use 
               vq_calibrate to check whether it is even present.

               The colour calibration is valid for the whole system 
               for the driver identified by handle. Hence it should 
               not be set by individual applications, but only with a 
               CPX module or a desk accessory.

 Return value: The function returns the value 0 if the calibration is 
               switched off, or the value 1 if this is switched on.

 Availability: No information to hand.

 Group:        Special graphic functions

 See Also:     Binding   vq_calibrate