.\" @(#)PEXSetATextUpVector.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetATextUpVector 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetATextUpVector - Set Annotation Text Up Vector
.SH SYNTAX
.HP
void PEXSetATextUpVector\^(\^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 annotation text character up vector.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetATextUpVector
.IX "Annotation Text" PEXSetATextUpVector
.LP
This function creates an output primitive attribute which
sets the annotation 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.
Only the direction of the
.I vector
is used, not the magnitude.
However, 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.