PSTXRP(3g) — Subroutines

Name

PSTXRP − Modifies the entries in the extended text bundle table.

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

Old Syntax

DSTRP (WKID, TXI, FONT, PREC, CHXP, CHSP, CLRTYP, ICOLR, COLR)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
WKID           Integer        Read       Workstation identifier
TXI            Integer        Read       Text index
FONT           Integer        Read       Text font
PREC           Integer        Read       Text precision
CHXP           Real           Read       Character expansion factor
CHSP           Real           Read       Character spacing
CLRTYP         Integer        Read       Text color type
ICOLR          Integer        Read       Text indexed color value
COLR(3)        Array of       Read       Text direct color value
               reals
---------------------------------------------------------------------------

New Syntax

PSTXRP (WKID, TXI, FONT, PREC, CHXP, CHSP, CTYPE, COLI, NCC, COLR)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
WKID           Integer        Read       Workstation identifier
TXI            Integer        Read       Text index
FONT           Integer        Read       Text font
PREC           Integer        Read       Text precision
CHXP           Real           Read       Character expansion factor
CHSP           Real           Read       Character spacing
CTYPE          Integer        Read       Text color type
COLI           Integer        Read       Color index
NCC            Integer        Read       Number of color value components
COLR(NCC)      Array of       Read       Text color values
               reals
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
PREC                  PSTRP         String precision. Digital PHIGS
                                    evaluates character height and width
                                    attributes. This is the default value.
                      PCHARP        Character precision. Digital PHIGS
                                    evaluates each character for
                                    compliance with all other specified
                                    text attributes.
                      PSTRKP        Stroke precision. Digital PHIGS looks
                                    for exact compliance with all specified
                                    text attributes.
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

PSTXRP allows you to modify the entries in the extended text bundle table in the workstation state list by defining a new index. There are five entries in the table: text font, text precision, character expansion factor, character spacing, and text color.

The extended text bundle table in the workstation state list has predefined entries taken from the workstation description table. Digital PHIGS predefines a number of these entries for every workstation of category OUTPUT and OUTIN. You can redefine any table entry using this function, including predefined entries.

When Digital PHIGS displays text or annotation text during structure traversal, the current text index entry in the PHIGS PLUS traversal state list refers to an entry in the extended text bundle table. If the current text index is not present in the extended text bundle table, Digital PHIGS uses text index 1. The setting of the corresponding ASF determines which of the aspects in an entry PHIGS uses. If CTYPE = PINDIR, the function uses the COLI argument. Otherwise, the function uses the COLR argument.

The new function syntax conforms to the ISO Fortran standard. Digital recommends that you code using the new function syntax.