Imports a material library in the form of a .xsi file. Only the SI_MaterialLibrary part of the file is read. It becomes part of the scene as if merged.

Note: If the Reference flag is set, original path is maintained and the library itself is flagged locked. If the Reference flag is not set, the original path is lost.

Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:

For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.

For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

SIImportMatLib( FileName, [ShareOptions], [Value] );

Parameter	Type	Description
FileName	String	Name of the model file to import. Default Value: If this parameter is not specified, a browser pops up, prompting the user to pick an .xsi file
ShareOptions	siImportShareOptions	Bit field values of type Integer that specify whether to import the model as a reference model Default Value: siImportShareOptionsNone
Value	MaterialLibrary	Returns the library created

VBScript Example

' 

'	This example illustrates how to import a material library (first the 

'	library is created and then exported).

' First create some libraries and materials

NewScene , false

CreatePrim "Sphere", "MeshSurface"

ApplyShader , , , , siLetLocalMaterialsOverlap

CreateLibrary

SelectObj "Sources.Materials.MaterialLibrary"

SetValue "Sources.Materials.MaterialLibrary.Name", "MyLibrary"

SetCurrentMaterialLibrary "Sources.Materials.MyLibrary"

SelectObj "sphere", , true

ApplyShader , , , , siLetLocalMaterialsOverlap

' Then export the scene in a .xsi file

dotXSIFile = Application.InstallationPath( siUserPath ) & "\MyMatLib4Import.xsi"

SIExportDotXSIFile ActiveSceneRoot, dotXSIFile

' Dump everything and import the material library

NewScene , false

SIImportMatLib dotXSIFile

ExportMaterialLibrary SIImportReferencedMatLib Material.Library Scene.ActiveMaterialLibrary