PEXOCCSetATextPath - Set Annotation Text Path (5.0)

Synopsis

 
   void PEXOCCSetATextPath(
          PEXOCC context,
          int path
     )

 
   void PEXSetATextPath(
           Display *display,
           XID resource_id,
           PEXOCRequestType req_type,
           int path
     )

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).
path: The text (drawing) path (PEXPathRight, PEXPathLeft, PEXPathUp or PEXPathDown).

Returns

None.

Description

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

The annotation text path defines the direction in which you want annotation text characters placed. PEXlib defines the following text paths (path):

PEXPathRight: places each character after the previous character in a character string along a baseline in the direction of a vector obtained by rotating the character up vector 90 degrees clockwise. (5.0)
PEXPathLeft: places each character after the previous character in a character string along a baseline in the opposite direction of a vector obtained by rotating the character up vector 90 degrees clockwise. (5.0)
PEXPathUp: places each character after the previous character in a character string in the direction of the character up vector. (5.0)
PEXPathDown: places each character after the previous character in a character string in the opposite direction of the character up vector. (5.0)

If you do not specify a text path, then the path defaults to PEXPathRight. If you specify an undefined path, then the implementation issues a BadPEXOutputCommand error.

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

Errors