gescape(3G)

NAME

gescape − input or output to 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);

DESCRIPTION

Input Parameters

fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.

op Operation to be performed on the device.

Input/Output Parameters

arg1 and arg2 Pointers to argument lists.

Discussion

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

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