PEXOCCSetCharSpacing - Set Character Spacing (5.0)

Synopsis 

     void PEXOCCSetCharSpacing(
          PEXOCC context,
          double spacing
     )

 
     void PEXSetCharSpacing(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          double spacing
     )

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

spacing
The text character spacing factor.

Returns

None.

Description

Invoke PEXOCCSetCharSpacing to create an attribute output command which sets the character spacing attribute in the renderer's pipeline state according to the value specified by spacing.

By setting the character spacing attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's character spacing entry to define the space between adjacent characters in a character string. Express the character spacing attribute (spacing) as a fraction of the character height (see PEXOCCSetCharHeight). To overlap characters, specify a negative value for spacing. When you set the character spacing attribute's ASF to PEXBundled, the implementation uses the character spacing from the text bundle table.

This function is a member of the annotation and text attribute set and affects text primitives.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of all output attribute functions, see Output Attribute Functions.