PQRFR(3g) — Subroutines

Name

PQRFR − Returns reflectance representation information for the index.

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

Syntax

PQRFR (WKID, RFI, TYPE, MLDR, ERRIND, RFM, RPTYPE, LDR, DATREC)

Argument        Data Type       Access    Description
---------------------------------------------------------------------------
WKID            Integer         Read      Workstation identifier
RFI             Integer         Read      Reflectance index
TYPE            Integer         Read      Type of value to return
MLDR            Integer         Read      Dimension of the data record
                                          array
ERRIND          Integer         Write     Error indicator
RFM             Integer         Write     Reflectance model
RPTYPE          Integer         Write     Reflectance property type
LDR             Integer         Write     Length of the data record array
DATREC(MLDR)    Character ∗80   Write     Reflectance property color value
                                          data record
---------------------------------------------------------------------------

Constants

Defined Argument      Constant       Description
---------------------------------------------------------------------------
TYPE                  PSET           Use the exact state list values.
                      PREALI         Use the values approximated by the
                                     graphics handler.
RFM                   PNORM          No reflectance.
                      PARM           Ambient reflectance.
                      PADRM          Ambient and diffuse reflectance.
                      PADSRM         Ambient, diffuse, and specular
                                     reflectance.
RPTYPE                PSRPT          Simple reflectance.
---------------------------------------------------------------------------

Description

PQRFR returns the reflectance representation information associated with the specified reflectance index.

Digital PHIGS Version 3.1 does not support this function.

Data Record Information

If RPTYPE is PSRPT, the data record is as follows:

INTEGER IL    = 2+∗      Number of integer elements
INTEGER IA(1) =          Color type
INTEGER IA(2) =          Number of color value components (NCC)
INTEGER RL    = 4+∗      Number of real elements
REAL RA(1)    =          Ambient reflection coefficient
REAL RA(2)    =          Diffuse reflection coefficient
REAL RA(3)    =          Specular reflection coefficient
REAL RA(4)    =          Specular exponent
REAL RA(5)    =          Transparency coefficient (optional)
     SL       = 0
     LSTR     = ()
     STR      = ()
     If the color type is PINDIR:

         IA(3) =   Specular color index
     If the color type is PRGB, PCIE, PHSV, or PHLS:
         RA     =   Elements 5 through 4+NCC contain the color values