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

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

See also:

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