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.4.6  vqp_state                                                 TOS

 Name:         »Inquire palette driver state« - Obtain the device 
               state of the Polaroid image recorder.

 Syntax:       void vqp_state ( int16_t handle, int16_t *port, int8_t 
               *film_name, int16_t *lightness, int16_t *interlace, 
               int16_t *planes, int16_t *indexes );

 Description:  The call vqp_state obtains the status of a Polaroid 
               image recorder. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                port       Number of the port (0 = first port)
                film_name  Number of the film name (0 to 4)
                lightness  Brightness (-3 to 3, where each step 
                           corresponds to a third of a stop)
                interlace  Image is scanned with (1) or without (0) 
                           interlace
                planes     Number of colours = 2^planes, where planes 
                           lies between 1 and 4
                indexes    Specifies the colours of the colour 
                           palette. 16 bytes of memory space is 
                           required. Each colour is identified by a 
                           number (for the rows of the colour matrix) 
                           and a letter between A and H (for the 
                           column of the colour matrix).

 Return value: The function does not return a result.

 Availability: This function is no longer available from PC-GEM 
               Version 2.0 onwards.

 Group:        Polaroid functions

 See Also:     GDOS   vsp_state   vsp_save   vsp_message   vqp_films