This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PhMultiBlit()

Blit a multi-rectangular area within a region

Synopsis:

int PhMultiBlit( PhRid_t rid,
                 unsigned short nrects,
                 const PhRect_t rects[],
                 const PhPoint_t *offset );

Arguments:

rid

A pointer to a region ID from which the function will blit an area defined by rects.

nrects

The number of items in the rects array.

rects[]

A pointer to an array of PhRect_t structures that define the areas the function blits. The areas can overlap; Photon detects the overlaps and the contents are blitted only once.

offset

A pointer to a PhPoint_t that defines an offset for the blitted area defined by rects.

Library:

ph

Description:

This function "blits" the multi-rectangular area that is defined by the PhRect_t structures pointed to by rects and whose origin is defined by the origin of the region specified by the PhPoint_t structure pointed to by rid. The area is blitted by the given offset. Other windows aren't affected by the blit.

Returns:

A nonnegative value

Success.

-1

The blit failed, possibly because rid was incorrect or the Photon Manager wasn't running.

Classification:

Photon

See also:

PgBlit*(), PhPoint_t, PhRect_t, PtClippedBlit(), PtWidgetRid()