Name

PSPSR − Associates the parametric surface index with the specified parameters. 

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

Syntax

PSPSR (WKID, PSI, ACRI, LDRAC, DARECA, PSCTY, LDRPS, DARECP)

Argument        Data Type      Access   Description
---------------------------------------------------------------------------
WKID            Integer        Read     Workstation identifier
PSI             Integer        Read     Parametric surface index
ACRI            Integer        Read     Parametric surface approximation
                                        criteria type
LDRAC           Integer        Read     Length of the data record array for
                                        the surface approximation criteria
                                        data
DARECA(LDRAC)   Character ∗80  Read     Data record for the surface
                                        approximation criteria
PSCTY           Integer        Read     Parametric surface characteristics
                                        type
LDRPS           Integer        Read     Length of the data record array for
                                        the parametric surface
                                        characteristics
DARECP(LDRPS)   Character ∗80  Read     Data record for the parametric
                                        surface characteristics
---------------------------------------------------------------------------

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)
PSCTY                PNOPC        None
                     PWDPC        Workstation-dependent type
                     PICPC        Isoparametric curve
                     PLCMPC       Level curve, in modeling coordinates
                     PLCWPC       Level curve, in world coordinates
Curve placement      PUOSCP       Over the surface
types
                     PUBKCP       Between knots
---------------------------------------------------------------------------

Description

PSPSR associates the parametric surface index with the specified parameters.  The parametric surface bundle table has predefined entries taken from the workstation description table. You can set any entry, including the predefined entries, with this function. 

During structure traversal, Digital PHIGS uses the current parametric surface representation entry in the PHIGS traversal state list to select an entry in the parametric surface bundle table.  If the entry corresponding to this index is undefined, Digital PHIGS uses the entry corresponding to index 1. 

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 or DCSDSA, 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 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 PSCTY is PNOPC or PWDPC, there is no data record. 

If PSCTY 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 PSCTY is PLCMPC, the data record format is as follows:

INTEGER IL    = 1      Number of integer elements
INTEGER IA(1) =        Number of parameters (NP)
INTEGER RL    = 6+NP   Number of real elements
        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 PSCTY is PLCWPC, the data record format is as follows:

INTEGER IL    = 1      Number of integer elements
INTEGER IA(1) =        Number of parameters (NP)
INTEGER RL    = 6+NP   Number of real elements
        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   = ()