.\" @(#)PEXSendOCs.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSendOCs 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSendOCs - Send Encoded Output Commands
.SH SYNTAX
.HP
void PEXSendOCs\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIfloat_format\fP\^, unsigned long \fIoc_count\fP\^, unsigned int \fIlength\fP\^, char *\fIencoded_ocs\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 \fIfloat_format\fP 1i
The floating point format of the encoded output commands (
.B PEXIEEE_754_32,
.B PEXDEC_F_Floating,
.B PEXIEEE_754_64,
.B PEXDEC_D_Floating
).
.IP \fIoc_count\fP 1i
The number of encoded output commands.
.IP \fIlength\fP 1i
The length, in bytes, of the encoded output commands.
.IP \fIencoded_ocs\fP 1i
A pointer to the encoded output commands.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSendOCs
.IX "Output Commands" PEXSendOCs
.LP
This function sends encoded output commands to the specified
PEX server display.
.LP
Sending output commands to a structure whose editing mode is
.B PEXStructureReplace
is not really useful.  The behavior will be unpredictable
unless a request type of
.B PEXOCStoreSingle
is used.  And, if the request type is
.B PEXOCStoreSingle,
each output command will simply replace the previous one sent.
Applications should ensure that the structure's editing mode is
.B PEXStructureInsert,
when sending multiple output commands.  If it is intended to replace multiple
elements, the application can delete those elements first, and then insert the
new ones.
.SH ERRORS
.TP
.SB BadPEXFloatingPointFormat
The specified floating point format is invalid or unsupported.
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXDecodeOCs (3)
.BR PEXEncodeOCs (3)
.fi