Custom Toolbars

 
 
 

You can create your own toolbar and use it to hold commonly-used tools and presets. Tools and presets are represented as buttons on the toolbar.

Softimage also includes a couple of blank toolbars that are ready for you to customize by adding your own scripts, commands, and presets:

Creating and Editing Toolbars

To create a new toolbar

  • Choose View New Custom Toolbar from the main menu.

    A new empty toolbar is displayed.

To create a new toolbar in a specific location

  1. Open the Plug-in Manager (File Plug-in Manager).

  2. On the Tree tab, right-click a Toolbars folder and then choose New Toolbar.

    For example, to create a toolbar in an Add-on directory, right-click the Toolbars folder under the Add-on directory.

    To create a toolbar in a workgroup, right-click the Toolbars folder under the workgroup.

  3. In the Toolbar Name box, type a name for the toolbar.

  4. If you want to create an empty toolbar, clear the Populate with Commands from this location check box.

    By default, a new toolbar includes all the commands in the same location as the toolbar. For example, when you create a new toolbar in an Add-on directory, the toolbar contains all the commands defined by the add-on.

  5. The Output Directory is the Application\Toolbars folder in the location (workgroup or Add-on directory) you right-clicked in the Plug-in Tree.

  6. Click OK to create and display the new toolbar.

To name a custom toolbar

  • Right-click on an empty area of the toolbar and choose Rename, then enter a new name and click OK.

    The name of the toolbar appears on the View Toolbars menu as well as in the toolbar's title bar. Spaces are allowed.

To save a custom toolbar

  • Right-click on an empty area of the toolbar and choose Save or Save As.

    You are automatically prompted to save a toolbar when you close it if there are unsaved changes.

Adding Commands to Toolbars

You can add a command button to a toolbar by dragging and dropping from the Customize Toolbar window or the Plug-in Manager.

To add commands to a toolbar using the Customize Toolbar window

  1. Make sure the toolbar is displayed. For example, select if from the View Toolbars menu.

  2. Choose View Customize Toolbar, or right-click on an empty area of a custom toolbar and choose Customize Toolbar.

  3. In the Customize Toolbar dialog box, select an item from the Command Categories list. For example, if you are looking for a custom command, select Custom Script Commands to display only that type of command in the list.

  4. From the Available Commands list, select an item and drag it to the desired location on a toolbar.

To add commands to a toolbar using the Plug-in Manager

  1. Open the Plug-in Manager (File Plug-in Manager).

  2. Make sure the toolbar is displayed. For example, on the Tree tab of the Plug-in Manager, expand a Toolbars folder and double-click a toolbar (an .xsitb file).

  3. On the Tree tab of the Plug-in Manager, expand a Plug-ins folder, expand a plug-in, and then drag a custom command to the toolbar.

To customize a command button on a toolbar

  1. Right-click on a command button and choose Customize Button.

  2. Set the options as desired:

    • Set the Height and Width in pixels.

    • Specify a Label for the button text.

    • Specify a path for a Bitmap (.bmp file). See Adding Button Bitmaps.

  3. Click OK.

Adding Presets to Toolbars

You can add preset buttons to toolbars by dragging them from a browser. You can click the preset button to apply the preset to selected objects. You can also drag and drop the preset button to apply it to an unselected object.

Presets use their embedded thumbnails, if available. You can save a thumbnail of the render region when you save a preset (see Saving Presets [Scene Elements]), or you can attach a thumbnail to a preset using the setthumb standalone (see Creating and Extracting Thumbnail Images for Presets [Standalones]) If a preset does not have a thumbnail, a generic thumbnail is used.

To add a preset button to a toolbar

  • In a browser, locate the preset you wish to include and drag it to a toolbar.

To change the display of preset buttons

  • Right-click on an empty area of a toolbar and choose Text Only or Thumbnail Only.

To change the size of preset thumbnails

  • Right-click on an empty area of a toolbar and choose an item from the Thumbnail Size menu.

To add a preset list button to a toolbar

Preset lists display all presets that are found in a specific directory as a menu. Subdirectories are not included.

  1. Right-click on an empty area of a toolbar and choose Customize.

  2. Set Command Categories to Toolbar.

  3. Drag Preset List Button from Available Commands to the toolbar.

  4. Specify the folder containing the presets.

Organizing Toolbars with Toolbar Widgets

The toolbar widgets are a collection of buttons and separators that you can use on custom toolbars. The following illustration shows how the separators (group labels, horizontal space and line separators, and line breaks) can be used to arrange buttons on a toolbar.

A

Horizontal Space Separator

B

Line Break

C

