INQUIRE INTERIOR FACILITIES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pinq_int_facs ( type, h_len, h_st, error_ind, facil, tot_h_len )
Pinttype;workstation type
Pinth_len;length of hatch style list
Pinth_st;starting position
Pint∗error_ind;OUT error indicator
Pint_facs∗facil;OUT interior facilities
Pint∗tot_h_len;OUT len of hatch list in PHIGS

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.

h_lenThe number of elements for which memory is allocated in the output parameter facil→hatches.ints. 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 hatch styles, starting with h_st. The structure is defined as follows:

typedef struct {
Pintnum_int_styles;/∗ number of interior styles ∗/
Pint_style∗int_styles[5];/∗ list of available interior styles ∗/
Pint_listhatch_styles;/∗ list of available hatch styles ∗/
Pintnum_pred_inds;/∗ number of predefined interior bundles ∗/
} Pint_facs;

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

PSTYLE_HOLLOW Hollow
PSTYLE_SOLIDSolid
PSTYLE_PATPatterned
PSTYLE_HATCH Hatched
PSTYLE_EMPTY Empty

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 h_len parameter.

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.

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 (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

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

Museum