Class pyglet.gl.Context

OpenGL context for drawing.

Windows in pyglet each have their own GL context. This class boxes the context in a platform-independent manner. Applications will have no need to deal with contexts directly.

Methods

  __init__(self, context_share=None)
  __repr__(self)
  set_current(self)
  destroy(self)
Release the context.
  delete_texture(self, texture_id)
Safely delete a texture belonging to this context.
  delete_buffer(self, buffer_id)
Safely delete a buffer object belonging to this context.

Instance Variables

ObjectSpace object_space
An object which is shared between all contexts that share GL objects.

Constants

  CONTEXT_SHARE_NONE = None
Context share behaviour indicating that objects should not be shared with existing contexts.
  CONTEXT_SHARE_EXISTING = 1
Context share behaviour indicating that objects are shared with the most recently created context (the default).

Method Details

destroy

destroy(self)

Release the context.

The context will not be useable after being destroyed. Each platform has its own convention for releasing the context and the buffer(s) that depend on it in the correct order; this should never be called by an application.

delete_texture

delete_texture(self, texture_id)

Safely delete a texture belonging to this context.

Usually, the texture is released immediately using glDeleteTextures, however if another context that does not share this context's object space is currently active, the deletion will be deferred until an appropriate context is activated.

Parameters:
texture_id : int
The OpenGL name of the texture to delete.

delete_buffer

delete_buffer(self, buffer_id)

Safely delete a buffer object belonging to this context.

This method behaves similarly to delete_texture, though for glDeleteBuffers instead of glDeleteTextures.

Parameters:
buffer_id : int
The OpenGL name of the buffer to delete.

Since: pyglet 1.1