DQHLR(3g) — Subroutines

Name

DQHLR − Returns highlighting representation information.

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

Syntax

DQHLR (WKID, HI, MLDR, ERRIND, HMTHOD, LDR, DATREC)

Argument        Data Type       Access    Description
---------------------------------------------------------------------------
WKID            Integer         Read      Workstation identifier
HI              Integer         Read      Highlight index
MLDR            Integer         Read      Dimension of data record array
ERRIND          Integer         Write     Error indicator
HMTHOD          Integer         Write     Highlight method the index uses
LDR             Integer         Write     Number of array elements used in
                                          DATREC
DATREC(MLDR)    Array of        Write     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

DQHLR returns the highlighting method and the highlighting data of the specified highlight index of the specified workstation identifier.

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: