DSHR(3g) — Subroutines

Name

DSHR − Associates a highlight index with various highlighting information.

Operating States: PHOP, WSOP, ∗, ∗
Digital PHIGS extension function

Syntax

DSHR (WKID, HI, HMTHOD, LDR, DATREC)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
WKID           Integer        Read       Workstation identifier
HI             Integer        Read       Highlight index
HMTHOD         Integer        Read       Highlighting method
LDR            Integer        Read       Dimension of data record
DATREC(LDR)    Array of       Read       Data record
               character ∗80
---------------------------------------------------------------------------

Constants

Defined Argument     Constant      Description
---------------------------------------------------------------------------
HMTHOD               DHTDEF        Highlight with workstation-dependent
                                   default method.
                     DHTINT        Highlight with varying intensity.
                     DHTBL         Highlight with blinking.
                     DHTCLR        Highlight with changing color. This
                                   does not override interior and back
                                   interior color specifications.
                     DHTFCL        Highlight with forced color. This
                                   overrides interior and back interior
                                   color specifications.
                     DHTCMP        Highlight with complement mode.
                     DHTLIN        Highlight with extent line box.
                     DHTFIL        Highlight with extent fill area.
                     DHTTWO        Highlight with extent line box and
                                   fill area.
Line types           PLSOLI        Solid line. This is the default value.
                     PLDASH        Dashed line.
                     PLDOT         Dotted line.
                     PLDASD        Dashed-dotted line.
Interior styles      PHOLLO        Hollow interior. This is the default
                                   value.
                     PSOLID        Solid interior.
                     PPATTR        Patterned interior.
                     PHATCH        Hatched interior.
                     PISEMP        Empty interior.
---------------------------------------------------------------------------

Description

DSHR associates a highlight index with the following related highlighting criteria, and sets the representation in the workstation state list:

•Highlight method

•Highlight record

•Highlight size

Digital PHIGS associates each highlight index in the table of defined highlight representations entry with the parameters specified for that index.

During structure traversal, the current highlight index in the PHIGS traversal state list refers to an entry in the table of defined highlight representations.

If the specified highlight method is not available on a workstation, Digital PHIGS uses highlight method 0.

Data Record Information

If HMTHOD is DHTDEF or DHTCMP, the data record format is as follows:

INTEGER IL = 0 Number of integer values
INTEGER RL = 0 Number of real values

If HMTHOD is DHTINT, the data record record format is as follows:

INTEGER IL    = 0    Number of integer values
INTEGER RL    = 1    Number of real values
REAL    RA(1) =      Intensity scale factor

If HMTHOD is DHTBL, the data record format is as follows:

INTEGER IL    = 0    Number of integer values
INTEGER RL    = 1    Number of real values
REAL    RA(1) =      Blink rate

If HMTHOD is DHTCLR or DHTFCL, the data record format is as follows:

INTEGER IL    = 1    Number of integer values
        IA(1) =      Color index
INTEGER RL    = 0    Number of real values

If HMTHOD is DHTLIN, the data record format is as follows:

INTEGER IL    = 1    Number of integer values
        IA(1) =      Line type
INTEGER RL    = 2    Number of real values
REAL    RA(1) =      Line width
        RA(2) =      Extent expansion factor

If HMTHOD is DHTFIL, the data record format is as follows:

INTEGER IL    = 2    Number of integer values
        IA(1) =      Interior style
        IA(2) =      Interior style index
INTEGER RL    = 1    Number of real values
REAL    RA(1) =      Extent expansion factor

If HMTHOD is DHTTWO, the data record format is as follows:

INTEGER IL    = 3    Number of integer values
        IA(1) =      Line type
        IA(2) =      Interior style
        IA(3) =      Interior style index
INTEGER RL    = 2    Number of real values
REAL    RA(1) =      Line width
        RA(2) =      Extent expansion factor