.\" @(#)PEXEncodeOCs.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXEncodeOCs 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXEncodeOCs \- Encode Output Commands
.SH SYNTAX
.LP
char *PEXEncodeOCs\^(\^int \fIfloat_format\fP\^, unsigned long \fIoc_count\fP\^, PEXOCData *\fIoc_data\fP\^, unsigned long *\fIlength_return\fP\^)
.SH PARAMETERS
.TP 1i
\fIfloat_format\fP
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
).
.TP
\fIoc_count\fP
The number of output commands to be encoded.
.TP
\fIoc_data\fP
An array of the output command data.
.TP
\fIlength_return\fP
Returns the length, in bytes, of the encoded output commands.
.SH RETURNS
A pointer to the encoded output commands; a null pointer if unsuccessful
or if zero output commands specified.
.SH DESCRIPTION
.\" indexing
.IX PEXEncodeOCs
.IX "Output Commands" PEXEncodeOCs
.LP
This function has no visible effect.  The data typically passed as parameters
to output attribute or primitive functions is passed in and encoded
into protocol formatted output commands.
The encoded data is returned in memory allocated by PEXlib.
.BR PEXFreeOCData (3)
should be called to deallocate the memory.
.LP
A null pointer will be returned if the specified floating point format is not
supported.
.LP
Any text or annotation text primitives must be specified as encoded text or
encoded annotation text.
.SH ERRORS
None
.SH SEE ALSO
.LP
.nf
.BR PEXDecodeOCs (3)
.fi