Class
CoglRenderer
Description [src]
final class Cogl.Renderer : GObject.Object
{
/* No available fields */
}
Choosing a means to render
A CoglRenderer
represents a means to render. It encapsulates the
selection of an underlying driver, such as OpenGL or OpenGL-ES and
a selection of a window system binding API such as GLX or EGL.
A CoglRenderer
has two states, “unconnected” and “connected”. When
a renderer is first instantiated using cogl_renderer_new()
it is
unconnected so that it can be configured and constraints can be
specified for how the backend driver and window system should be chosen.
After configuration a CoglRenderer
can (optionally) be explicitly
connected using cogl_renderer_connect()
which allows for the
handling of connection errors so that fallback configurations can
be tried if necessary. Applications that don’t support any
fallbacks though can skip using cogl_renderer_connect()
and leave
Cogl to automatically connect the renderer.
Once you have a configured CoglRenderer
it can be used to create a
CoglDisplay
object using cogl_display_new().
Constructors
cogl_renderer_new
Instantiates a new (unconnected) CoglRenderer
object. A
CoglRenderer
represents a means to render. It encapsulates the
selection of an underlying driver, such as OpenGL or OpenGL-ES and
a selection of a window system binding API such as GLX or EGL.
Instance methods
cogl_renderer_connect
Connects the configured renderer
. Renderer connection isn’t a
very active process, it basically just means validating that
any given constraint criteria can be satisfied and that a
usable driver and window system backend can be found.
cogl_renderer_create_dma_buf
Creates a new CoglFramebuffer
with width
x height
, with pixel
format format
, and exports the new framebuffer’s DMA buffer handle.
cogl_renderer_get_proc_address
Gets a pointer to a given GL or GL ES extension function. This acts as a wrapper around glXGetProcAddress() or whatever is the appropriate function for the current backend.
cogl_renderer_set_driver
Requests that Cogl should try to use a specific underlying driver for rendering.
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.