Name

PEXSetCharExpansion - Set Character Expansion Factor

Synopsis

void PEXSetCharExpansion(Display ∗display, XID resource_id, PEXOCRequestType req_type, double expansion)

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).

expansionThe character expansion factor. 

Returns

None

Description

This function creates an output primitive attribute which sets the character expansion factor attribute.  Only the magnitude of the specified expansion is considered.  The specified character expansion factor is compared to the minimum and maximum character expansion factors.  These values depend on the font files that are in the font groups in the selected font table entry, which in turn depend on the font files opened.  For example, if all scalable and rotatable stroke fonts are open, then a continuous number of expansions are supported.  If the expansion is smaller than the minimum character expansion factor, the minimum value is used.  If the expansion is larger than the maximum character expansion factor, the maximum value is used. 

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXSetIndividualASF