PEXOCCSetATextUpVector - Set Annotation Text Up Vector (5.0)

Synopsis

   void PEXOCCSetATextUpVector(
        PEXOCC context,
        PEXVector2D *vector
    )
 

 
   void PEXSetATextUpVector(
           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 annotation text character up vector.

Returns

None.

Description

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

The annotation text up vector defines the up direction for characters. Specify vector in text local coordinates. The implementation only applies the direction of the vector, not the magnitude.

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

This function is a member of the annotation attribute set and affects all annotation text output 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 output attribute functions, see Output Attribute Functions.