PEXEncodeOCs - Encode Output Commands

Synopsis

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

Arguments

float_format: The floating-point format for the encoded output commands (PEXIEEE_754_32, PEXDEC_F_Floating, PEXIEEE_754_64 or PEXDEC_D_Floating).
oc_count: The number of output commands to be encoded.
oc_data: An 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 are specified.

Description

Invoke PEXEncodeOCs to assemble an encoded PEX protocol representation of output commands described by an array of PEXOCData data structures.

This function has no visible effect.

The data typically passed as parameters to output attribute or primitive functions is passed. The encoded data is returned in memory allocated by PEXlib. Invoke XFree to deallocate the memory.

If your implementation does not support the specified floating-point format, then this function returns a null pointer.

You must specify any text or annotation text primitives as encoded text or encoded annotation text.

Errors