SET TEXT FONT(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pset_text_font ( font )
Pintfont;text 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 in 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 to the workstation’s non-writable table of available fonts.

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

The fonts available for PCS_ASCII are:

ConstantValue
PFONT_MONO1

Execution

When the SET TEXT FONT element is traversed, the current text font entry in the 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 that 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 is taken from the workstation’s representation indicated by the current text index. In this case, the font set with SET TEXT FONT has no effect.

ERRORS

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

Museum