PSTXR(3g) — Subroutines
Name
PSTXR − Defines text attributes for a text index.
Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function
Syntax
PSTXR (WKID, TXI, FONT, PREC, CHXP, CHSP, COLI)
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
COLI Integer Read Color index
---------------------------------------------------------------------------
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.
---------------------------------------------------------------------------
Description
PSTXR associates the value of the text index with the text font, text precision, character expansion factor, character spacing, and text color index values in the text bundle table. This table is in the workstation state list for the workstation specified by the workstation identifier.
This function allows you to define or redefine a set of text attributes for a specified text index. (You can also set these attributes individually; see the individual SET functions.) The following table describes the attributes specified in this function:
Text Attribute Description
--------------------------------------------------------------------------
Text font Selects the specified font on the workstation.
Text precision Controls how closely the displayed characters adhere
to the other specified text attributes. In order of
increasing fidelity, the possible values are STRING,
CHAR, and STROKE. A STRING value evaluates character
height and width attributes only; this is the default
precision value. A CHAR value evaluates each character
for compliance with all other specified text
attributes. A STROKE value looks for exact compliance
with all specified text attributes.
Character expansion Controls the width of the character by specifying the
factor deviation of the nominal width-to-height ratio, as
defined in the font design.
Character spacing Specifies how much space will appear between two
adjacent characters. Digital PHIGS specifies character
spacing as a fraction of the font’s nominal character
height.
Character color Provides an index into the color table of the
index workstation.
--------------------------------------------------------------------------
Digital PHIGS provides predefined entries for the text bundle tables for every OUTPUT and OUTIN category workstation. Digital PHIGS maintains entry values in the workstation state list.
When Digital PHIGS displays text or annotation text, the current text index entry in the PHIGS traversal state list refers to an entry in the text bundle table, if it is present. If the entry is not present in the table, Digital PHIGS uses the default index. The setting of the corresponding ASF (BUNDLED or INDIVIDUAL) determines which attributes are bound to the primitive for display at traversal time.
Not all workstations can recognize all text attribute values; Digital PHIGS provides default values. See the appropriate workstation-specific chapters in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS for more information.
See Also
PATR
PATR3
PQTXF
PQTXR
PQTXP
PSCHXP
PSCHSP
PSIASF
PSTXC
PSTXCI
PSTXFN
PSTXI
PSTXPR
PTX
PTX3