Interacting with the User

 
 
 

There are many types of interaction that you may need to implement in your tool or customization. For example, you may want to simply give the user some information about the status of the action (typically using a message box dialog or a progress bar). Conversely, you may need the user to supply some information, such as the name of a file to use as input or output (typically using a browser dialog).

These types of services can be handled either by tools provided by the implementation language (for example, the MsgBox function in VBScript) or by some of the UI toolkits Softimage provides (for example, the XSIUIToolkit.MsgBox or UIToolkit::MsgBox and XSIUIToolkit.ProgressBar or UIToolkit::GetProgressBar features). However, you may need a tool that's more flexible and able to handle complex solutions.

Custom Dialog Tools

Often you need something more comprehensive; something highly malleable but quick and easy to use. For example, you may need to ask the user to set some parameters that have very different data types: integers, doubles, colors, strings, etc. Or you may want to trigger some fancy-schmancy action behind the scenes when the user clicks a button or indicates an option. These types of services are best handled by a custom dialog box called a property page (or PPG) which provides you with a large range of tools that are easy to configure and implement.

Here are the types of actions you can take using the Softimage UI-building tools:

Action

Tool Name

Description

For details, see...

Ask users to provide the name and location of the file to save.

PPG

  • PPG using a PPGLayout with the FileBrowser widget

File Browser Widget

FileBrowser

  • XSIUIToolkit.FileBrowser with the ShowSave method

FileBrowser

Ask users to provide the name and location of the file to open.

FileBrowser

  • PPG using a PPGLayout with the FileBrowser widget

File Browser Widget

FileBrowser

  • XSIUIToolkit.FileBrowser with the ShowOpen method

FileBrowser

Inform users how long to wait for the process to finish and how long they've been waiting.

ProgressBar

  • XSIUIToolkit.ProgressBar

    Note

    You could also use a PPG to simulate this behavior, but why reinvent the wheel?

ProgressBar

Send information or messages to users without feedback.

MsgBox

  • XSIUIToolkit.MsgBox

    Note

    You could also use a PPG, but MsgBox is simpler to implement for single messages.

MsgBox

Ask users to click OK, No, Cancel, Abort, Retry or Ignore in response to a question or statement.

MsgBox

  • XSIUIToolkit.MsgBox

    Note

    You could also use a PPG, but MsgBox is simpler to implement for single messages.

MsgBox

Ask users to set data on parameters, select an item from a drop-down or list box or choose one option from a set.

Note

A rich toolset is available in Softimage to easily specify very complex or specific types of controls, such as an FCurve, a Color Selector, a Folder Picker, etc.

PPG/CustomProperty

  • Parameter data can be saved in a CustomProperty (parameter set) object. It can then be persisted in the scene even after the dialog box is no longer visible.

  • The PPG provides the mechanism for viewing the CustomProperty data, as well as providing extra functionality, such as command buttons, file- and folder-pickers, etc.

  • You set up the format and layout of the PPG using the PPGLayout object.

Building Dialogs

Allow users to perform one or more actions in relation to the data displayed by clicking a button.

Note

If you are providing only command buttons (without data) on your property page, you may want to consider simply creating a custom toolbar to host your command buttons instead. For more information, see CreateToolbar.

PPG

  • PPG using a PPGLayout with the CommandButton type of control (siControlButton).

Command Button

Display a complex set of data, such as a 2-dimensional array.

PPG/GridData

  • GridData can hold 2-dimensional sets of data, which provides an excellent workaround to the problem of how to work with 2-dimensional arrays in JScript.

  • PPG using a PPGLayout with the GridData type of control (siControlGrid).

GridData Widget

Use a multi-page layout with tab control to display extensive data.

PPG

Using Multiple Pages (Tabs)

Display your company's logo on your custom dialog box.

PPG

Bitmap Widget

Set up a Scintilla-based text editor to utilize C++ style formatting, auto-complete, folding, etc. inside Softimage

PPG

Text Editor Widget

Note

Only tools available in Softimage are presented in this chapter; for standard tools deployed by your specific implementation language, see your language supplier's documentation.