PSPLP(3g) — Subroutines

Name

PSPLP − Modifies the entries in the extended polyline bundle table.

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

Old Syntax

DSPLRP (WKID, PLI, LTYPE, LWIDTH, CLRTYP, ICOLR, COLR, SHDMD,
APRXTP, LDR, DATREC)

Argument        Data Type     Access     Description
---------------------------------------------------------------------------
WKID            Integer       Read       Workstation identifier
PLI             Integer       Read       Polyline index
LTYPE           Integer       Read       Polyline type
LWIDTH          Real          Read       Line width scale factor
CLRTYP          Integer       Read       Polyline color type
ICOLR           Integer       Read       Polyline indexed color value
COLR(3)         Array of      Read       Polyline direct color value
                reals
SHDMD           Integer       Read       Polyline shading method
APRXTP          Integer       Read       Curve approximation criteria type
LDR             Integer       Read       Length of curve approximation data
                                         record
DATREC(LDR)     Array of      Read       Curve approximation data record
                character ∗80
---------------------------------------------------------------------------

New Syntax

PSPLP (WKID, PLI, LTYPE, LWIDTH, CTYPE, COLI, NCC, COLR, PLSM,
ACRI, LDR, DATREC)

Argument        Data Type     Access     Description
---------------------------------------------------------------------------
WKID            Integer       Read       Workstation identifier
PLI             Integer       Read       Polyline index
LTYPE           Integer       Read       Polyline type
LWIDTH          Real          Read       Line width scale factor
CTYPE           Integer       Read       Polyline color type
COLI            Integer       Read       Color index
NCC             Integer       Read       Number of color value components
COLR(NCC)       Array of      Read       Polyline direct color value
                reals
PLSM            Integer       Read       Polyline shading method
ACRI            Integer       Read       Curve approximation criteria type
LDR             Integer       Read       Length of curve approximation data
                                         record
DATREC(LDR)     Array of      Read       Curve approximation data record
                character ∗80
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
LTYPE                 PLSOLI        Solid line. This is the default
                                    value.
                      PLDASH        Dashed line.
                      PLDOT         Dotted line.
                      PLDASD        Dashed-dotted line.
CTYPE                 PINDIR        Indirect (indexed) color.
                      PRGB          Direct specification of red, green, and
                                    blue.
                      PCIE          Direct specification in the format of the
                                    Commission Internationale de l’Eclairage.
                      PHSV          Direct specification of hue, saturation,
                                    and value.
                      PHLS          Direct specification of hue, lightness,
                                    and saturation.
PLSM                  PNOIS         No interpolation, constant shading.
                      PCIS          Linear interpolation of color.
                      PDDIS         Interpolation of color based on dot
                                    products.
                      PDNIS         Interpolation of color based on normals.
ACRI                  PWDCA         Workstation-dependent method.
                      PCBKCA        Constant parametric subdivision between
                                    knots.
                      PCSWCA        Metric, in world coordinates.
                      PCSNCA        Metric, in normalized projection
                                    coordinates.
                      PCSDCA        Metric, in device coordinates.
                      PCDWCA        Chordal deviation, in world coordinates.
                      PCDNCA        Chordal deviation, in normalized.
                                    projection coordinates.
                      PCDDCA        Chordal deviation, in device coordinates.
                      PRWCA         Relative, in world coordinates.
                      PRNCA         Relative, in normalized projection
                                    coordinates.
                      PRDCA         Relative, in device coordinates.
                      DCSDCA        Constant subdivision (non-PEX only).
                      DIDCA         Implementation-dependent method (PEX
                                    only).
---------------------------------------------------------------------------

Other, nonstandard, line types are available. See Constants.

Description

PSPLP allows you to modify the entries in the extended polyline bundle table in the workstation state list by defining a new index. There are five entries in the table: line type, line width scale factor, polyline color, polyline shading method, and curve approximation criteria.

The extended polyline bundle table in the workstation state list has predefined entries taken from the workstation description table. A number of these entries are predefined for every workstation of category OUTPUT and OUTIN. You can redefine any table entry using this function, including predefined entries.

When Digital PHIGS displays polylines during structure traversal, the current polyline index in the PHIGS PLUS traversal state list refers to an entry in the extended polyline bundle table. If the current polyline index is not present in the extended polyline bundle table, Digital PHIGS uses polyline index 1. The setting of the corresponding ASF determines which of the aspects in an entry Digital PHIGS uses.

During structure traversal, if the current polyline index does not exist in the extended table, Digital PHIGS uses polyline index 1. If CTYPE = PINDIR, the function uses the COLI argument. Otherwise, the function uses the COLR argument.

The new function syntax conforms to the ISO Fortran standard. Digital recommends that you code using the new function syntax.

Data Record Information

If ACRI is PWDCA, there is no data record.

If ACRI is PCBKCA or DCSDCA, the data record has the following format:

INTEGER IL    = 1     Number of integer values
INTEGER IA(1) =       Count
        RL    = 0
        RA    = ()
        SL    = 0
        LSTR = ()
        STR   = ()

If ACRI is PCSWCA, PCSNCA, PCSDCA, PCDWCA, PCDNCA, PCDDCA, PRWCA, PRNCA, or PRDCA, the data record has the following format:

        IL    = 0
        IA    = ()
        RL    = 1
INTEGER RA(1) =       Approximation value
        SL    = 0
        LSTR = ()
        STR   = 0

If ACRI is DIDCA, the data record has the following format:

        IL    = 0
        IA    = 0
        RL    = 1    Number of reals
        RA(1) =      Approximation value
        SL    = 0
        LSTR = ()
        STR   = ()

Museum