SIImportReferencedMatLib

Introduced

6.0

Description

Imports a .xsi file-based material library as a referenced file. Only the SI_MaterialLibrary part of the file is read. It becomes part of the scene as if merged. The original path is maintained and the library itself is flagged locked.

Note: This command is an alias for the command SIImportMatLib with the ShareOptions parameter forced to siImportShareOptionsMaterials.

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

SIImportReferencedMatLib( FileName, [Value] )

Parameters

Parameter

Type

Description

FileName [in/out]

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

Value [out]

MaterialLibrary

Returns the library created

See Also

SIImportMatLib

ExportMaterialLibrary

Material.Library

Scene.ActiveMaterialLibrary



Autodesk Softimage v7.5