Horizontal Line Separator

The toolbar widget buttons also allow you to pop-up menus, pop-up lists of presets, and run scripting code:

  • Menu buttons pop up a menu of commands. You can use the Menu Separator widget to group commands on the pop-up menu.

  • Preset list buttons pop up lists of presets in a specific location (for example, a list of light shader presets in a workgroup).

  • Script buttons embed scripting code directly in a toolbar, without creating a script command.

To organize toolbars

  1. Right-click on an empty area of a toolbar and choose Customize.

  2. Set Command Categories to Toolbar Widgets.

  3. Drag items to the desired location on the toolbar.

Rearranging Buttons

You can move toolbar widgets (such as menu buttons, line breaks, and horizontal separators) by dragging them on the toolbar. Just right-click the toolbar, choose Customize Toolbar, and then drag a toolbar widget to a different location on the toolbar.

Adding Script Buttons

Script buttons run scripting code that is saved in the toolbar .xsitb file. Use script buttons to run custom code from a toolbar without creating a command and saving the code to external file. For example, you can use script buttons to call a command with different argument values.

  1. Do one of the following:

    • In the toolbar window, right-click an empty area and choose Customize Toolbar. In the Group list, click Toolbar Widgets, and then drag Script Button from the Available Commands list to the toolbar.

      or

    • In a script editor (or an external text editor), select some scripting code. Drag the code to the toolbar. In the Script Button dialog box, click OK (Script Button should be selected by default). You can drag code from either the history pane or the editing pane of the script editor.

  2. In the Customize Button dialog box:

    • Script Commands is the scripting code you want to run when the button is clicked. Click Run to test the code.

    • Scripting Language is the scripting language used by the script button.

    • Bitmap is the name of a bitmap (.bmp) file displayed on the button. See Adding Button Bitmaps.

Adding Button Bitmaps

You can display bitmaps on script and command buttons on a toolbar.

The size of the bitmap determines the size of the button. Any white pixels (255, 255, 255) in the bitmap are replaced with the background color of the image.

Button bitmaps are displayed only when the toolbar is set to display Thumbnails Only. In the .xsitb file, this translates to:

<properties ... display_as_text_only="False"></properties>

To display a bitmap on a button

  1. Create a subfolder called bitmaps in the toolbars folder, and add the bitmap file (.bmp) to it.

    Tip To quickly access the file system from the Plug-in Tree, right-click a Toolbars folder and choose Browse.

  2. In Softimage, open the toolbar and right-click a script or command button and choose Customize Button.

  3. In the Bitmap box, type the name of the bitmap file without the path or extension. For example, if the bitmap file is "myimage.bmp", type "myimage".

Adding Menu Buttons

  1. In the toolbar window, right-click an empty area and choose Customize Toolbar.

  2. In the Group list, click Toolbar Widgets.

  3. Drag Menu Button from the Available Commands list to the toolbar.

  4. In the Name Popup Menu Button dialog box, type a label for the button.

    To change the button label, you'll have to edit the .xsitb file.

  5. Add commands, view shortcuts, and menu separators to the menu button.

    • To add a command, click a command group in the Group list of the Customize Toolbar dialog box. Then, in the Available Commands list, locate the command you want and drag it to the menu button.

    • To add a menu separator between menu items, click Toolbar Widget in the Group list and then drag Menu Separator to the menu button.

  6. Save your changes. In the toolbar window, right-click an empty area and choose Save.

Note
  • To reorder the items on a menu button, right-click the button and choose Customize Button. In the Customize Popup Menu button dialog box, click a menu item and then click Move Up or Move Down.

  • To add more commands to a menu button, open the Customize Toolbar dialog box again, and drag the commands to the menu button on the toolbar.

  • To add items to the default Softimage menus instead of your own, see Standard and Contextual Menus [SDK Guide].

Removing Items

  • Right-click on a toolbar button and choose Remove Button.

    If the button was for a custom command, the command and its associated script are still registered. To unregister a custom command, see Removing Custom Commands.

Editing .xsitb Files

Toolbars are saved in an XML file with an .xsitb extension. If you're comfortable editing XML files, you can customize toolbars using a text editor. For example, you may want to:

  • Change the label on a menu button (you cannot do this with Customize Button).

  • Change the widths and heights of multiple buttons. You can do this in the Customize Button dialog box, but for some people it may be quicker to edit the XML file.

  • Rearrange the buttons and group headers on a toolbar.

To edit the XML source for a toolbar

  1. In the Plug-in Tree, right-click a toolbar and choose Edit.

    Softimage opens the .xsitb file in a script editor.

  2. Edit the file and save it.