Name

PEXFetchElementsAndSend - Fetch Elements and Send to Display

Synopsis

Status PEXFetchElementsAndSend(Display ∗src_display, PEXStructure structure, int whence1, long offset1, int whence2, long offset2, Display ∗dst_display, XID resource_id, PEXOCRequestType req_type)

Arguments

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

structureThe resource identifier of the structure. 

whence1A value specifying, with offset1, the first limit of the range of elements to be fetched (PEXBeginning, PEXCurrent, PEXEnd).

offset1The offset from whence1 denoting the first limit of the range of elements to be fetched. 

whence2A value specifying, with offset2, the second limit of the range of elements to be fetched (PEXBeginning, PEXCurrent, PEXEnd).

offset2The offset from whence2 denoting the second limit of the range of elements to be fetched. 

dst_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 commands (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

Returns

Zero if unsuccessful, non-zero otherwise. 

Description

This function is like PEXFetchElements except that the list of output commands are not returned to the application but are sent directly to the specified destination display.

Calling this function is similar to calling PEXFetchElements, and then sending the returned list of output commands by calling PEXStartOC, PEXCopyBytesToOC and PEXFinishOC.

If the destination display does not support the same floating point format as the format PEXlib is using with the source display, and if PEXlib can not convert to a format supported by the destination display, the function will return unsuccessfully. 

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.

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

BadValueThe specified value for whence parameter is invalid. 

See Also

PEXFetchElements