PEXOCCSetTextFontIndex - Set Text Font Index (5.0)

Synopsis 

 
   void PEXOCCSetTextFontIndex(
        PEXOCC context,
        unsigned int index
   )
 


 
   void PEXSetTextFontIndex(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        unsigned int index
   )

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

index
The text font table index.

Returns

None.

Description

Invoke PEXOCCSetTextFontIndex to create an attribute output command which sets the text font index attribute in the renderer's pipeline state according to the value specified by index.

You use the text font index attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), to define the text font index into the text font table. Specify index to indicate the entry in the current text font lookup table that the implementation uses to render text and annotation text primitives. Each entry of the text font table defines a font group.

If you specify an undefined text font table index, then the index defaults to index one. If index one is not defined, then the result is implementation-dependent. If you specify a text font table index less than 1, then the implementation issues a BadPEXOutputCommand error.

If you attempt to use a font which is not available in the selected font group, then the text or annotation text primitive is rendered with the default font group. If a needed font is not available in the default font group, then the portion of the primitive specifying that font is rendered in an implementation-dependent way.

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

Errors

BadPEXOutputCommand
The output command contains an invalid value.

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 output attribute functions, see Output Attribute Functions.