SET CHARACTER HEIGHT(3P) — SUNPHIGS LIBRARY

NAME

SET CHARACTER HEIGHT − create structure element to set the current character height attribute

SYNOPSIS

C Syntax

void
psetcharheight ( height )
Pfloatheight;character height

FORTRAN Syntax

SUBROUTINE pschh ( CHH )
REALCHHcharacter height (TLC)

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET CHARACTER HEIGHT creates a structure element containing a value for the ‘current character height’ attribute, which defines the height of a capital letter, in Text Local Coordinates. This attribute applies to the output primitives

•TEXT

•TEXT 3

If the current edit mode is INSERT, is a SET CHARACTER HEIGHT 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 CHARACTER HEIGHT 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 Parameter

heightA real value specifying the character height.

FORTRAN Input Parameter

CHHA real value specifying the character height.

Execution

When the SET CHARACTER HEIGHT element is traversed, the ‘current character height’ entry in the PHIGS traversal state list is set to character height. Characters in text output primitives which follow in the structure network are drawn with the ‘current character height.’

The character height is specified in Text Local Coordinates (TLC), and determines the height of a capital letter, measured from the character base line parallel to the character up vector. The character base line and character up vector are relative to the Text Local Coordinate system created by the text position and text vectors specified in the text output primitive.

The default character height is 0.01.

ERRORS

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

Museum