SET ANNOTATION TEXT CHARACTER HEIGHT(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psetannotationcharheight ( height )
Pfloatheight;annotation text character height

FORTRAN Syntax

SUBROUTINE psatch ( ATCHH )
REALATCHHannotation text character height (TLC)

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, is a SET ANNOTATION TEXT 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 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.

FORTRAN Input Parameter

ATCHH
A 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 PHIGS traversal state list is set to annotation text character height. Characters in text output primitives which 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 Text Local Coordinate 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, ∗)

Museum