NAME

INQUIRE CURVE AND SURFACE FACILITIES - inquire for 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 )

Pwstype          type;            workstation type
Pint             cat_len;         length of curve approximation types list
Pint             cat_st;          starting position
Pint             sat_len;         length of surface approximation types list
Pint             sat_st;          starting position
Pint             tcat_len;        length of trim curve approximation types list
Pint             tcat_st;         starting position
Pint             psc_len;         length of parametric surface characteristics list
Pint             psc_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 approximation types list
Pint             * tot_sat_len;   OUT total length of surface approximation types list
Pint             * tot_tcat_len;  OUT total length of trim curve approximation types list
Pint             * tot_psc_len;   OUT total length of parametric surface characteristics
                                  list

FORTRAN Syntax

SUBROUTINE pqcsf ( WKTYPE, ICAT, ISAT, ITCAT, IPSC, ERRIND, MBSORD, MTCORD, NCAT, CAT, NSAT, SAT, NTCAT, TCAT, NPSC, PSC )

INTEGER      WKTYPE       workstation type
INTEGER      ICAT         list element of curve approximation type requested
INTEGER      ISAT         list element of surface approximation type requested
INTEGER      ITCAT        list element of trim curve approximation type requested
INTEGER      IPSC         list element of parametric surface characteristics requested
INTEGER      ERRIND       OUT error indicator
INTEGER      MBSORD       OUT maximum non-uniform rational B-spline order
INTEGER      MTCORD       OUT maximum trimming curve order
INTEGER      NCAT         OUT number of available curve approximation types
INTEGER      CAT          OUT ICAT-th element of list of available curve
                          approximation types
INTEGER      NSAT         OUT number of available surface approximation types
INTEGER      SAT          OUT ISAT-th element of list of available surface
                          approximation types
INTEGER      NTCAT        OUT number of available trim curve approximation types
INTEGER      TCAT         OUT ITCAT-th element of list of available trim curve
                          approximation types

INTEGER      NPSC         OUT number of available parametric surface
                          characteristics types
INTEGER      PSC          OUT IPSC-th element of list of available parametric surface
                          characteristics 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 PLUS and is not part of the PHIGS standard.

C Input Parameters

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

type

The workstation type in question.

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

cat_st

The 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_st

The 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_st

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.

facil

A pointer to a Pcurvsurf_facs structure, which returns the requested information. Pcurvsurf_facs is defined as:

typedef struct {

Pint      max_bsp_order;     /* maximum B-spline order * /
Pint      max_tc_order;      /* maximum trim curve order * /
Pint_list cat_types;         /* list of curve approximation types * /
Pint_list sat_types;         /* list of surface approximation types * /
Pint_list tcat_types;        /* list of trim curve approximation
                                types * /
Pint_list psc_types;         /* list of parametric surface

characteristics types * /

} Pcurvsurf_facs;

Pint_list is defined as:

typedef struct {

Pint

num_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.

FORTRAN Input Parameters

WKTYPE

The workstation type in question.

ICAT

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

ISAT

The 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.

IPSC

The index of the entry desired from the parametric surface characteristics list.

FORTRAN Output Parameters

ERRIND

The error number of any error detected by this function.

MBSORD

The maximum B-spline order supported.

MTCORD

The maximum trimming curve order supported.

NCAT

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

CAT

The requested entry of the curve approximation type list.

NSAT

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

SAT

The requested entry of the surface approximation type list.

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

types.

TCAT

The requested entry of the trimming curve approximation type list.

NPSC

The number of entries in the list of available parametric surface characteristics types.

PSC

The requested entry of the parametric surface characteristics 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, then 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 nonavailability.

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

ERRORS

002

Ignoring function, function requires state (PHOP, * ,* ,* )

051

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

052

Ignoring function, workstation type not recognized by the implementation

062

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

SEE ALSO

PHIGS WORKSTATION DESCRIPTION TABLE (7P)

NON-UNIFORM B-SPLINE CURVE (3PP)

NON-UNIFORM B-SPLINE SURFACE (3PP)

SET CURVE APPROXIMATION CRITERIA (3PP)

SET PARAMETRIC SURFACE CHARACTERISTICS (3PP)

SET SURFACE APPROXIMATION CRITERIA (3PP)