NAME

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

SYNOPSIS

C Syntax

void
psetannotationstyle ( style )
Pintstyle;annotation style

FORTRAN Syntax

SUBROUTINE psans ( ASTYLE )
INTEGERASTYLEannotation 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, is 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:

ValueAnnotation styleMeaning
1PAN_UNCON“Unconnected”
2PAN_LEADLINE“Lead Line”

FORTRAN Input Parameter

ASTYLE
The annotation style specifies one of the following:

ValueAnnotation styleMeaning
1PUNCON“Unconnected”
2PLDLN“Lead Line”

Execution

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

The “Lead Line” value means that the annotation text is connected to it’s 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(7)
INQUIRE ANNOTATION FACILITIES (3P)
ANNOTATION TEXT RELATIVE 3 (3P)

Sun Release 4.0  —  Last change: 28 July 1989