Skip to main content
`Ctrl`+`K`

# vispy.gloo.globject module

Base gloo object

## On queues

The queue on the GLObject can be associated with other queues. These can be queues of other gloo objects, or of the canvas.context. Queues that are associated behave as if they are a single queue; this allows GL commands for two or more interdependent GL objects to be combined such that they are always sent to the same context together.

A program associates the textures/buffers when they are set via __setitem__. A FrameBuffer does so when assigning buffers. A program associates itself with the canvas.context in draw(). A FrameBuffer does the same in activate().

Example:

  prog1, prog2 = Program(), Program() tex1, tex2 = Texture(), Texture()

  prog1.glir.associate(tex1.glir) # prog1 and tex1 now share a queue prog2.glir.associate(tex2.glir) # prog2 and tex2 now share a queue

  # this causes prog1, tex1, and canvas.context to all share a queue: canvas.context.glir.associate(prog1.glir) # and now all objects share a single queue canvas.context.glir.associate(prog2.glir)

Now, when the canvas flushes its queue, it takes all the pending commands from prog1, prog2, tex1, and tex2.

class vispy.gloo.globject.GLObject

  Bases: `object`

  Generic GL object that represents an object on the GPU.

  When a GLObject is instantiated, it is associated with the currently active Canvas, or with the next Canvas to be created if there is no current Canvas

  delete()

    Delete the object from GPU memory.

    Note that the GPU object will also be deleted when this gloo object is about to be deleted. However, sometimes you want to explicitly delete the GPU object explicitly.

  property glir

    The glir queue for this object.

  property id

    The id of this GL object used to reference the GL object in GLIR. id’s are unique within a process.