NAME

INQUIRE ANNOTATION FACILITIES − inquire annotation text facilities on workstation type

SYNOPSIS

C Syntax

void
pinqannotationfacil ( type, length, start, error_ind, styles, total_length )
Pwstypetype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗styles;OUT list annotation styles
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqanf ( WTYPE, N, ERRIND, NAS, AS )
INTEGERWTYPEworkstation type
INTEGERNlist element of annotation styles requested
INTEGERERRINDOUT error indicator
INTEGERNASOUT number of available annotation styles
INTEGERASOUT Nth element of list of available
annotation styles

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE ANNOTATION FACILITIES to obtain a list of the annotation text facilities available on the specified workstation type. 

C Input Parameters

typeWorkstation type. 

lengthThe number of integers items in the styles output parameter for which the application has allocated memory.  The length is the number of list elements (annotation styles) that the system can return in the list of integers in the Pintlst structure under styles.  If a value of zero is used here, no data will be returned in this list, but the total number of annotation styles available on the specified workstation type will be returned in total_length. 

startStarting position in the workstation type list of available annotation styles at which the inquiry is to begin.  The elements of the list of annotation styles, beginning with the item number specified by start, are copied sequentially into the list of integers until it is full or all the annotation styles have been copied. 

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

stylesA pointer to a Pintlst structure in which the system returns the list of annotation styles available on the specified type of workstation.  Pintlst is defined in phigs.h as follows:

typedef struct {
Pintnumber;/∗ number of Pints in list ∗/
Pint∗integers;/∗ list of integers ∗/
} Pintlst;

The number component specifies the number of annotation styles in the list. The integers component is a pointer to a list, number long, of the annotation styles.  The application must allocate memory for length elements in the list of integers.

total_length
A pointer to an integer in which the total number of elements in the specified workstation type list of annotation styles is returned. This is the value required for length if all annotation styles are to be returned. 

FORTRAN Input Parameters

WTYPE
Workstation type.

NElement of the specified workstation type list of available annotation styles to return.  Only one annotation style may be inquired upon per subroutine call.  If a value of zero is used here, no annotation style data will be returned, but the total number of elements in the workstation type list of available annotation styles will be returned in NAS. 

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

NASThe total number of elements in the specified workstation type list of available annotation styles. 

ASThe Nth annotation style from the specified workstation type list of available annotation styles. 

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

052Ignoring function, workstation type not recognized by the implementation

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

SEE ALSO

ANNOTATION TEXT RELATIVE (3P)
ANNOTATION TEXT RELATIVE 3 (3P)
PHIGS WORKSTATION DESCRIPTION TABLE(7)

Sun Release 4.0  —  Last change: 24 July 1989