OpenGL#

pycuda.gl.make_context(dev, flags=0)#

Create and return a pycuda.driver.Context that has GL interoperability enabled.

Warning

This will fail with a rather unhelpful error message if you don’t already have a GL context created and active.

class pycuda.gl.graphics_map_flags#

Usage of OpenGL object from CUDA.

NONE#

Read and write access to mapped OpenGL object from CUDA code.

READ_ONLY#

Read only access to mapped OpenGL object from CUDA code.

WRITE_DISCARD#

Write only access to mapped OpenGL object from CUDA code. Reading is prohibited.

class pycuda.gl.RegisteredBuffer(bufobj, flags=CU_GRAPHICS_MAP_RESOURCE_FLAGS_NONE)#

Object managing mapping of OpenGL buffers to CUDA. Cannot be used to map images.

gl_handle()#
unregister()#
map(stream=None)#

Return a RegisteredMapping.

class pycuda.gl.RegisteredImage(bufobj, target, flags=CU_GRAPHICS_MAP_RESOURCE_FLAGS_NONE)#

Object managing mapping of OpenGL textures and render buffers to CUDA.

target must be be one of:

  • GL_TEXTURE_2D

  • GL_TEXTURE_RECTANGLE

  • GL_TEXTURE_CUBE_MAP

  • GL_TEXTURE_3D

  • GL_TEXTURE_2D_ARRAY

  • GL_RENDERBUFFER

(see PyOpenGL docs)

gl_handle()#
unregister()#
map(stream=None)#

Return a RegisteredMapping.

class pycuda.gl.RegisteredMapping#
unmap(stream=None)#

If no stream is specified, the unmap will use the same stream as the original mapping.

device_ptr_and_size()#

Return a tuple (dev_pointer, size).

array(index, level)#

Return an array for mapped image object for given array index and MIP level.

Automatic Initialization#

Warning

Importing pycuda.gl.autoinit will fail with a rather unhelpful error message if you don’t already have a GL context created and active.

pycuda.gl.autoinit.device#
pycuda.gl.autoinit.context#

Old-style (pre-CUDA 3.0) API#

pycuda.gl.autoinit.init()#

Enable GL interoperability for the already-created (so far non-GL) and currently active pycuda.driver.Context.

According to the forum post referenced in the note below, this will succeed on Windows XP and Linux, but it will not work on Windows Vista. There you have to create the GL-enabled context using make_context().

Warning

This function is deprecated since CUDA 3.0 and PyCUDA 2011.1.

Warning

This will fail with a rather unhelpful error message if you don’t already have a GL context created and active.

Note

See this post on the Nvidia forums for a discussion of problems and solutions with the GL interop interface.

class pycuda.gl.autoinit.BufferObject(bufobj)#

Warning

This class is deprecated since CUDA 3.0 and PyCUDA 2011.1.

unregister()#
handle#
map()#
class pycuda.gl.autoinit.BufferObjectMapping#

Warning

This class is deprecated since CUDA 3.0 and PyCUDA 2011.1. It will be removed in PyCUDA 0.96.

unmap()#
device_ptr()#
size()#