PQPPSR(3g) — Subroutines
Name
PQPPSR − Returns predefined parametric surface type and data for the index.
Operating States: PHOP, ∗, ∗, ∗
PHIGS PLUS function
Syntax
PQPPSR (WTYPE, PPSI, MLDRSA, MLDRPS, ERRIND, ACRI,
LDRSA, DARECS, PSCH, LDRPS, DARECP)
Argument Data Type Access Description
---------------------------------------------------------------------------
WTYPE Integer Read Workstation type
PPSI Integer Read Predefined parametric surface
bundle index
MLDRSA Integer Write Dimension of the surface
approximation criteria data
record array
MLDRPS Integer Write Dimension of the parametric
surface characteristics data
record array
ERRIND Integer Write Error indicator
ACRI Integer Write Surface approximation criteria
type
LDRSA Integer Write Length of the surface
approximation criteria data record
DARECS(MLDRSA) Character ∗80 Write Parametric surface criteria
data record
PSCH Integer Write Parametric surface characteristic
type
LDRPS Integer Write Length of the parametric surface
characteristics data record
DARECP(MLDRPS) Character ∗80 Write Parametric surface
characteristics data record
---------------------------------------------------------------------------
Constants
Defined Argument Constant Description
---------------------------------------------------------------------------
ACRI PWDSA Workstation-dependent method
PCBKSA Constant parametric subdivision between
knots
PCSWSA Chordal size, in world coordinates
PCSNSA Chordal size, in normalized projection
coordinates
PCSDSA Chordal size, in world coordinates
PPDWSA Planar deviation, in world coordinates
PPDNSA Planar deviation, in normalized projection
coordinates
PPDDSA Planar deviation, in device coordinates
PRWSA Relative, in world coordinates
PRNSA Relative, in normalized projection
coordinates
PRDSA Relative, in device coordinates
DCSDSA Constant subdivision (non-PEX only)
DIDSA Implementation-dependent method (PEX only)
PSCH PNOPC None
PWDPC Workstation-dependent characteristics
PICPC Isoparametric curve
PLCMPC Level curve, in modeling coordinates
PLCWPC Level curve, in world coordinates
Placement types PUOSCP Curve placement over surface
PUBKCP Curve placement between knots
---------------------------------------------------------------------------
Description
PSPPSR queries the workstation description table and returns the parametric surface type and surface data for the specified index.
Digital PHIGS Version 3.1 does not support this function.
Data Record Format for the Surface Approximation Criteria
If ACRI is PWDSA, there is no data record.
If ACRI is PCBKSA, the data record has the following format:
INTEGER IL = 2 Number of integer values
INTEGER IA(1) = Number of subdivisions between knots in u
INTEGER IA(2) = Number of subdivisions between knots in v
RL = 0
RA = ()
SL = 0
LSTR = ()
STR = ()
If ACRI is PCSWSA, PCSNSA, or PCSDSA, the data record has the following format:
IL = 0
IA = ()
INTEGER RL = 2 Number of real elements
REAL RA(1) = U approximation value
REAL RA(2) = V approximation value
SL = 0
LSTR = ()
STR = ()
If ACRI is PPDWSA, PPDNSA, PPDDSA, PRWSA, PRNSA, or PRDSA, the data record has the following format:
IL = 0
IA = ()
INTEGER RL = 1 Number of real elements
REAL RA(1) = Approximation value
SL = 0
LSTR = ()
STR = ()
If ACRI is DCSDSA, the data record has the following format:
INTEGER IL = 2 Number of integer values
INTEGER IA(1) = U count
INTEGER IA(2) = V count
RL = 0
RA = ()
SL = 0
LSTR = ()
STR = ()
If ACRI is DIDSA, the data record has the following format:
IL = 0
IA = 0
RL = 2 Number of reals
RA(1) = U approximation value
RA(2) = V approximation value
SL = 0
LSTR = ()
STR = ()
Data Record Format for the Parametric Surface Characteristics
If PSCH is PNOPC or PWDPC, there is no data record.
If PSCH is PICPC, the data record format is as follows:
INTEGER IL = 3
INTEGER IA(1) = Curve placement (PUOSCP or PUBKCP)
INTEGER IA(2) = Curve count in the u direction
INTEGER IA(3) = Curve count in the v direction
RL = 0
RA = ()
SL = 0
LSTR = ()
STR = ()
If PSCH is PLCMPC, the data record format is as follows:
INTEGER IL = 1
INTEGER IA(1) = Number of parameters (NP)
RL = 6+NP
RA(1) = x-coordinate of the origin point, in
modeling coordinates
RA(2) = y-coordinate of the origin point, in
modeling coordinates
RA(3) = z-coordinate of the origin point, in
modeling coordinates
RA(4) = x-coordinate of the direction vector, in
modeling coordinates
RA(5) = y-coordinate of the direction vector, in
modeling coordinates
RA(6) = z-coordinate of the direction vector, in
modeling coordinates
RA = Elements 7 through NP+6 contain parameters
SL = 0
LSTR = ()
STR = ()
If PSCH is PLCWPC, the data record format is as follows:
INTEGER IL = 1
INTEGER IA(1) = Number of parameters (NP)
INTEGER RL = 6+NP
RA(1) = x-coordinate of the origin point, in
world coordinates
RA(2) = y-coordinate of the origin point, in
world coordinates
RA(3) = z-coordinate of the origin point, in
world coordinates
RA(4) = x-coordinate of the direction vector, in
world coordinates
RA(5) = y-coordinate of the direction vector, in
world coordinates
RA(6) = z-coordinate of the direction vector, in
world coordinates
RA = Elements 7 through NP contain parameters
SL = 0
LSTR = ()
STR = ()
See Also
PQEPSI
PQPSR
PSPSR