Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filev_opnvwk()
Graphics Library
graf_handle()                                                           AES

Syntax

WORD graf_handle( wcell, hcell, wbox, hbox );
WORD *wcell, *hcell, *wbox, *hbox;

Function       graf_handle() returns important information regarding the
               physical workstation currently in use by the AES.

Opcode         77 (0x4D)

Availability   All AES versions.

Parameters     wcell and hcell are WORD pointers which on function exit
               will be filled in with the width and height, respectively,
               of the current system character set.
               wbox and hbox are WORD pointers which on function exit
               will be filled in with the width and height, respectively,
               of the minimum bounding box of a BOXCHAR character.

Binding        crys_if(0x4D);

               *charw = intout[1];
               *charh = intout[2];
               *boxw = intout[3];
               *boxh = intout[4];

               return intout[0];

Return Value   This function returns the VDI handle for the current
               physical workstation used by the AES.

Caveats        There is currently no defined method of handling an error
               generated by this function.

Comments       The return value of this function is required to open
               a virtual screen workstation.

See Also       v_opnvwk()

Group          Graphics Library