INQUIRE GENERALIZED DRAWING PRIMITIVE 3(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE GENERALIZED DRAWING PRIMITIVE 3 − inquire generalized drawing primitive3 attributes

SYNOPSIS

C Syntax

void
pinqgdp3 ( type, gdp, error_ind, num_atts, atts )
Pwstypetype;workstation type
Pintgdp;3D GDP identifier
Pint∗error_ind;OUT error indicator
Pint∗num_atts;OUT number of attributes used
Pattrsatts[5];OUT list of attributes used

FORTRAN Syntax

SUBROUTINE pqgdp3 ( WTYPE, GDP, ERRIND, NBND, BNDL )
INTEGERWTYPEworkstation type
INTEGERGDP3D GDP identifier
INTEGERERRINDOUT error indicator
INTEGERNBNDOUT number of sets of attributes used
INTEGERBNDL(5)OUT list of sets of attributes used

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE GENERALIZED DRAWING PRIMITIVE 3 to determine the sets of attributes used by the specified 3D generalized drawing primitive. The representation of the generalized drawing primitive at a given workstation will be controlled by zero or more sets of polyline, polymarker, text, interior, and edge attributes, as indicated by this inquiry function. Whether bundle indices or the corresponding individual attributes are used will depend on the values of the appropriate aspect source flags at traversal time.

C Input Parameters

typeType of workstation for which to inquire the generalized drawing primitive 3 attributes.

gdpThe identifier of the generalized drawing primitive 3 for which to inquire attributes.

C Output Parameters

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

num_atts
A pointer to an integer in which the number of sets of attributes used by the specified generalized drawing primitive 3 on workstations of type type is returned.

attsAn array of type Pattrs in which num_atts values are returned indicating which of five possible sets of attributes are used by the specified generalized drawing primitive 3 on workstations of type type. Note that the application must specify an array that is large enough for five values (the maximum number that could be returned). Pattrs is an enumerated type defining the following types of attribute sets:

PPOLYLINE(polyline attributes)
PPOLYMARKER(marker attributes)
PTEXT(text attributes)
PINTERIOR(interior attributes)
PEDGE(edge attributes)

FORTRAN Input Parameters

WTYPE
Type of workstation for which to inquire the generalized drawing primitive 3 attributes.

GDPThe identifier of the generalized drawing primitive 3 for which to inquire attributes.

FORTRAN Output Parameters

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

NBNDAn integer in which the number of sets of attributes used by the specified generalized drawing primitive 3 on workstations of type WTYPE is returned.

BNDLAn integer array in which num_atts values are returned indicating which of five possible sets of attributes are used by the specified generalized drawing primitive 3 on workstations of type WTYPE. Note that the application must specify an array that is large enough for five values (the maximum number that could be returned). The following values may be returned in BNDL to indicate the attribute sets used:

PPLBND(polyline attributes)
PPMBND(polymarker attributes)
PTXBND(text attributes)
PINBND(interior attributes)
PEDBND(edge attributes)

ERRORS

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

052Ignoring function, workstation type not recognized by the implementation

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

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

064Ignoring function, the specified workstation type is not able to generate the specified generalized drawing primitive

Museum