Purpose
Use Set Text Precision to insert a Set Text Precision structure element into the open structure following the element pointer or replace the element pointed at by the element pointer with a Set Text Precision structure element, depending on the current edit mode.
The text precision specifies which attributes apply to annotation and geometric text primitives and the manner in which the graPHIGS API uses them. At structure traversal time, the graPHIGS API uses this precision when the text precision aspect source flag is set to INDIVIDUAL (Set Individual ASF).
Text precisions available are STRING, CHARACTER, and STROKE. The traversal default for text precision is STRING.
If the workstation does not support the specified text precision, then the graPHIGS API uses the highest available precision instead.
The following figure describes the attributes and precision for geometric text:
Geometric Text Attributes
CHARACTER
CHARACTER CHARACTER UP AND
TEXT EXPANSION CHARACTER CHARACTER UP TEXT TEXT BASE
FONT FACTOR SPACING COLOR HEIGHT VECTOR PATH ALIGNMENT VECTORS
____________________________________________________________________________________________________ P | |
r STRING | Y ** N N Y Y N N N N |
e | |
c | |
i CHARACTER | Y ** Y Y Y Y Y Y Y Y |
s | |
i | |
o STROKE | Y ** Y Y Y Y Y Y Y Y |
n |____________________________________________________________________________________________________|
The following keywords are used above to designate which attributes will be processed for a particular
precision:
Y The attribute is applied for this precision.
N The attribute is not applied for this precision.
** The requested font will be applied if it is available on the requested workstation. Otherwise,
the workstation will default to an alternate font.
The following figure describes the attributes and precision for annotation text:
Annotation Text Attributes
ANNOTATION
CHARACTER HEIGHT ANNOTATION
TEXT EXPANSION CHARACTER SCALE UP ANNOTATION ANNOTATION ANNOTATION
FONT FACTOR SPACING COLOR FACTOR VECTOR PATH ALIGNMENT HEIGHT
___________________________________________________________________________________________________ P | |
r STRING | Y 4 N N Y Y 1 N N N Y 1 |
e | |
c | |
i CHARACTER | Y 4 Y 1 Y 2 Y Y 1 Y 2 Y 2 Y 2 Y 1 |
s | |
i | |
o STROKE | Y 4 Y 3 Y 3 Y Y 3 Y 3 Y 3 Y 3 Y 3 |
n | |
|___________________________________________________________________________________________________|
The following keywords are used above to designate which attributes will be processed for a particular
precision:
The following keywords are used above to designate which attributes will be processed for a particular precision:
Y - The attribute is applied for this precision.
N - The attribute is not applied for this precision.
The following numbers are used above to describe how precisely an attribute will be applied:
| 1 - | The attribute is applied as closely as possible for the entire text string. |
| 2 - | Whether these attributes are applied is workstation dependent. See The graPHIGS Programming Interface: Technical Reference for more information |
| 3 - | The attribute is applied on a stroke-by-stroke basis, that is, exactly |
| 4 - | The requested font will be applied if the font is available in the requested workstation; otherwise, the workstation will default to an alternate font. |
Language Bindings
| pset_text_prec (prec) |
| PSTXPR (prec) |
Errors
Related Subroutines