application_data(3G)

NAME

application_data − insert application data into the currently open segment

SYNOPSIS

C Syntax:

void application_data(fildes, count, data)
int fildes, count;
char *data;

FORTRAN77 Syntax:

subroutine application_data(fildes, count, data)
integer*4 fildes, count
character*(*) data

Pascal Syntax:

procedure application_data(fildes, count:integer;
var data:packed array[lo..hi:integer] of char);

DESCRIPTION

Input Parameters

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

count Specifies the number of bytes of application data to be inserted into a segment. Any non-negative value can be used.

data Buffer containing the data to be inserted into a segment.

Discussion

Application_data inserts an application data element containing the specified application data into the currently open segment of the specified graphics device.

This data is not examined by the display list subsystem. Application data is ignored when it is encountered during traversal.

To retrieve application data from a segment, use inq_application_data_size(3G) and inq_application_data(3G).

ERRORS

1 Graphics device is not initialized for this operation.

6 Invalid parameter value - count less than 0.

24 Segment not open.

Museum

Related Articles