Name

PEXSetATextHeight - Set Annotation Text Height

Synopsis

void PEXSetATextHeight(Display ∗display, XID resource_id, PEXOCRequestType req_type, double height)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call. 

resource_idThe resource identifier of the renderer or structure. 

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

heightThe annotation text character height. 

Returns

None

Description

This function creates an output primitive attribute which sets the annotation text height attribute.  If the specified height or the computed width is not supported, the height or width is mapped to the nearest supported annotation character height or width.  These values depend on the font files that are in the font groups in the selected font table entry, which in turn depend on which X or PEX font files have been opened.  If all scalable and rotatable stroke fonts are open, then a continuous range of character sizes are supported.  The height is expressed in normalized projection coordinates. 

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also