PEXSendOCs - Send Encoded Output Commands

Synopsis 

   void PEXSendOCs(
         Display *display,
         XID resource_id,
         PEXOCRequestType req_type,
         int float_format,
         unsigned long oc_count,
         unsigned int length,
         char *encoded_ocs
    )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id
The resource identifier of the renderer or structure.

req_type
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

float_format
The floating-point format of the encoded output commands (PEXIEEE_754_32, PEXDEC_F_Floating, PEXIEEE_754_64 or PEXDEC_D_Floating).

oc_count
The number of encoded output commands.

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

encoded_ocs
A pointer to the encoded output commands.

Returns

None.

Description

Invoke PEXSendOCs to send encoded output commands to the specified PEX implementation.

Sending output commands to a structure which has an editing mode of PEXStructureReplace, is not really useful. The behavior is unpredictable unless a request type of PEXOCStoreSingle is used. If you specify a request type of PEXOCStoreSingle, then each output command simply replaces the previous one sent. You should ensure that the structure's editing mode is PEXStructureInsert, when sending multiple output commands. If it is intended to replace multiple elements, then delete those elements first, and then insert the new ones.

Errors

BadPEXFloatingPointFormat
The specified floating-point format is invalid or unsupported.

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For a list of related topics and functions, see Sending Encoded Output Commands.