## SIImportMatLib

### Description

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#).

### Scripting Syntax

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

### Parameters

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

### Examples

#### 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

### See Also

ExportMaterialLibrary SIImportReferencedMatLib Material.Library Scene.ActiveMaterialLibrary