PEXOCCSetCharUpVector - Set Character Up Vector (5.0)

Synopsis

 
     void PEXOCCSetCharUpVector(
          PEXOCC context,
          PEXVector2D *vector
     )

     void PEXSetCharUpVector(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          PEXVector2D *vector
     )

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).
vector: The text character up vector.

Returns

None.

Description

Invoke PEXOCCSetCharUpVector to create an attribute output command which sets the text up vector attribute in the renderer's pipeline state according to the value specified by vector.

Use the character up vector to define the up direction for characters in the text plane.

Specify vector in text local coordinates. The direction vectors associated with the text primitive define this local coordinate system.

If the text up vector you specify is degenerate (e.g., it has a length of zero), then the vector defaults to a value of <0,1>.

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

Errors