PEXOCCSetATextStyle - Set Annotation Text Style (5.0)


Synopsis

 
   void PEXOCCSetATextStyle(
          PEXOCC context,
          int style
     )
 

 
   void PEXSetATextStyle(
           Display *display,
           XID resource_id,
           PEXOCRequestType req_type,
           int style
      )
 

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

style
The annotation text style (PEXATextNotConnected or PEXATextConnected).

Returns

None.

Description

Invoke PEXOCCSetATextStyle to create an attribute output command which sets the annotation text style attribute in the renderer's pipeline state according to the value specified by style.

The annotation text style describes if and how you want annotation text offset rendered. PEXlib defines the following annotation text styles (style):

PEXATextNotConnected
no line connects the annotation point to the reference point of the annotation text primitive. (5.0)
PEXATextConnected
a line connects the annotation to the reference points of the annotation text primitive. PEXlib uses the current line attributes to render this line. (5.0)

If the implementation does not support the specified style, then the style defaults to PEXATextNotConnected. Inquire the supported values for the annotation text style by invoking the PEXGetEnumTypeInfo function.

This function is a member of the annotation attribute set and affects all annotation 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.