Unloads an add-on library previously loaded by Softimage, allowing add-on developers to compile an add-on library while in use in Softimage. The following add-on library types can be unloaded: compiled operators, compiled custom commands, run-time shaders, events.

These add-on libraries can also be unloaded from the Libraries dialog located in the main menu under File > Addon > Libraries... Once you have unloaded an add-on library, the Softimage object connected to the library (for example, operators, shaders, etc... ) is no longer affected by the add-on until the library is loaded back. You don't need to reload the add-on explicitly since Softimage automatically reloads it when required. For instance, a compiled operator library is reloaded when an evaluation is required.

UnloadAddonLib( FileName );

Parameter	Type	Description
FileName	String	The full path of the library to unload. Default Value: A file browser prompts the user for a file if no filename is provided.

VBScript Example

'

' This example demonstrates unloading an add-on library file

'

' Unload an add-on library file located in the factory path

myAddonLib = Application.InstallationPath( siFactoryPath ) & "\Addons\Application\bin\nt-x86-32\cpp_splatter.dll"

Application.LogMessage "Unloading: " & myAddonLib

UnloadAddonLib myAddonLib

'---------------------------------------------------------

' Output from this script:

'INFO : "Unloading: <FactoryPath>\Addons\Application\bin\nt-x86-32\cpp_splatter.dll"

UnloadAllAddonLibs ReloadAddonLib ReloadAllAddonLibs UnloadAllCOMLibs