PQPPLP(3g) — Subroutines

Name

PQPPLP − Returns extended information about the predefined polyline representation of the index.

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

Old Syntax

DQPPLP (WTYPE, PLI, MLDR, ERRIND, LTYPE, LWIDTH, CLRTYP, ICOLR, COLR,
SHDMD, APRXTP, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
PLI               Integer        Read      Predefined polyline index
MLDR              Integer        Read      Maximum length of curve
                                           approximation data record
ERRIND            Integer        Write     Error indicator
LTYPE             Integer        Write     Polyline type
LWIDTH            Real           Write     Line width scale factor
CLRTYP            Integer        Write     Polyline color type
ICOLR             Integer        Write     Indexed color value
COLR(3)           Array of       Write     Direct color value
                  reals
SHDMD             Integer        Write     Polyline shading method
APRXTP            Integer        Write     Curve approximation criteria type
LDR               Integer        Write     Length of the curve approximation
                                           data record
DATREC(MLDR)      Array of       Write     Curve approximation data record
                  character ∗80
---------------------------------------------------------------------------

New Syntax

PQPPLP (WTYPE, PLI, CCSBSZ, MLDR, ERRIND, LTYPE, LWIDTH, CTYPE,
COLI, NCC, COLR, PLSM, ACRI, LDR, DATREC)

Argument          Data Type      Access    Description
---------------------------------------------------------------------------
WTYPE             Integer        Read      Workstation type
PLI               Integer        Read      Polyline index
CCSBSZ            Integer        Read      Buffer size of the color component
                                           specification
MLDR              Integer        Read      Maximum length of curve
                                           approximation data record
ERRIND            Integer        Write     Error indicator
LTYPE             Integer        Write     Polyline type
LWIDTH            Real           Write     Line width scale factor
CTYPE             Integer        Write     Polyline color type
COLI              Integer        Write     Color index
NCC               Integer        Write     Number of color value components
COLR(CCSBSZ)      Array of       Write     Color values
                  reals
PLSM              Integer        Write     Polyline shading method
ACRI              Integer        Write     Curve approximation criteria type
LDR               Integer        Write     Length of the curve approximation
                                           data record array
DATREC(MLDR)      Array of       Write     Curve approximation data record
                  character ∗80
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
LTYPE                PLSOLI       Solid edge
                     PLDASH       Dashed edge
                     PLDOT        Dotted edge
                     PLDASD       Dashed-dotted edge
                     PLDS2D       Dash-2-dots edge
                     PLDS3D       Dash-3-dots edge
                     PLLDS        Long dashed edge
                     PLLSDS       Long-short dashed edge
                     PLSPDS       Spaced dashed edge
                     PLSPD        Spaced dotted edge
                     PL2D         Double-dotted edge
                     PL3D         Triple-dotted edge
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                 PNOPS        No interpolation, constant shading
                     PCPS         Linear interpolation of color
ACRI                 PWDCA        Workstation-dependent method
                     PCBKCA       Constant parametric subdivision between
                                  knots
                     PCSWCA       Chordal size, in world coordinates
                     PCSNCA       Chordal size, in normalized projection
                                  coordinates
                     PCSDCA       Chordal size, in device coordinates
                     PPDWCA       Planar deviation, in world coordinates
                     PPDNCA       Planar deviation, in normalized projection
                                  coordinates
                     PPDDCA       Planar 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)
---------------------------------------------------------------------------

Description

PQPPLP returns values for the following:

•Polyline type

•Line width scale factor

•Color type and value

•Shading method

•Curve approximation type and value

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