psychopy.tools.gltools.loadMtlFile

psychopy.tools.gltools.loadMtlFile(mtllib, texParams=None)[source]

Load a material library file (*.mtl).

Parameters:

  • mtllib (str) – Path to the material library file.

  • texParams (list or tuple) – Optional texture parameters for loaded textures. Texture parameters are specified as a list of tuples. Each item specifies the option and parameter. For instance, [(GL.GL_TEXTURE_MAG_FILTER, GL.GL_LINEAR), …]. By default, linear filtering is used for both the minifying and magnification filter functions. This is adequate for most uses.

Returns:

Dictionary of materials. Where each key is the material name found in the file, and values are Material namedtuple objects.

Return type:

dict

See also

loadObjFile

Load an *.OBJ file.

Examples

Load material associated with an *.OBJ file:

objModel = loadObjFile('/path/to/file.obj')
# load the material (*.mtl) file, textures are also loaded
mtllib = loadMtl('/path/to/' + objModel.mtlFile)

Use a material when rendering vertex arrays:

useMaterial(mtllib[material])
drawVAO(vao)
useMaterial(None)  # disable materials when done

Back to top