PQPSR(3g) — Subroutines

Name

PQPSR − Returns parametric surface representation.

Operating States: PHOP, ∗, ∗, ∗
PHIGS PLUS function

Syntax

PQPSR (WKID, PSI, TYPE, MLDRSA, MLDRPS, ERRIND, ACRI,
LDRSA, DARECS, PSCH, LDRPS, DARECP)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WKID              Integer        Read      Workstation identifier
PSI               Integer        Read      Parametric surface bundle index
TYPE              Integer        Read      Type of values to return
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
Curve placement      PUOSCP       Curve placement over surface
                     PUBKCP       Curve placement between knots
---------------------------------------------------------------------------

Description

PQPSR returns the parametric surface representation, including the surface approximation data and the surface characteristics.

Digital PHIGS Version 3.1 does not support this function.

Data Record Information 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+6 contain parameters
        SL    = 0
        LSTR = ()
        STR   = ()

Museum