.\" @(#)PEXSetCharUpVector.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetCharUpVector 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetCharUpVector - Set Character Up Vector
.SH SYNTAX
.HP
void PEXSetCharUpVector\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, PEXVector2D *\fIvector\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIvector\fP 1i
The text character up vector.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetCharUpVector
.LP
This function creates an output primitive attribute which
sets the text up
.I vector
attribute.
The
.I vector
is specified in the text local coordinate system defined by the
direction vectors associated with the annotation text primitive.
If the annotation text up
.I vector
is degenerate (it has a length of zero), a value <0,1> is used.
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.