Name

PEXDecodeOCs - Decode Output Commands

Synopsis

PEXOCData ∗PEXDecodeOCs(int float_format, unsigned long oc_count, unsigned long length, char ∗encoded_ocs)

Arguments

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

oc_countThe number of output commands represented in the encoded output commands. 

lengthThe length, in bytes, of the encoded output commands. 

encoded_ocsA pointer to the encoded output commands. 

Returns

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

Description

This function has no visible effect.  Encoded output commands are passed in and the data typically passed as parameters to output attribute or primitive functions is returned in memory allocated by PEXlib.  PEXFreeOCData 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 are returned as encoded text or encoded annotation text. 

PEXCountOCs can be used to determine the number of output commands in the encoded list if that information is not already available.

Errors

None

See Also

PEXEncodeOCs, PEXCountOCs