NAME

INQUIRE CURVE AND SURFACE FACILITIES − inquire the available curve and surface facilities of a workstation type

SYNOPSIS

C Syntax

void
pinq_curv_surf_facs ( type, cat_len, cat_st, sat_len, sat_st, tcat_len, tcat_st, psc_len,
psc_st, error_ind, facil, tot_cat_len, tot_sat_len, tot_tcat_len, tot_psc_len )
Pinttype;workstation type
Pintcat_len;length of curve approx types list
Pintcat_st;starting position
Pintsat_len;length of surface approx types list
Pintsat_st;starting position
Pinttcat_len;length of trim curve approx types list
Pinttcat_st;starting position
Pintpsc_len;length of parametric surface characteristics list
Pintpsc_st;starting position
Pint∗error_ind;OUT error indicator
Pcurvsurf_facs∗facil; OUT curve and surface facilities
Pint∗tot_cat_len;OUT total length of curve approx types list
Pint∗tot_sat_len;OUT total length of surface approx types list
Pint∗tot_tcat_len; OUT total length of trim curve approx types list
Pint∗tot_psc_len;OUT total length of parametric surface characteristics list

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE CURVE AND SURFACE FACILITIES returns the available curve and surface facilities associated with the specified workstation type. 

C Input Parameters

All of the following data types are predefined in phigs.h. 

typeThe workstation type in question. 

cat_len
The number of entries to return from the list of curve approximation types.

cat_stThe starting position of the portion of the list to return. 

sat_len
The number of entries to return from the list of surface approximation types.

sat_stThe starting position of the portion of the list to return. 

tcat_len
The number of entries to return from the list of trimming curve approximation types.

tcat_st
The starting position of the portion of the list to return.

psc_len
The number of entries to return from the list of parametric surface characteristics.

psc_stThe starting position of the portion of the list to return. 

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 a Pcurvsurf_facs structure which returns the requested information.  Pcurvsurf_facs is defined as:

typedef struct {
Pintmax_bsp_order;/∗ maximum B-spline order ∗/
Pintmax_pp_order;/∗ maximum parametric polynomial order ∗/
Pintmax_tc_order;/∗ maximum trim curve order ∗/
Pint_listppc_types;/∗ list of parametric polynomial curve types ∗/
Pint_listpps_types;/∗ list of parametric polynomial surface types∗/
Pint_listcat_types;/∗ list of curve approximation types ∗/
Pint_listsat_types;/∗ list of surface approximation types ∗/
Pint_listtcat_types;/∗ list of trim curve approximation types ∗/
Pint_listpsc_types;/∗ list of parametric surface characteristics types ∗/
Pintnum_pred_inds;/∗ number of predefined bundles ∗/
} Pcurvsurf_facs;

Pint_list is defined as:

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

Prior to calling this function, the integers field of the Pint_list structures must contain a pointer to an array of integers.  This array must be at least as large as the corresponding len parameter. 

tot_cat_len
A pointer to an integer which returns the total length of the curve approximation type list as stored in the workstation description table.

tot_sat_len
A pointer to an integer which returns the total length of the surface approximation type list as stored in the workstation description table.

tot_tcat_len
A pointer to an integer which returns the total length of the trimming curve approximation type list as stored in the workstation description table.

tot_psc_len
A pointer to an integer which returns the total length of the parametric surface characteristics. list as stored in the workstation description table.

Execution

If the inquired information is available, the error indicator is returned as zero and values are returned in the output parameters. 

If the inquired information is not available, the values returned in the output parameters are undefined and the error indicator is set to one of the error numbers listed below to indicate the reason for non-availability. 

Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function. 

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 (7P)
NON-UNIFORM B-SPLINE CURVE (3P+)
NON-UNIFORM B-SPLINE SURFACE (3P+)
SET CURVE APPROXIMATION CRITERIA (3P+)
SET SURFACE APPROXIMATION CRITERIA (3P+)
SET TRIMMING CURVE APPROXIMATION CRITERIA (3P+)

September 02, 1992