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

gf_draw_blit1()

Blit an area within a surface

Synopsis:

#include <gf/gf.h>

int gf_draw_blit1( gf_context_t context,
                   int          sx1,
                   int          sy1,
                   int          sx2,
                   int          sy2,
                   int          dx1,
                   int          dy1 );

Arguments:

context

Handle for the draw context to use. The targeted surface for this context is used as the source and destination surface.

sx1, sy1

The coordinates of the upper-left corner of the source area to blit from.

sx2, sy2

The coordinates of the lower-right corner of the source area to blit from.

dx1, dy1

The coordinates of the offset point on the display to blit the area to.

Library:

gf

Description:

This function performs a simple BLock Image Transfer (BLIT, or pixel copy) from one area to another area of a surface associated with the given context. The source and destination areas may overlap.

---

The destination rectangle is subject to clipping. The source rectangle is not, although it is subject to the boundaries of the surface.

---

Returns:

GF_ERR_OK

Success.

GF_ERR_PARM

Invalid source rectangle.

GF_ERR_NOLOCK

The hardware isn't locked; check to ensure gf_draw_begin() was called successfully.

Classification:

QNX Graphics Framework

See also:

gf_draw_blit2(), gf_draw_blitscaled()