Render cairo surface directly to OpenGL texture

I'm using cairo (http://cairographics.org) in combination with an OpenGL based 3D graphics library.

I'm currently using the 3D library on Windows, but I'm hoping to receive an answer that is platform independent. This is all done in c++.

I've got the straight forward approach working which is to use cairo_image_surface_create in combination with glTexImage2D to get an OpenGL texture.

However, from what I've been able to gather from the documentation cairo_image_surface_create uses a CPU-based renderer and writes the output to main memory.

I've come to understand cairo has a new OpenGL based renderer which renders its output directly on the GPU, but I'm unable to find concrete details on how to use it.

(I've found some details on th开发者_StackOverflowe glitz-renderer, but it seems to be deprecated and removed).

I've checked the surface list at: http://www.cairographics.org/manual/cairo-surfaces.html, but I feel I'm missing the obvious.

My question is: How do I create a cairo surface that renders directly to an OpenGL texture?

Do note: I'll need to be able to use the texture directly (without copying) to display the cairo output on screen.

As of 2015, Cairo GL SDL2 is probably the best way to use Cairo GL

https://github.com/cubicool/cairo-gl-sdl2

If you are on an OS like Ubuntu where cairo is not compiled with GL you will need to compile your own copy and let cairo-gl-sdl2 know where it is.

The glitz renderer has been replaced by the experimental cairo-gl backend.

You'll find a mention of it in: http://cairographics.org/OpenGL/

Can't say if it's stable enough to be used though.

Once you have a gl backend working, you can render into a Framebuffer Object to render directly in a given texture.

I did it using GL_BGRA.

int tex_w = cairo_image_surface_get_width(surface);
int tex_h = cairo_image_surface_get_height(surface);
unsigned char* data = cairo_image_surface_get_data(surface);

then do

glTexImage2D(GL_TEXTURE_2D, 0, 4, tex_w,tex_h, 0,GL_BGRA, GL_UNSIGNED_BYTE, data);

when you create the texture. Use glTexSubImage2D(...) to update th texture when the image content changes. For speed set the filters for the texture to GL_NEAREST