TexturePixmapX11.left


Description:

public TexturePixmapX11.left (Context context, uint32 pixmap, Bool automatic_updates) throws Error

Creates one of a pair of textures to contain the contents of pixmap, which has stereo content.

(Different images for the right and left eyes.) The left image is drawn using this texture; the right image is drawn using a texture created by calling cogl_texture_pixmap_x11_new_right and passing in this texture as an argument.

In general, you should not use this function unless you have queried the glx_stereo_tree_ext attribute of the corresponding window using glXQueryDrawable and determined that the window is stereo. Note that this attribute can change over time and notification is also provided through events defined in the EXT_stereo_tree GLX extension. As long as the system has support for stereo content, drawing using the left and right pixmaps will not produce an error even if the window doesn't have stereo content any more, but drawing with the right pixmap will produce undefined output, so you need to listen for these events and re-render to avoid race conditions. (Recreating a non-stereo pixmap is not necessary, but may save resources.)

Parameters:

context

A Context

pixmap

A X11 pixmap ID

automatic_updates

Whether to automatically copy the contents of the pixmap to the texture.

Returns:

a new TexturePixmapX11 instance