Implements OBJ loading into OpenGLContext scenegraph nodes
 
Based on the Pyglet OBJ loader in the contrib files section which is
licensed under the following license:
 
    Copyright (c) 2006-2008 Alex Holkner
    All rights reserved.
 
    Redistribution and use in source and binary forms, with or without
    modification, are permitted provided that the following conditions are met:
 
      * Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.
      * Redistributions in binary form must reproduce the above copyright 
        notice, this list of conditions and the following disclaimer in
        the documentation and/or other materials provided with the
        distribution.
      * Neither the name of pyglet nor the names of its
        contributors may be used to endorse or promote products
        derived from this software without specific prior written
        permission.
 
    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
    FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
    COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
    BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
    LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
    ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
    POSSIBILITY OF SUCH DAMAGE.
 
        From the pyglet svn:
        http://pyglet.googlecode.com/svn/trunk/contrib/model/model/obj.py
        Last revised on March 7, 2008 by Alex Holkner (revision 1884)
 
        Additions/changes by Jim Getzen on June 2, 2008:
        Fixed a bug in the OBJ.load_material_library method:
        'emissive' changed to 'emission'
 
        Added a color argument to the OBJ.draw method.
        Added a color argument to the Mesh.draw method.
        Added code the Mesh.draw method to enable glColorMaterial
        capability (allowing objects to be temporarily recolored).
 
        Added OBJ.compile convenience method to compile all of an
        OBJ's meshes.
 
        Commented out the glDisable(GL_TEXTURE_2D) in the 'apply'
        method of Material. It interfered with the shadow mapping
        OpenGL state settings.
 
Note:
 
    This is only a tiny fraction of the OBJ file format, for an idea of how much 
    is left out, see:
    
        http://people.scs.fsu.edu/~burkardt/txt/obj_format.txt

Modules
		OpenGLContext.loaders.base OpenGLContext.scenegraph.basenodes OpenGLContext.loaders.loader urllib

Classes
		BaseHandler(object) OBJHandler   class OBJHandler(BaseHandler)     Scenegraph loader which loads individual OBJ files as scenegraphs     Method resolution order: OBJHandler BaseHandler object Methods defined here: defaultMaterial(self) load_material_library(self, url, materials, baseURL=None) Load the materials in resource into the materials set parse(self, data, baseURL, *args, **named) Parse the loaded data (with the provided meta-information)   This implementation simply creates VRML97 scenegraph nodes out  of the .obj format data. Data and other attributes defined here: filename_extensions = ['.obj', '.obj.gz'] Methods inherited from BaseHandler: __call__(self, baseURL, filename, file, *args, **named) Load encoded scenegraph from the file   baseURL -- the URL from which the file was loaded filename -- the local filename for the file file -- open read-only file handle   Returns a scenegraph or None getData(self, baseURL, filename, file) Retrieve data to be parsed   Will handle gunzipping data which has .gz extension Class methods inherited from BaseHandler: gunzip(cls, file) from type Get a gzip-aware file for the given file handle isGzip(cls, file) from type Determine whether the data is a gzip stream Data descriptors inherited from BaseHandler: __dict__ dictionary for instance variables (if defined) __weakref__ list of weak references to the object (if defined)

Functions
		defaultHandler() Default handler instance used for loading standard obj files md5 = openssl_md5(...) Returns a md5 hash object; optionally initialized with a string

Data
		DEBUG = 10 __file__ = '/home/mcfletch/pylive/OpenGLContext/loaders/obj.pyc' __name__ = 'OpenGLContext.loaders.obj' __package__ = 'OpenGLContext.loaders' loader_log = <logging.Logger instance at 0x35f8fc8>