NAME

SET ANNOTATION TEXT CHARACTER HEIGHT − create structure element to set the current annotation text character height attribute

SYNOPSIS

C Syntax

void
pset_anno_char_ht ( height )
Pfloatheight;character height

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

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

• ANNOTATION TEXT RELATIVE

• ANNOTATION TEXT RELATIVE 3

If the current edit mode is INSERT, a SET ANNOTATION TEXT CHARACTER HEIGHT element is inserted in the currently open structure after the element pointed to by the current element pointer.  If the edit mode is REPLACE, then the new SET ANNOTATION TEXT 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 annotation text character height. 

Execution

When the SET ANNOTATION TEXT CHARACTER HEIGHT element is traversed, the current annotation text character height entry in the traversal state list is set to SET ANNOTATION TEXT CHARACTER HEIGHT.  Characters in text output primitives that follow in the structure network are drawn with the current annotation text character height. 

The annotation text 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 TLC system created by the reference point and annotation offset specified in the annotation text relative output primitive. 

The default annotation text character height is 0.01. 

ERRORS

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

SEE ALSO

ANNOTATION TEXT RELATIVE 3 (3P)
SET CHARACTER HEIGHT (3P)

September 02, 1992