GESCAPE(3G)

NAME

gescape − input or output to a device in a device dependent manner.

SYNOPSIS

C SYNTAX

void gescape(fildes,op,arg1,arg2)
int fildes, op;
gescape_arg *arg1,*arg2;

FORTRAN77 SYNTAX

        subroutine gescape(fildes,op,arg1,arg2)
        integer*4 fildes,op,
        integer*4 arg1(64),arg2(64)
or
        real arg1(64),arg2(64)
or
        character arg1(255),arg2(255)

PASCAL SYNTAX

procedure gescape(fildes,op:integer;
var arg1,arg2:gescape_arg);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when an I/O path to a graphic device is opened.
op
identifies the operation to be performed on the device.

INPUT/OUTPUT PARAMETERS

arg1 and arg2
are pointers to argument lists.

DISCUSSION

The device driver is called with the operation code and the pointers to the two argument lists. The results of the operation are device dependent and are explained in the Starbase Device Driver Library.

In C, gescape_arg is defined in <starbase.c.h> as:
     typedef union {
             int   i[64];
             float f[64];
             char c[255];
     } gescape_arg;

In Pascal, gescape_arg is defined in <starbase.p1.h> as:
     gescape_arg = record
                   case integer of
                        0: (i : array[1..64] of integer);
                        1: (f : array[1..64] of real);
                        2: (c : array[1..255] of char);
                   end;

Museum