PgBlit(), PgBlitCx()

Blit an area

Synopsis:

int PgBlit( const PhRect_t *rect,
            const PhPoint_t *offset );

int PgBlitCx( void dc,
              const PhRect_t *rect,
              const PhPoint_t *offset );

Arguments:

dc
PgBlitCx() only. A void pointer to any type of draw context. Examples of draw contexts are:
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:

These functions “blit” the area that is defined by rect. The area is blitted by the given offset. Other windows aren't affected by the blit.

PgBlit() blits the region defined by the region set for the current draw context, while PgBlitCx() lets you define the draw context dc.


Note: To blit an area defined by more than one rectangle, use PgMultiBlit() or PgMultiBlitCx().

Returns:

A nonnegative value
Success.
-1
The blit failed, possibly because the Photon Manager wasn't running.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PgMultiBlit*() PhBlit(), PhPoint_t, PhRect_t, PtClippedBlit(), PtWidgetRid()