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

gf_context_set_surface()

Associate a surface with the draw context

Synopsis:

#include <gf/gf.h>

int gf_context_set_surface(
        gf_context_t context,
        gf_surface_t surface );

Arguments:

context
The draw context to associate a surface with.
surface
The handle for the surface to target. This handle is returned by gf_surface_create().

Library:

gf

Description:

This function associates a surface for the draw context (or if there already is a surface associated with the context, this function allows you to target a new one). Any subsequent rendering that is done via this context affects the newly targeted surface. You can disassociate the surface from the context by calling gf_context_unset_surface().


Note:
  • You can migrate a context to any surface, even if the new surface is on a different device.
  • While it is acceptable to call any other gf_context_set_*() function while you are rendering (between calls to gf_draw_begin() and gf_draw_end()), calling gf_context_set_surface() during this time has no effect.

Returns:

GF_ERR_OK
Success.
GF_ERR_PARM
The 2D engine can't render to the surface.
GF_ERR_MEM
An error ocurred while allocating working memory.
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_unset_surface(), gf_surface_create()