NAME

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

SYNOPSIS

C Syntax

void
pinqcurvsurffacil ( wstype, ppc_length, ppc_start, pps_length, pps_start, sat_length, sat_start, cat_length,
    cat_start, tcat_length, tcat_start, error_ind, facil, tot_ppc_length, tot_pps_length, tot_cat_length,
    tot_sat_length, tot_tcat_length )
Pwstypewstype;workstation type
Pintppc_length;length of parametric polynomial curve type list to return
Pintppc_start;index of first element of list to return
Pintpps_length;length of parametric polynomial surface type list to return
Pintpps_start;index of first element of list to return
Pintcat_length;length of curve approximation criteria type list to return
Pintcat_start;index of first element of list to return
Pintsat_length;length of surface approximation criteria type list to return
Pintsat_start;index of first element of list to return
Pinttcat_length;length of trim curve approximation criteria type list to return
Pinttcat_start;index of first element of list to return
Pint∗error_ind;OUT error indicator
Pcurvsurffac∗facil; OUT curve and surface facilities
Pint∗tot_ppc_length; OUT total number of parametric polynomial curve types
Pint∗tot_pps_length; OUT total number of parametric polynomial surface types
Pint∗tot_cat_length; OUT total number of curve approximation types
Pint∗tot_sat_length; OUT total number of surface approximation types
Pint∗tot_tcat_length; OUT total number of trim curve approximation types

FORTRAN Syntax

SUBROUTINE pqcsf ( WKTYPE, IPPC, IPPS, ICAT, ISAT, ITCAT, ERRIND, MBSORD,
     MPPORD, MTCORD, NPPC, PPC, NPPS, PPS, NCAT, CAT, NSAT, SAT, NTCAT, TCAT )
INTEGERWKTYPEworkstation type
INTEGERIPPClist element of parametric polynomial curve type requested
INTEGERIPPSlist element of parametric poly surface type requested
INTEGERICATlist element of curve approximation type requested
INTEGERISATlist element of surface approximation type requested
INTEGERITCATlist element of trim curve approximation type requested
INTEGERERRINDOUT error indicator
INTEGERMBSORDOUT maximum non-uniform rational B-spline order
INTEGERMPPORDOUT maximum uniform parametric polynomial order
INTEGERMTCORDOUT maximum trimming curve order
INTEGERNPPCOUT number of available parametric polynomial curve types
INTEGERPPCOUT IPPC-th element of list of available parametric polynomial curve types
INTEGERNPPSOUT number of available parametric polynomial surface types
INTEGERPPSOUT IPPS-th element of list of available parametric polynomial surface types
INTEGERNCATOUT number of available curve approximation types
INTEGERCATOUT ICAT-th element of list of available curve approximation types
INTEGERNSATOUT number of available surface approximation types
INTEGERSATOUT ISAT-th element of list of available surface approximation types
INTEGERNTCATOUT number of available trim curve approximation types
INTEGERTCATOUT ITCAT-th element of list of available trim curve approximation types

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. 

This is a SunPHIGS Extension function based on PHIGS+ and is not part of the PHIGS standard. 

C Input Parameters

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

wstypeThe workstation type in question. 

ppc_length
The number of entries to return from the list of parametric polynomial curve types.

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

pps_length
The number of entries to return from the list of parametric polynomial surface types.

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

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

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

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

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

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

tcat_start
The 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 Pcurvsurffac structure which returns the requested information.  Pcurvsurffac 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 ∗/
Pintlstppc_types;/∗ list of parametric polynomial curve types ∗/
Pintlstpps_types;/∗ list of parametric polynomial surface types∗/
Pintlstcat_types;/∗ list of curve approximation types ∗/
Pintlstsat_types;/∗ list of surface approximation types ∗/
Pintlsttcat_types;/∗ list of trim curve approximation types ∗/
} Pcurvsurffac;

Pintlst is defined as:

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

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

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

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

tot_cat_length
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_length
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_length
A pointer to an integer which returns the total length of the trimming curve approximation type list as stored in the workstation description table.

FORTRAN Input Parameters

WKTYPE
The workstation type in question.

IPPCThe index of the entry desired from the parametric polynomial curve type list. 

IPPSThe index of the entry desired from the parametric polynomial surface type list. 

ICATThe index of the entry desired from the curve approximation type list. 

ISATThe index of the entry desired from the surface approximation type list. 

ITCAT
The index of the entry desired from the trimming curve approximation type list.

FORTRAN Output Parameters

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

MBSORD
The maximum B-spline order supported.

MPPORD
The maximum parametric polynomial order supported.

MTCORD
The maximum trimming curve order supported.

NPPCThe number of entries in the list of available parametric polynomial curve types. 

PPCThe requested entry of the parametric polynomial curve type list. 

NPPSThe number of entries in the list of available parametric polynomial surface types. 

PPSThe requested entry of the parametric polynomial surface type list. 

NCATThe number of entries in the list of available curve approximation types. 

CATThe requested entry of the curve approximation type list. 

NSATThe number of entries in the list of available surface approximation types. 

SATThe requested entry of the surface approximation type list. 

NTCAT
The number of entries in the list of available trimming curve approximation types.

TCATThe requested entry of the trimming curve approximation type list. 

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

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

SEE ALSO

PHIGS WORKSTATION DESCRIPTION TABLE(7)
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+)

Sun Release 4.0  —  Last change: 2 August 1989