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

gf_context_set_surface_3d()

Associate a 3D surface with the draw context

Synopsis:

#include <gf/gf.h>

int gf_context_set_surface_3d( gf_context_t context,
                               EGLSurface 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 3D surface (EGLSurface) 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().

---

After calling eglSwapBuffer(), you need to call this function again.

---

Returns:

GF_ERR_OK

Success.

GF_ERR_PARM

The 3D 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

See also:

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