GPAH - Set Annotation Height

Purpose

Use GPAH to insert a Set Annotation Height structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Annotation Height structure element depending on the current edit mode.

The application specifies the annotation text character height with respect to the annotation text local coordinate system; that is, a two-dimensional coordinate system parallel to the NPC (Normalized Projection Coordinates) x, y plane. The graPHIGS API multiplies the specified height by the scale factor of the current workstation transformation, and then maps the result to the closest available height on the workstation.

The current annotation character height entry in the graPHIGS API traversal state list is also set by the Set Annotation Height Scale Factor (GPAHSC) structure element. As a result, the traversal default annotation height corresponds to a default annotation height scale factor of 1.0.

For more information concerning annotation text and annotation text attributes, see The graPHIGS Programming Interface: Understanding Concepts

Parameters