Name

PEXSetCharHeight - Set Character Height

Synopsis

void PEXSetCharHeight(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 text character height. 

Returns

None

Description

This function creates an output primitive attribute which sets the character height value attribute.  If the specified height or the computed width is not supported, the height or width is mapped to the nearest supported 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 fonts are open.  For example, if the client opens all scalable and rotatable stroke fonts, a continuous number of character sizes are supported.  The height is specified in the text local coordinate system. 

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also