PSRFR(3g) — Subroutines

Name

PSRFR − Associates the reflectance index with the specified parameters.

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

Syntax

PSRFR (WKID, RFI, RFM, RPTYPE, LDR, DATREC)

Argument        Data Type     Access     Description
---------------------------------------------------------------------------
WKID            Integer       Read       Workstation identifier
RFI             Integer       Read       Reflectance index
RFM             Integer       Read       Reflectance model
RPTYPE          Integer       Read       Reflectance properties type
LDR             Integer       Read       Length of the data record array
DATREC(LDR)     Character ∗80 Read       Data record
---------------------------------------------------------------------------

Constants

Defined Argument     Constant    Description
---------------------------------------------------------------------------
RFM                  PNORM       Digital PHIGS performs no reflectance
                                 calculation.
                     PARM        Digital PHIGS produces ambient
                                 reflectance effects.
                     PADRM       Digital PHIGS produces ambient and
                                 diffuse reflectance effects.
                     PADSRM      Digital PHIGS produces ambient, diffuse,
                                 and specular reflectance effects.
RPTYPE               PSRPT       Simple reflectance.
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.
---------------------------------------------------------------------------

Description

PSRFR associates the reflectance index with the specified parameters. The reflectance bundle table has predefined entries taken from the workstation description table. You can set any entry, including the predefined entries, with this function.

During structure traversal, Digital PHIGS uses the current reflectance index and current back reflectance index entries in the PHIGS traversal state list to select entries in the reflectance bundle table. If the entry corresponding to either of these indexes is undefined, Digital PHIGS uses the entry corresponding to index 1.

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