Your Ad Here

Modifying Custom Commands

Once you have created a custom command, you can modify it in the following ways:

• Edit the command definition, for example, to change the default values for arguments.

• Edit the script that implements the command to change its behavior.

• Remove the command.

You can modify only the custom commands stored in your user location. You cannot modify commands stored in the workgroup or factory locations. In addition, you cannot modify self-installing custom commands or commands contained in add-ons.

Editing Command Definitions

Editing the command definition changes a command’s properties, such as its description, tooltip, or the default values for arguments. Note that you cannot use this method to modify the properties of self-installing commands — you must modify the associated script instead.

To edit a commands definition

1. Open the Command Editor by doing one of the following:

- Right-click on a button in a toolbar and choose Edit Command.

or

- On the Tree tab of the Plug-in Manager, right-click on the command and choose Properties.

2. In the Command Editor, modify the options as desired. For a description of the available options, see Command Editor.

Editing Script Implementations

To edit the script that implements a command

1. Open the script file in any text editor.

- If there is a button for the command on a toolbar, you can do this by right-clicking on the button and choosing Edit Script.

- Alternatively, you can locate the command on the Plug-ins or Items tabs of the Plug-in Manager, then right-click on it and choose Edit.

2. Make any desired changes and save the script file.

The modified script is run the next time that the command is called.

 

If you changed the definition of a function by adding or removing arguments, you should edit the command definition to reflect the changes. Alternatively, you can remove the command and create it again.

Removing Custom Commands

Self-installing and non-self-installing commands are removed in different ways:

• When you remove a non-self-installing command, it is “deregistered”. It is no longer available for use on buttons or inside scripts, and existing scripts that make use of it will fail. The script or library file that implements the command is not deleted from the file system.

After you have removed a custom command, buttons that called it will display “Command Unavailable”. You can remove these buttons as described in Organizing Toolbars with Toolbar Widgets.

• When you remove a self-installing command, the file is removed from disk.

To remove a command directly from a toolbar

• Right-click on the button and choose Remove Command.

Both the command and the button are removed.

To remove a command using the Customize Toolbar dialog box

You can use the Customize Toolbar dialog box to remove a command whether or not the command has an associated button.

1. Display the Customize Toolbar dialog box by doing one of the following:

- Right-click on an empty portion of any custom toolbar and choose Customize.

or

- Choose View > Custom Toolbar > Customize from the main menu.

2. Under Command Categories, select Custom.

3. Under Available Commands, select the command you want to remove.

4. Click Remove Command.

 



SOFTIMAGE|XSI v.6.01     

Return to Softimage XSI Index


Your Ad Here