OpenGLContext.scenegraph.text.glutfont

GLUT-based fonts

Classes

class _GLUTFontProvider( FontProvider ):

Singleton for creating new GLUTBitmapFonts

create( self , fontStyle , mode = None )

Create a new font for the given fontStyle and mode

enumerate( self , mode = None )

Iterate through all available fonts (whether instantiated or not)

Just returns the bitmapFonts keys, which will get each of the font-types which are available.

fontHash( family , size )

Given family and size get hashable key for lookups

OpenGL-ctypes gives you the underlying GLUT font void*, whereas PyOpenGL gave you an integer value

key( self , fontStyle = None )

Calculate our "font key" for the fontStyle

If the font-key changes, we should be invalidating our caches, but at the moment we aren't caching anything 3-D providers will add the various 3-D-specific fields from the FontStyle3D node.

match( self , fontStyle = None , mode = None )

Attempt to find matching font for our fontstyle

GLUT only provides a tiny number of fonts, so this method is just scanning through the entire set looking for something close.

class GLUTBitmapFont( NoDepthBufferMixInBitmapFontMixInFont ):

A GLUT-provided Bitmap Font

XXX current doesn't pay attention to fontStyle, should get justification from it at least.

__init__( self , fontStyle = None , specifier = None , charHeight = 0 )

Initialise the bitmap font

createChar( self , char , mode = None )

Create the single-character display list

lineHeight( self , mode = None )

Retrieve normal line-height for this font

lists( self , value , mode = None )

Get a sequence of display-list integers for value

Basically, this does a bit of trickery to do as-required compilation of display-lists, so that only those characters actually required by the displayed text are compiled.

NOTE: Must be called from within the rendering thread and within the rendering pass!