Setting the Pane Contents

 
 
 

A pane can host any one of the following:

Previewing Pane Contents

The Preview button in the editor's command bar controls the display of pane contents:

  • When it is on, the panes display an approximation of their content.

  • When it is off, each pane shows its name and the name of its content.

Some commands are not available when Preview is on.

Setting Views and Panels

Some views and panels are available only when editing layouts. In addition, some views and panels can be instanced only once per layout.

To set a view or panel for a pane

  • Right-click in a pane and choose an item from the Set View menu.

To remove a view or panel for a pane

  • Right-click in a pane and choose Remove View. The pane contents are removed but the pane remains.

    If you simply want to change the pane contents, you do not need to remove it first. Simply right-click and select another item from the Set View or Set Toolbar/Shelf menu.

Notes on Specific View Types

Most of the items in the Set View menu are self-explanatory. However, some of them require a little more explanation:

  • The View Manager is the main view in the center of the default layout that holds the four viewports. There can be only one per layout.

  • A Property Panel is similar to a property editor, but it does not include the animation and preset controls at the top. In addition, it does not react to selection changes so it does not recycle automatically as you work. It is useful for displaying property pages that are static or controlled programmatically by the SDK. To specify the property to display, see Setting View Properties.

  • The Text Editor always includes a Run button even if you do not intend to use it to edit scripts. If users click Run, Softimage tries to run the text — if it is not a valid script, the most likely result is syntax errors.

  • The Animation Editor requires a great deal of resources. You should avoid having more than one in a layout or view. The Render Tree and Schematic are also quite heavy.

  • You should not put the RV - Material Editor in a layout. It creates temporary objects in your scene and deletes these objects when the view closes. However since a layout doesn't close in the same way as a view, these objects would never be removed.

  • The contents of a Menu Window must be controlled programmatically.

Setting the Toolbar Type

Some views let you set the toolbar type. These views include most of the ones that have their own toolbar, such as the explorer, the schematic, and so on.

To set the toolbar type

  • Do one of the following:

    • Right-click in a pane and choose an option from the Toolbar submenu.

      or

    • Select a pane and set Toolbar Type in the editor's command bar. Note that this is not available in Preview mode.

    You can set any of the following options:

    • None hides the view's toolbar. For example if you don't want users to change settings, you can hide the toolbar of an Object view and either set the display type in its View properties or control it using the SDK.

    • Local displays the view's toolbar normally.

    • Shared displays the view's toolbar in a special area across the top of the relational view. This is supported only for explorer views. Setting it for other views may produce undesirable artifacts.

Setting View Properties

Some view types have properties that you can set. For example, you can control the target content of an Object view, set the default URL for a Netview, or specify a file to open in a text editor.

To set view properties

  • Right-click in a pane and choose Set View Properties.

    The View Properties editor opens. The options available depend on the type of view. Some types of view have additional properties that can be set using the SDK but are not listed in the View Properties editor. For a list of all available properties, see View Attributes[SDK Guide].

Setting Toolbars and Shelves

Panes can contain toolbars and shelves. You can select only toolbars and shelves that have been created previously: you cannot create and edit a shelf or toolbar within the layout or relational view editor. See Toolbars and Shelves.

To set a shelf or toolbar for a pane

  • Right-click in a pane and choose an item from the Set Toolbar/Shelf menu.

To remove a shelf or toolbar for a pane

  • Right-click in a pane and choose Remove View. The pane contents are removed but the pane remains.

    If you want to simply change the pane contents, you do not need to remove it first. Right-click and select another item from the Set View or Set Toolbar/Shelf menu.

Setting Tray Switchers

Panes can contain trays that allow users to switch between different panels by clicking buttons.

A

Pane area

B

Switcher area

C

Switcher buttons

To create a tray switcher

  • Right-click on a pane and choose New Tray Switcher.

    A tray is created with a single pane and button in the switcher area.

To delete a tray switcher

  • Right-click on a blank portion of the switcher area (that is, not on any button) and choose Delete Pane.

    A tray switcher will also be deleted if you delete the last pane in it.

Managing Panes Inside a Tray Switcher

You can add and remove panes inside a tray switcher. In addition, you can split them and set their contents in the same way as usual — just click the corresponding button to display the desired pane or frameset first.

To add a pane to a switcher

  • Right-click on the switcher area (above or next to a button) and choose Add Pane.

To remove a pane from a switcher

  • Right-click on the pane's button and choose Delete Pane.

To select a pane inside a switcher

  1. Make sure the correct pane is displayed by clicking the corresponding switcher button.

  2. Click in the pane area.

Controlling Switcher Button Display

You can set the location and size of the switcher buttons. Each button can display either a text label or a bitmap.

  • Text labels always show the name of the associated pane or frameset.

  • Bitmaps must be in BMP format. They get stretched or compressed to the size of the buttons. You must import bitmaps before you can assign them to buttons.

    If you supply a bitmap named filename_highlight.bmp in addition to filename.bmp, then the highlight version is displayed when the button is selected.

To set the button location and size

  1. Select a tray switcher by clicking anywhere in the switcher area (on or next to a button).

  2. On the editor's command bar, set Button: Location to the desired value: Top, Bottom, Left, or Right.

  3. Set W and H to the desired width and height of the buttons in pixels.

To change the button label

To change the text label on a button, you must change the name of the associated pane or frameset as follows:

  1. Make sure the correct pane is displayed by clicking the corresponding switcher button.

  2. Click in the pane area to select it. If the pane has been split, you need to Ctrl+click to select the parent frameset.

  3. In the editor's command bar, enter a new name in Pane Name or Frameset Name.

To import bitmaps for buttons

  1. Right-click in the switcher area and choose Bitmap Editor. The Bitmap Editor opens.

  2. Do one or both of the following:

    • Click Load All Default Bitmaps. All bitmaps found in the Application\layouts\bitmaps directory of the user and factory locations are added to the list.

    • Click Import New Bitmap and use the browser to select a .bmp file to import. The file (as well as the highlight version, if any) is automatically copied to the Application\layouts\bitmaps directory of the user location. Repeat to import additional bitmaps.

  3. Click OK. The bitmaps are now available on the Set Bitmap menu.

To set a bitmap for the button

  • Right-click on a button and choose an item from the Set Bitmap menu.

    If the bitmap file cannot be found when a user displays the layout or view, the button reverts to the name of the associated pane.

To create tooltips for bitmap buttons

  1. Click in the pane area to select it. If the pane has been split, you need to Ctrl+click to select the parent frameset.

  2. In the editor's command bar, enter a Description.

    The description is displayed when users hover the mouse pointer over a bitmap button.

To remove bitmaps from buttons

  • Right-click on a button and choose Remove Bitmap. The button reverts to the name of the associated pane.