NAME

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

SYNOPSIS

C Syntax

void
pset_char_ht ( height )
Pfloatheight;character height

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, then 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, then 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. 

Execution

When the SET CHARACTER HEIGHT element is traversed, the current character height entry in the traversal state list is set to character height.  Characters in text output primitives that 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, ∗)

SEE ALSO

SET CHARACTER EXPANSION FACTOR (3P)
SET CHARACTER SPACING (3P)
SET TEXT REPRESENTATION (3P)
SET ANNOTATION TEXT CHARACTER HEIGHT (3P)

September 02, 1992