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:

• a PhDrawContext_t returned by PhDCCreate()
• a PmMemoryContext_t returned by PmMemCreateMC()
• a PpPrintContext_t returned by PpCreatePC()
• a PdOffscreenContext_t returned by PdCreateOffscreenContext()

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.

---

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

See also:

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