Object Hierarchy | Related C++ Class: MaterialLibrary
Inheritance
SIObject
ProjectItem
Source
Library
MaterialLibrary
Introduced
5.0
Description
The material library object is a specialized source library for storing and sharing materials. The storage may be internal or external. If internal, the library is saved in the scene file. If external, the library is saved in a separate file. The library can be exported to and imported from dotXSI or a native binary format.
Methods
|
|
Properties
Examples
Python Example
#
# This example illustrates how to get a material library and how to
# enumerate all materials in a library
#
from win32com.client import constants as c
app = Application
app.NewScene( "", 0 )
# First create some libraries and materials
sph = app.ActiveSceneRoot.AddGeometry( "Sphere", "MeshSurface" )
app.ApplyShader( "", sph, "", "", c.siLetLocalMaterialsOverlap )
rtn = app.CreateLibrary( "", 1 )
lib = rtn(0)
#app.Selection.Add( lib )
lib.Name = "MyLibrary"
app.SetCurrentMaterialLibrary( lib )
# Now enumerate all materials in all libraries
scn = app.ActiveProject.ActiveScene
matlibs = scn.MaterialLibraries
app.LogMessage( "There are " + str(matlibs.Count) + " libraries under the scene." )
for currlib in matlibs :
app.LogMessage( currlib.Name + " has " + str(matlibs.Count) + " defined materials." )
for currmat in currlib.Items :
app.LogMessage( " - " + currmat.Name )
# Expected result:
#INFO : There are 2 libraries under the scene.
#INFO : DefaultLib has 2 defined materials.
#INFO : - Scene_Material
#INFO : - Material
#INFO : MyLibrary has 2 defined materials.
See Also
SOFTIMAGE|XSI v6.01