Name

PEXEncodeOCs - Encode Output Commands

Synopsis

char ∗PEXEncodeOCs(int float_format, unsigned long oc_count, PEXOCData ∗oc_data, unsigned long ∗length_return)

Arguments

float_formatThe floating point format for the encoded output commands (PEXIEEE_754_32, PEXDEC_F_Floating, PEXIEEE_754_64, PEXDEC_D_Floating).

oc_countThe number of output commands to be encoded. 

oc_dataAn array of the output command data. 

length_return
Returns the length, in bytes, of the encoded output commands.

Returns

A pointer to the encoded output commands; a null pointer if unsuccessful or if zero output commands specified. 

Description

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.  XFree should be called to deallocate the memory.

A null pointer will be returned if the specified floating point format is not supported. 

Any text or annotation text primitives must be specified as encoded text or encoded annotation text. 

Errors

None

See Also

PEXDecodeOCs