OpenGLContext.scenegraph.imagetexture

ImageTexture and MMImageTexture nodes using PIL

Classes

class _Texture( TextureNode ):

Mix-in for rendering static image textures

components

exposedField SFInt32 components 0

magFilter

field SFInt32 magFilter GL_NEAREST (9728)

minFilter

field SFInt32 minFilter GL_NEAREST (9728)

cached( self , mode = None )

Retrieve cached texture for this mode

compile( self , mode = None )

Compile (store our image in an OpenGL texture)

createTexture( self , image , mode = None )

Create a new texture-holding object

Uses the TextureCache to try to minimise the number of textures created

forTexture( cls , tex , mode )

Create a fake image texture node for the given on-card texture object

render( self , visible = 1 , lit = 1 , mode = None )

Called by Shape before rendering associated geometry

visible: whether a visible rendering pass, if not, no normals, colours, or textures
lit: whether lighting is enabled, if not, no normals

returns whether this is a transparent texture 0 if non-transparent, but a valid texture 1 if transparent None if not yet a valid texture

renderPost( self , mode = None )

Called after rendering geometry to disable the texture

Note: this does *not* disable the blend mode we established, it is left to the mode's post-rendering code to do this! As a result, if you use this code outside of a scenegraph you will need to add a call to reestablish the blending parameters you desire.

transparent( self , mode = None )

Does this texture have an alpha component?

class ImageTexture( _TextureImageTexture ):

A texture loaded from an image file

image

exposedField PILImage image None

url

exposedField MFString url []

loadBackground( self , url , contexts = () )

Load an image from the given url in the background

url: SF or MFString URL to load relative to the node's root's baseURL

On success: Sets the resulting PIL image to the client's image property (triggering an un-caching and re-compile if there was a previous image).

if contexts, iterate through the list calling context.triggerRedraw(1)

loadFromData( self , data , url = None )

Load (synchronously) from given data

setImage( self , image , contexts = () )

Set PIL image as our new image

image

class ImageURLField( MFString ):

Field for managing interactions with an Image's URL value

__del__( self , client , notify = 1 )

Delete the client's URL, which should delete the image as well

__set__( self , client , value , notify = True )

Set the client's URL, then try to load the image

fdel( self , client , notify = 1 )

Delete the client's URL, which should delete the image as well

fset( self , client , value , notify = True )

Set the client's URL, then try to load the image

class MMImageTexture( ImageTexture ):

Mip-mapped version of ImageTexture

Only significant differences are the use of the MMTexture class instead of Texture and the default for minFilter being GL_LINEAR_MIPMAP_NEAREST (which allows you to actually see the effects of mip-mapping).

minFilter

field SFInt32 minFilter GL_LINEAR_MIPMAP_NEA

createTexture( self , image , mode = None )

Create a new texture-holding object

class PILImage( Field ):

Simple field-type for holding PIL image objects

defaultDefault( self )

Get a default PIL image object

class PixelTexture( _TexturePixelTexture ):

PixelTexture, in-file node for small textures

createTexture( self , image , mode = None )

Create a new texture-holding object

Uses the TextureCache to try to minimise the number of textures created