XSIApplication.InstallAddon

説明

.xsaiaddon ファイルを Softimage にインストールします。アドオンファイルは一連のカスタマイズされたアイテム(レイアウト、ツールバー、プリセットなど)であり、1 つのファイルにパッケージ化されています。アドオンのパッケージング、インストール、アンインストールは Softimage オブジェクトモデルを使用して実行できます。

C#構文

XSIApplication.InstallAddon( String in_bszFileName, siInstallationPath in_eInstallDir, Boolean in_bBatch );

スクリプト構文

XSIApplication.InstallAddon( FileName, [InstallDir], [NoUI] );

パラメータ

パラメータ タイプ 説明
FileName String インストールするアドオンファイルのファイルパス
InstallDir siInstallationPath アドオンがインストールされる先のディレクトリ

推奨値は siUserAddonPath および siWorkgroupAddonPath です。siUnknownPath を指定すると、アドオンファイルに指定されているデフォルトの場所にアドオンがインストールされます。

注:複数のワークグループがある場合、このメソッドはリストの最初のワークグループをインストールします。

デフォルト値:siUnknownPath

NoUI Boolean このオプションパラメータを使用すると、アドオンのインストール時に警告メッセージボックスが表示されないようにできます。このパラメータは、Softimage をバッチモードで実行する場合は自動的に設定されます。

デフォルト値: false

JScript の例

//

// This example demonstrates how to install an add-on package.

//

// Get the first available workgroup as the add-on destination 

var sPath = Application.InstallationPath( siWorkgroupPath );

if ( !sPath ) {

	// If the workgroup doesn't already exist, then add it

	var tmppath = XSIUtils.BuildPath( Application.InstallationPath(siUserPath), "TempWorkgrp" );

	var fso = new ActiveXObject( "Scripting.FileSystemObject" );

	if ( !fso.FolderExists(tmppath) ) { fso.CreateFolder(tmppath); }

	Application.AddWorkgroup( tmppath );

	sPath = Application.InstallationPath( siWorkgroupPath );

}

var sHTMLName = makeHTMLPage();

// Create the add-on package object

var oAddOn = Application.CreateAddon();

// Add the HTML page to the add-on package

oAddOn.AddOtherItem( sHTMLName );

// Save the package in the Addons directory

sPath = XSIUtils.BuildPath( sPath, "Addons" );

XSIUtils.EnsureFolderExists( sPath );

var sAddOnFileName = XSIUtils.BuildPath( sPath, "myHelpPkg.xsiaddon" );

oAddOn.Save( sAddOnFileName );

Application.LogMessage( "Created add-on file: " + sAddOnFileName );

// Install the add-on package containing the HTML page

Application.InstallAddOn( sAddOnFileName, siWorkgroupAddonPath );

// Comment out the following line if you want to see the add-on file 

// (you will have to uninstall the add-on manually):

Application.UnInstallAddon( sAddOnFileName );

// **********************************

// This function just provide the means to remove the details of 

// creating the HTML page. 

function makeHTMLPage()

{

	// Build the filename & path

	var sUserPath = Application.InstallationPath( siUserPath );

	var sHelpFileName = XSIUtils.BuildPath( sUserPath, "Data", "HelpMe.html" );

	// Create a standard hello world script file

	var fso = new ActiveXObject( "Scripting.FileSystemObject" );

	var fHWFile = fso.CreateTextFile( sHelpFileName );

	fHWFile.WriteLine( "<html>" );

	fHWFile.WriteLine( "<head>" );

	fHWFile.WriteLine( "\t<title>Help Page for Testing Add-ons</title>" );

	fHWFile.WriteLine( "</head>" );

	fHWFile.WriteLine( "<body>" );

	fHWFile.WriteLine( "\n<p>Help! I'm trapped inside this HTML code!</p>" );

	fHWFile.WriteLine( "</body>" );

	fHWFile.WriteLine( "</html>" );

	fHWFile.Close();

	// Return the name of the new html page

	return sHelpFileName;

}

関連項目

XSIApplication.UnInstallAddon XSIApplication.CreateAddon PackageAddon