PSTXC(3g) — Subroutines

Name

PSTXC − Sets the color used to draw text and annotation text primitives.

Operating States: PHOP, ∗, STOP, ∗
PHIGS PLUS function
Creates a structure element

Old Syntax

DSTXC (CLRTYP, ICOLR, COLR)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
CLRTYP         Integer        Read       Color type
ICOLR          Integer        Read       Indexed color value
COLR(3)        Array of       Read       Direct color value
               reals
---------------------------------------------------------------------------

New Syntax

PSTXC (CTYPE, COLI, NCC, COLR)

Argument       Data Type      Access     Description
---------------------------------------------------------------------------
CTYPE          Integer        Read       Color type
COLI           Integer        Read       Color index
NCC            Integer        Read       Number of color value components
COLR(NCC)      Array of       Read       Color values
               reals
---------------------------------------------------------------------------

Constants

Defined Argument     Constant     Description
---------------------------------------------------------------------------
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

PSTXC sets the text color Digital PHIGS uses to draw text and annotation text primitives by setting the text color attribute to be either an indexed color or a direct color value, depending on the color type attribute value. Depending on the edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer. The pointer then points to the new set text color element.

During structure traversal, Digital PHIGS sets the current text color entry in the traversal state list to the value associated with the element. When the current text color ASF entry in the traversal state list is INDIVIDUAL, Digital PHIGS uses the current text color value to display subsequent text and annotation text output primitives.

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 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.