Specifying a Help File for a Plug-in

You can specify a html page as the help file for a plug-in.

You can access the help for a plug-in in the following ways:

• In the Plug-in Tree, right-click the plug-in and choose Help.

• If the plug-in includes a self-installing property, click the ? icon in the title bar.

By default, Softimage looks for a help file in a Doc subfolder inside the plug-in installation folder. The help file must have the same name as the plug-in. For example, consider that the plug-in MyPlugin.js is located in the following folder:

C:\users\xyz\Autodesk\Softimage_<version>\Application\Plugins\MyPlugin

In this example, the help file must be named MyPlugin.html or MyPlugin.htm and it must be saved in the MyPlugin\Doc subfolder.

If a plug-in help file has a different name or location, you can use SIObject.Help, PluginRegistrar::PutHelp(), or PluginItem::PutHelp() to specify the help file. For example:

// JScript
function XSILoadPlugin(in_reg)
{
	in_reg.Author = "xyz";
	in_reg.Name = "MyPlugin";
	
	// Help file is in the same folder as the plug-in
	var sChm = "MyPluginHelp.chm";
	in_reg.Help = XSIUtils.BuildPath(in_reg.OriginPath, "MyPlugin.htm");
	
	var oPluginItem = in_reg.RegisterProperty("MyProperty");
	
	// Open a specific help topic for the property
	oPluginItem.Help = XSIUtils.BuildPath(in_reg.OriginPath, "MyProperty.htm");
	
	//RegistrationInsertionPoint - do not remove this line
	
	return true;
}