PhBlit()

Blit an area within a region

Synopsis:

int PhBlit( PhRid_t rid,
            const PhRect_t *rect,
            const PhPoint_t *offset );

Arguments:

rid
A pointer to a region ID within which the function will blit.
rect
A pointer to a PhRect_t structure that defines the area the function blits.
offset
A pointer to a PhPoint_t that defines an offset for the blitted area rect.

Library:

ph

Description:

This function “blits” the area that is defined by the PhRect_t structure pointed to by rect 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.

Examples:

PhRect_t rect = { 10,10,20,20};
PhPoint_t offset = { -5, 5 };
PhRect_t exposed = { 15, 10, 20, 15 };

// Blit the area bounded by (10,10), (20,20)
// five pixels left and five pixels down.

PhBlit( PtWidgetRid( region_widget ), &rect, &offset );
PtDamageExtent( region_widget, &exposed );

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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