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-File8.12.13  graf_xhandle                                              TOS

 Name:         »Graphics handle« - Obtain ID of the VDI workstation.

 Opcode:       77

 Syntax:       int16_t graf_xhandle ( int16_t *gr_hwchar, int16_t 
               *gr_hhchar, int16_t *gr_hwbox, int16_t *gr_hhbox, 
               int16_t *device );

 Description:  The call graf_xhandle obtains the ID of the screen 
               workstation to which the AES outputs. The following 
               apply:

                Parameter  Meaning

                gr_hwchar  Width, and
                gr_hhchar  Height of a character from the system font, 
                           in points
                gr_hwbox   Width, and
                gr_hhbox   Height of a cell into which any character 
                           from the system font fits completely
                device     Workstation handle of the AES (vdi_device)

               Note: The information from the parameters gr_hwbox or 
               gr_hhbox is used be the AES for the width of the 
               individual window components.

 Return value: The function returns the ID (handle) of the opened VDI 
               workstation.

 Availability: Since KAOS 1.4

 Group:        Graphics library

 See Also:     Binding   v_opnvwk   graf_handle