Offscreen Framebuffers

Offscreen Framebuffers — Fuctions for creating and manipulating offscreen framebuffers.

Functions

CoglOffscreen * cogl_offscreen_new_to_texture ()
gboolean cogl_is_offscreen ()

Description

Cogl allows creating and operating on offscreen framebuffers.

Functions

cogl_offscreen_new_to_texture ()

CoglOffscreen *
cogl_offscreen_new_to_texture (CoglTexture *texture);

This creates an offscreen buffer object using the given texture as the primary color buffer. It doesn't just initialize the contents of the offscreen buffer with the texture ; they are tightly bound so that drawing to the offscreen buffer effectivly updates the contents of the given texture. You don't need to destroy the offscreen buffer before you can use the texture again.

This only works with low-level CoglTexture types such as CoglTexture2D, CoglTexture3D and CoglTextureRectangle, and not with meta-texture types such as CoglTexture2DSliced.

Parameters

texture

A CoglTexture pointer

 

Returns

a newly instantiated CoglOffscreen framebuffer or NULL if it wasn't possible to create the buffer.

[transfer full]


cogl_is_offscreen ()

gboolean
cogl_is_offscreen (void *object);

Determines whether the given CoglObject references an offscreen framebuffer object.

Parameters

object

A pointer to a CoglObject

 

Returns

TRUE if object is a CoglOffscreen framebuffer, FALSE otherwise

Types and Values