Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ pschh(3g) — PHIGS 5.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

PSCHH(3g)  —  Subroutines

Name

PSCHH − Defines the height of an uppercase character in the current font. 

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

Syntax

PSCHH (CHH)

Argument       Data Type      Access    Description
---------------------------------------------------------------------------
CHH            Real           Read      Character height in text local
                                        coordinates, whose unit size is
                                        unscaled from modeling coordinates.
                                        The default value is 0.01.
---------------------------------------------------------------------------

Description

PSCHH specifies the height of an uppercase character in the current font.  Depending on the current 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 character height element. 

By design, PHIGS fonts define a height-to-width ratio.  Therefore, this function implicitly specifies the width of the font.  The initial height and width values are both 0.01.  Text precision affects character height and width factors. See the PSTXPR function. 

During structure traversal, the set character height element sets the current set character height entry in the PHIGS traversal state list.  Digital PHIGS binds the value to subsequently traversed text and text 3 primitives.  The character height parameter is specified in the text local coordinate system, along the character up vector.  For text output primitives, the text local coordinate system has unit size unscaled from modeling coordinates.  Digital PHIGS transforms the value into the text local coordinate system for display on the workstation.  If the workstation cannot facilitate the specified height, Digital PHIGS uses the nearest supported character height. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

See Also

PQTXX
PQTXF
PSATCH
PSCHXP
PSCHSP
PSTXR

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026