NAME

INQUIRE INTERIOR FACILITIES − inquire list of workstation interior facilities from the workstation description table

SYNOPSIS

C Syntax

void
pinqintfacil ( type, i_len, i_st, h_len, h_st, error_ind, facil, tot_i_len, tot_h_len )
Pwstypetype;workstation type
Pinti_len;length of interior style list
Pinti_st;starting position
Pinth_len;length of hatch style list
Pinth_st;starting position
Pint∗error_ind;OUT error indicator
Pinterfac∗facil;OUT interior facilities
Pint∗tot_i_len;OUT len of interior list in PHIGS
Pint∗tot_h_len;OUT len of hatch list in PHIGS

FORTRAN Syntax

SUBROUTINE pqif ( WTYPE, NI, NH, ERRIND, NIS, IS, NHS, HS, NPFAI )
INTEGERWTYPEworkstation type
INTEGERNIlist element of interior styles requested
INTEGERNHlist element of hatch styles requested
INTEGERERRINDOUT error indicator
INTEGERNISOUT number of available interior styles
INTEGERISOUT NIth element of list of available interior
styles
INTEGERNHSOUT number of available hatch styles
INTEGERHSOUT NHth element of list of available hatch
style indices
INTEGERNPFAIOUT number of predefined interior indices

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE INTERIOR FACILITIES obtains a list of the available interior styles and hatch styles for the specified type of workstation. 

C Input Parameters

typeGet the interior facilities for this workstation type. 

i_lenThe number of elements for which memory is allocated in the output parameter facil->interiors.  0 may be specified in order to get the tot_i_len. 

i_stStarting position in the list of interior styles at which to begin the inquiry. 

h_lenThe number of elements for which memory is allocated in the output parameter facil->hatches.integers.  0 may be specified in order to get the tot_h_len. 

h_stStarting position in the list of hatch styles at which to begin the inquiry. 

C Output Parameters

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

facilA pointer to an allocated data structure in which the system returns a portion of the list of available interior styles, starting with i_st and a portion of the list of available hatch styles, starting with h_st.  The structure is defined as follows:

typedef struct {
Pint    n_inter;/∗ number of interior styles ∗/
Pinterstyle∗interiors;/∗ list of available interior styles ∗/
Pintlst hatches;/∗ list of available hatch sytles ∗/
Pint    predefined;/∗ number of predefined interior bundles ∗/
} Pinterfac;

Pinterstyle is an enumerated type for the following
interior styles; one of:

PHOLLOWHollow
PSOLIDSolid
PPATTERNPatterned
PHATCHHatched
PEMPTYEmpty

Pintlst is defined in phigs.h as follows:

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

Prior to calling this function, the integers field of the Pintlst structures and interiors must contain a pointer to an application supplied buffer. This buffer must be at least as large as the corresponding length parameter. 

tot_i_len
A pointer to an integer in which the system returns the total number of items in the workstation list of interior styles. This is the value required by i_len if all the items in the list are to be returned. 

tot_h_len
A pointer to an integer in which the system returns the total number of items in the workstation list of hatch styles. This is the value required by h_len if all the items in the list are to be returned. 

FORTRAN Input Parameters

WTYPE
Get the interior facilities for this workstation type. 

NIThe number of entry desired from the list of interior styles. 

NHThe number of entry desired from the list of hatch styles. 

FORTRAN Output Parameters

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

NISThe total number of items in the workstation list of interior styles. 

ISThe NIth element of the list of interior styles; one of

PHOLLOHollow
PSOLIDSolid
PPATTRPatterned
PHATCHHatched
PISEMPEmpty

NHSThe total number of elements in the list of hatch styles. 

HSThe NHth element of the list of hatch styles. 

NPFAI
The number of predefined interior bundles. 

ERRORS

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

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

052Ignoring function, workstation type not recognized by the implementation

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

PHIGS WORKSTATION DESCRIPTION TABLE(7)
INQUIRE PREDEFINED INTERIOR REPRESENTATION (3P+)

Sun Release 4.0  —  Last change: 24 July 1989