NAME

SET ANNOTATION STYLE − create structure element to set the current annotation style attribute

SYNOPSIS

C Syntax

void
pset_anno_style ( style )
Pintstyle;  annotation style

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET ANNOTATION STYLE creates a structure element containing a value for the current annotation style 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 STYLE 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 STYLE 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

styleAn integer value specifying one of the following annotation styles:

1PANNO_STYLE_UNCONNECTED Unconnected
2PANNO_STYLE_LEAD_LINE Lead Line

Execution

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

The Lead Line value means that the annotation text is connected to its reference point by a lead line drawn using the current polyline attributes. 

ERRORS

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

SEE ALSO

PHIGS WORKSTATION DESCRIPTION TABLE (7P)
INQUIRE ANNOTATION FACILITIES (3P)
ANNOTATION TEXT RELATIVE 3 (3P)

September 02, 1992