Functional Dialogs  
Top  Previous  Next


Most of image processing functions in ImageWarp utilize functional dialogs with which you can specify options and parameters for a selected function. A typical example of a functional dialog is the Filters dialog accessible through the Processing menu. The functional dialogs are non-modal, which means that you can continue working with other ImageWarp's interface elements while the dialogs are displayed. You can also open several instances of the same dialog and use them independently.

Each functional dialog features a number of functions accessible via the Function list. These functions are logically grouped in tabs. When you select a desired function, the options in the dialog change to display the parameters of this function. A variety of standard Windows user interface techniques are utilized to let you control the options -- list boxes, group boxes, buttons, edit boxes, sliders, spins and so forth. The bottom pane of the dialog displays the script command corresponding to the selected function with the chosen parameters. When you change the options of the function in the dialog, the parameters of the script command will change accordingly.

Most of ImageWarp's processing functions have the Input and Output options as their first parameters. The Input field lets you enter the frame number of the image to which you want to apply the operation. When you open the dialog or select a new function, this option will be set to the number of the active image frame. Certain functions that need to receive more than one image at their input may have several Input fields. By default they will be filled with the numbers corresponding to the Z-order of the image frames in the workspace starting from the active one. The Output filed lets you enter the number of the frame in which the resulting image will be created. The default value of it depends on the Output to the same frame option in the Preferences
If this option is selected, ImageWarp will set it to the active image frame number, offering you to output the result to the same frame the Input image is located in. If the option is unselected, the value of the Output filed will be set to the first frame number not yet opened in the workspace, offering you to create the resulting image in a new frame. Certain functions may render several images at their output, in which case the Output fields will be filed with the numbers of new frames in the order of availability.

Another common element of all the functional dialogs is the Preview. It is a miniature-size output image representation that allows you to watch the effect of the selected function before it is applied to the input image or selection. In most cases (when an image or selection is larger than 160x120 pixels), you can pan the Preview image by pressing the left mouse button and moving the cursor around. If you change the selection area in the input image while one or more functional dialogs are open, Preview will change accordingly on all the dialogs: If the input frame is dynamically changing via the script or if it is an animated sequence, the Preview will also change in real time, still allowing you to pan it over the output image. The Preview can be turned off by unselecting the corresponding check box. You might want to do it for time-consuming functions, if you have a slower computer.

The bottom part of each functional dialog contains four buttons: Apply, Record, Close, and Help. The Apply button executes the selected function and renders the result to the Output frame. If the Script Editor
is in the Record mode, the corresponding command will be automatically inserted in the current script. All the parameters you selected except for the Input and Output will be memorized and set by default the next time you select the same function. The Record button enters the corresponding command into the script without executing the function or memorizing its parameters. The Cancel button abandons any changes you have made and closes the dialog box. The Help button will display a context help for the currently selected function.