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_check_onscreen_template
Tests if a given onscreen_template can be supported with the given
renderer.
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_foreach_output
Iterates all known display outputs for the given renderer and
passes a corresponding CoglOutput pointer to the given callback
for each one, along with the given user_data.
cogl_renderer_set_driver
Requests that Cogl should try to use a specific underlying driver for rendering.
cogl_renderer_set_winsys_id
This allows you to explicitly select a winsys backend to use instead of letting Cogl automatically select a backend.
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.