SET TEXT PRECISION(3P) — SUNPHIGS LIBRARY

NAME

SET TEXT PRECISION − create a structure element to set the current text precision attribute

SYNOPSIS

C Syntax

void
psettextprec ( precision )
Ptxprecprecision;text precision

FORTRAN Syntax

SUBROUTINE pstxpr ( PREC )
INTEGERPRECtext precision ( PSTRP, PCHARP, PSTRKP )

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET TEXT PRECISION creates a structure element containing a value for the current text precision attribute, which controls how closely the text must be drawn in relation to the font definition and the applicable text attributes.

When the current text precision Aspect Source Flag (ASF) is set to INDIVIDUAL, this attribute defines the text precision applied to the output primitives:

• TEXT

• TEXT 3

• ANNOTATION TEXT RELATIVE

• ANNOTATION TEXT RELATIVE 3

C Input Parameter

precision
The text precision is one of the following values:

PPSTRINGString Precision
PPCHARCharacter Precision
PPSTROKEStroke Precision

FORTRAN Input Parameter

PRECThe text precision is one of the following values:

PSTRPString Precision
PCHARPCharacter Precision
PSTRKPStroke Precision

Execution

If the current edit mode is INSERT, then a SET TEXT PRECISION element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, then the new SET TEXT PRECISION element replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the new element.

When the SET TEXT PRECISION element is traversed, the current text precision entry in the PHIGS traversal state list is set to text precision.

When the current text precision ASF is set to INDIVIDUAL, the text output primitives which follow in the structure network are then drawn with the precision specified.

The text precision attribute allows the tradeoff of quality and performance for text primitives.

StrokeStroke precision demands adherence to all text attributes. Clipping must be performed on portions of characters, but need not involve vector strokes. Stroke precision provides the highest quality available.

Character
Character precision allows the implementation to clip on a character by character basis. If any portion of a character is outside the clipping limits, then the entire character can be clipped.

StringString precision allows the implementation to ignore the character base and up vectors, text path, text alignment, and character spacing, and permits clipping in an implementation dependent way.

SunPHIGS presently adheres to all text attributes, regardless of the text precision. SunPHIGS fonts are always stroke fonts, not raster fonts.

The default text font is 1. The default text precision is String precision. The default is used when the font selected is not available in the selected precision on the workstation.

When the current text precision ASF is set to BUNDLED, the text precision is taken from the workstation’s representation indicated by the current text index. In this case, the text precision set with SET TEXT PRECISION has no effect.

ERRORS

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

Museum