DQPHLR(3g) — Subroutines

Name

DQPHLR − Returns predefined highlight information for the index.

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

Syntax

DQPHLR (WTYPE, 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     Highlighting method
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.
---------------------------------------------------------------------------

Description

DQPHLR returns values for the following:

•Highlight method

•Highlight data record

•Size of the returned list

•Actual size of the predefined highlight representation in the workstation description table

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 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