gf_context_unset_surface()

Disassociate a surface from the draw context

Synopsis:

#include <gf/gf.h>

int gf_context_unset_surface( gf_context_t context )

Arguments:

context: The draw context to disassociate a surface from.

Library:

gf

Description:

This function removes a surface from the draw context. Any subsequent rendering that is done via this context affects the newly targeted surface. After you call this function, a call to gf_draw_begin() will fail with the error GF_ERR_PARM until you associate a new surface with the draw context.

Returns:

GF_ERR_OK: Success.
GF_ERR_INUSE: The context is rendering. Call gf_draw_end() first.

Classification:

QNX Graphics Framework

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes

See also:

gf_context_create(), gf_context_free(), gf_context_set_surface(), gf_surface_create()