OpenGLContext.texture

Resource-manager for textures (with PIL conversions)

Functions

_textureDeleter( textureID )

Create function to clean up the texture on deletion

bestSize( dim )

Try to figure out the best power-of-2 size for the given dimension

At the moment, this is the next-largest power-of-two which is also <= glGetInteger( GL_MAX_TEXTURE_SIZE ).

getLengthFormat( image )

Return PIL image component-length and format

This returns the number of components, and the OpenGL mode constant describing the PIL image's format. It currently only supports GL_RGBA, GL_RGB and GL_LUMINANCE formats (PIL: RGBA, RGBX, RGB, and L), the Texture object's ensureRGB converts Paletted images to RGB before they reach this function.

Classes

class CubeTexture( Texture ):

Texture class for use with Cube samplers

__call__( self )

Enable and select the texture... See: glBindTexture, glEnable(GL_TEXTURE_2D)

__enter__( self )

Enable and select the texture... See: glBindTexture, glEnable(GL_TEXTURE_2D)

__exit__( self , typ , val , tb )

Disable for context-manager behaviour

__init__( self , images = None , format = None )

Initialise the texture, if image is not None, store it

images: optional name:image mapping with keys from -x,+y,-y,+y,-z,+z

fromPIL( self , images )

Construct the texture from PIL/Numpy arrays

store( self , components , format , x , y , images )

Store our images in the appropriate format

class MMTexture( Texture ):

Mip-mapped texture object

Note: You'll want your images to use minFilter = GL_LINEAR_MIPMAP_NEAREST to actually see any effect from using a MMTexture.

ensurePow2( self , image )

Ensure that the PIL image is pow2 x pow2 dimensions

Mip-mapping does this already if I'm not mistaken, so we just return image unchanged.

store( self , components , format , x , y , image )

define the texture's parameters... components -- number of components (3 or 4 for RGB and RGBA respectively) format -- GL_RGB, GL_RGBA, GL_LUMINANCE x,y -- dimensions of the image image -- string, data in raw (unencoded) format

class NumpyAdapter( object ):

__init__( self , array )

resize( self , * args , ** named )

shapeToMode( cls , size )

tostring( self , * args , ** named )

class Texture( object ):

Holder for an OpenGL compiled texture

This object holds onto a texture until it is deleted. Provides methods for storing raw data or PIL images (store and fromPIL respectively)

Attributes: components -- number of components in the image, if 0, then there is no currently stored image texture -- OpenGL textureID as returned by a call to glGenTextures(1), will be freed when the Texture object is deleted format -- GL_RGB/GL_RGBA/GL_LUMINANCE

__call__( self )

Enable and select the texture... See: glBindTexture, glEnable(GL_TEXTURE_2D)

__enter__( self )

Enable and select the texture... See: glBindTexture, glEnable(GL_TEXTURE_2D)

__exit__( self , typ , val , tb )

Disable for context-manager behaviour

__init__( self , image = None , format = None )

Initialise the texture, if image is not None, store it

image: optional PIL image to store

ensurePow2( self , image )

Ensure that the PIL image is pow2 x pow2 dimensions

Note: This method will create a _new_ PIL image if the image is not a valid size (It will use BICUBIC filtering (from PIL) to do the resizing). Otherwise just returns the same image object.

ensureRGB( self , image )

Ensure that the PIL image is in RGB mode

Note: This method will create a _new_ PIL image if the image is in Paletted mode, otherwise just returns the same image object.

fromPIL( self , image )

Automated storage of image data from a PIL Image instance

Uses the ensureRGB method to convert the image to RGB, then ensurePow2 to make the image a valid size for OpenGL, then calls self.store(...) with the appropriate arguments.

Returns the number of components in the image

pilAsString( image )

Convert PIL image to string pointer

store( self , components , format , x , y , image )

define the texture's parameters... components -- number of components (3 or 4 for RGB and RGBA respectively) format -- GL_RGB, GL_RGBA, GL_LUMINANCE x,y -- dimensions of the image image -- string, data in raw (unencoded) format

See: glBindTexture, glPixelStorei, glTexImage2D

update( self , lower_left , size , data )

Update the texture with new data