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.


Note: 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

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_draw_blit2(), gf_draw_blitscaled()