SET TEXT FONT(3P) — SUNPHIGS LIBRARY

NAME

SET TEXT FONT − create a structure element to set the current text font attribute

SYNOPSIS

C Syntax

void
psettextfont ( font )
Pintfont;text font

FORTRAN Syntax

SUBROUTINE pstxfn ( FONT )
INTEGERFONTtext font

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET TEXT FONT creates a structure element containing a value for the ‘current text font’ attribute, which selects a font from those available on the workstation.

When the ‘text font ASF’ is set to INDIVIDUAL, this attribute applies to the output primitives:

• TEXT
• TEXT 3
• ANNOTATION TEXT RELATIVE
• ANNOTATION TEXT RELATIVE 3

If the current edit mode is INSERT, a SET TEXT FONT element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET TEXT FONT element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

C Input Parameters

fontThe text font, specified as an index into the workstation’s non-writable table of available fonts. The fonts available depened on the active character sets. See “set character sets” in GENERALIZED STRUCTURE ELEMENT. The default value for the active character sets is PCS_ASCII, the ISO-646 character set.

All the font indicies have named constants defined in phigs.h, as shown below.

The fonts available for PCS_ASCII are:

ConstantValue
PFONT_ROMAN_MONO1
PFONT_ROMAN_SIMPLEX-2
PFONT_ROMAN_DUPLEX-3
PFONT_ROMAN_COMPLEX-4
PFONT_ROMAN_TRIPLEX-5
PFONT_ITALIC_COMPLEX-6
PFONT_ITALIC_TRIPLEX-7
PFONT_SCRIPT_SIMPLEX-10
PFONT_SCRIPT_COMPLEX-11

The fonts are available for PCS_ASCII for compatiblity with previous releases are:

PFONT_GREEK_SIMPLEX-8
PFONT_GREEK_COMPLEX-9
PFONT_CARTOGRAPHIC-12
PFONT_SYMBOL-13

The fonts are available for PCS_GREEK are:

PFONT_G_GREEK_MONO1
PFONT_G_GREEK_SIMPLEX-2
PFONT_G_GREEK_COMPLEX-4

The fonts available for PCS_SYMBOL are:

PFONT_SYMBOL_MONO1
PFONT_CARTOGRAPHIC-12
PFONT_SYMBOL-13

The fonts available for PCS_KANJI are:

PFONT_KANJI_MONO1

FORTRAN Input Parameters

FONTThe text font, specified as an index into the workstation’s non-writable table of available fonts. The fonts available depened on the active character sets. See “set character sets” in GENERALIZED STRUCTURE ELEMENT. The default value for the active character sets is PCS_ASCII, the ISO-646 character set.

Each the font indicies has named PARAMETER defined in phigs77.h, as shown below.

The fonts available for PCSASCII are:

PARAMAMETERValue
PFONTROMANMONO1
PFONTROMANSMPLX-2
PFONTROMANDPLX-3
PFONTROMANCMPLX-4
PFONTROMANTRPLX-5
PFONTITALICCMPLX-6
PFONTITALICTRPLX-7
PFONTGREEKSMPLX-8
PFONTGREEKCMPLX-9
PFONTSCRIPTSMPLX-10
PFONTSCRIPTCMPLX-11
PFONTCARTO-12
PFONTSYMBOL-13

The fonts available for PCSGREEK are:

PFONTGREEKMONO1
PFONTGGREEKSMPLX-2
PFONTGGREEKCMPLX-4

The fonts available for PCSSYMBOL are:

PFONTSYMBOLMONO1
PFONTCARTO-12
PFONTSYMBOL-13

The fonts available for PCSKANJI are:

PFONTKANJIMONO1

Execution

When the SET TEXT FONT element is traversed, the ‘current text font’ entry in the PHIGS traversal state list is set to text font. When the ‘current text font ASF’ (Aspect Source Flag) is set to INDIVIDUAL, the text font is applied to text strings in output primitives which follow in the structure network.

The text font attribute selects a font from those available on the workstation. The default text font is 1; the default text precision is “String Precision”. The default is used when the font selected is not available in the precision selected on the workstation.

When the text font ASF is set to BUNDLED, the text font will be taken from the workstation’s representation indicated by the ‘current text index.’ In this case, the font set with SET TEXT FONT will have no effect.

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum