NAME

INQUIRE PHIGS FACILITIES− inquire the current list of PHIGS facilities defined in the PHIGS description table

SYNOPSIS

C Syntax

void
pinq_phigs_facs ( length, start, error_ind, open_ws, open_ar, num_names, char_sets, length_list, norm_filt, inv_filt )
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗open_ws;OUT max. num. simultaneously open ws
Pint∗open_ar;OUT max. num. simultaneously open archive files
Pint∗num_names;OUT number of available names for name sets
Pint_list∗char_sets;OUT list of character sets
Pint∗length_list;OUT length of list in PHIGS
Pint∗norm_filt;OUT maximum length of norm filter list for ISS
Pint∗inv_filt;OUT maximum length of inverted filter list for ISS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE PHIGS FACILITIES to obtain a list of the available PHIGS facilities from the PHIGS description table. 

C Input Parameters

lengthThe number of list elements for which the application has allocated memory in the output parameter char_sets→ints.  0 may be specified, in order to have length_list return the total number of elements in the list of character sets. 

startThe starting position in the list at which the inquiry is to begin. 

C Output Parameters

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

open_ws
A pointer to an integer that returns the maximum number of simultaneously open workstations supported. 

open_ar
A pointer to an integer that returns the maximum number of simultaneously open archive files supported. 

num_names
A pointer to an integer that returns the number of available names for name sets.

char_sets
A pointer to a data structure that returns a portion of the list of available character sets, starting with the start number item.  Pint_list is defined in phigs.h as follows:

typedef struct {
Pint num_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

Prior to calling this function, the ints field of the Pint_list structure must contain a pointer to an application supplied buffer.  This buffer must be at least as large as the length parameter. 

length_list
A pointer to an integer that returns the length of the list in PHIGS. 

norm_filt
A pointer to an integer that returns the maximum length of the norm filter list for Incremental Spatial Search.

inv_filt
A pointer to an integer that returns the maximum length of the inverted filter list for Incremental Spatial Search.

ERRORS

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

SEE ALSO

PHIGS DESCRIPTION TABLE (7P)

September 02, 1992