APPLICATION DATA(3P) — SUNPHIGS LIBRARY

NAME

APPLICATION DATA − create a structure element containing application data

SYNOPSIS

C Syntax

void
papplicationdata ( data )
Pdata∗data;application data

FORTRAN Syntax

SUBROUTINE pap ( LDR, DATREC )
INTEGERLDRdimension of data record array
CHARACTER∗80DATREC(LDR) data record

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

The APPLICATION DATA subroutine puts a structure element containing application data into the currently open structure.

If the current edit mode is INSERT, the APPLICATION DATA element is inserted into the currently open structure after the element currently pointed to by the element pointer. If the edit mode is REPLACE, the APPLICATION DATA element replaces the element pointed to. In either case, the element pointer is updated to point to the new APPLICATION DATA element.

C Input Parameter

data
A pointer to a Pdata structure containing the application data. Pdata is defined in phigs.h as follows:

typedef struct {
Pintsize;/∗ size of data ∗/
Pchar∗data;/∗ pointer to data ∗/
} Pdata;

The size component specifies the number of bytes the data component is pointing to.

FORTRAN Input Parameters

LDR
The dimension of the DATREC array.

DATREC
A character array containing the application data.

Execution

The APPLICATION DATA element is ignored during structure traversal.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum