void PEXOCCSetTextPrecision( PEXOCC context, int precision )
void PEXSetTextPrecision( Display *display, XID resource_id, PEXOCRequestType req_type, int precision )
None.
Invoke PEXOCCSetTextPrecision to create an attribute output command which sets the text precision attribute in the renderer's pipeline state according to the value specified by precision.
By setting the text precision attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's text precision entry to define how precisely the implementation applies attributes to text (regular and annotated) and clips the text. When you set the text precision attribute's ASF to PEXBundled, the implementation uses the text precision from the text bundle table.
PEXlib defines the following text precisions:
The character up vector, text path, text alignment, and character spacing attributes are not necessarily applied to text primitives.
Performs clipping in an implementation-dependent way.
Performs clipping at least on a character-by-character basis.
Performs clipping exactly at the clipping boundaries.
An implementation may substitute any text precision as a better text precision, where PEXStringPrecision is the least precise and PEXStrokePrecision is the best precision.
When text or annotation text is interpreted, the implementation renders the mono-encodings in the text string in the same text precision (least common denominator). If the font group selected by the current text font index consists of both X and PEX fonts, and if some of the mono-encodings in the string are rendered in X fonts, then the text precision of the entire string must be dropped to at least PEXCharPrecision.
If you specify an undefined precision, then the implementation issues a BadPEXOutputCommand error.
This function is a member of the annotation and text attribute set.
For an overview and for a list of output attribute functions, see Output Attribute Functions.