PEXSendOCs(3) — Subroutines

Name

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

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

resource_idThe resource identifier of the renderer or structure.

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

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 encoded output commands.

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

encoded_ocsA pointer to the encoded output commands.

Returns

None

Description

This function sends encoded output commands to the specified PEX server display.

Sending output commands to a structure whose editing mode is PEXStructureReplace, is not really useful. The behavior will be unpredictable unless a request type of PEXOCStoreSingle is used. And, if the request type is PEXOCStoreSingle, each output command will simply replace the previous one sent. Applications should ensure that the structure’s editing mode is PEXStructureInsert, when sending multiple output commands. If it is intended to replace multiple elements, the application can 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.

Museum