Loading a script file
 
 
 

You can read and edit script files other people have created in the Script Editor. In this section, you open a script that contains a completed user interface for the makeRoll procedure. However, the user interface is only a layout, and does not contain any functionality.

To prepare to open the script

  1. In the Script Editor, ensure that Command > Show Line Numbers is checked.

    When Show Line Numbers is on, line numbers appear beside the commands in the Script Editor. The lesson occasionally refers to line numbers to tell you where to make a modification to the script. When line numbers are referred to in the lesson, they are always the line numbers of the original script.

  2. Create a new tab in the Script Editor by selecting Command > New Tab.

    A pop-up window asks you in which language should the commands entered in this tab execute in.

  3. Click the MEL button on the pop-up window.

    You created a second MEL tab in the Script Editor.

  4. Select Command > Rename Tab.
  5. Enter MEL2.

    The tab is renamed.

In the next steps, you load a user interface script into both MEL tabs. The MEL tab will contain the original script, and the MEL2 tab will contain the user interface script with your modifications. This way, line numbers can be referenced from the original script to inform you where to make a modification.

To open a script file in the Script Editor

  1. Select the MEL tab.
  2. In the Script Editor, select File > Load Script.
  3. Select the MEL script named mel_Lesson_4_start.mel.

    This file can be found in the GettingStarted directory that you set as your Maya project, within the mel sub-directory.

    The contents of the MEL file are displayed in the Script Editor.

  4. Load the same MEL script into the MEL2 tab by repeating the above procedure.
  5. In the MEL tab, highlight the script by selecting Edit > Select All from the Script Editor menu bar.
  6. Execute the script by pressing Ctrl+Enter.

    A user interface is created for the makeRoll procedure. There is a control in the user interface for each argument of the makeRoll procedure.

    (You can leave this window open as we’ll be doing some testing with it, though it doesn’t do anything yet.)

Discussion: what the script does

  1. The controls in the user interface are created by various commands. Below,

the script has been broken up into sections to describe the various user interface controls and their flags. The user interface controls and commands that you used earlier in the lesson are described only briefly below.

Conditional statement

if(`window -exists makeRoll_Window`) 
{ 
   deleteUI makeRoll_Window; 
}

The conditional statement checks if a window with the specified name exists. If the window exists, it deletes it.

Window command

window -resizeToFitChildren 1 makeRoll_Window;

The window command creates a user interface window to contain the controls. For more information, see Creating a window.

Column layout

columnLayout;

The columnLayout command creates a layout that arranges the controls within it in a column. For more information, see Referencing controls.

Text field commands

string $obj_name_text = 	
   `textField 
   -editable 0 	
   -width 400 	
   -text "name_Of_Object"`;

The command textField creates an editable text field. The text field command has multiple flags. The name and path of the text field are stored as a variable. See Storing control names.

  • The editable flag enables or disables editing of the text field.
  • The width flag sets the width of the control.
  • The text flag sets the contents of the text field.

Slider commands

string $ground_int= 	`intSliderGrp 	
   -minValue -20 	
   -maxValue 20 	
   -fieldMinValue -20 	
   -fieldMaxValue 20 	
   -field 1 	
   -label "Ground Plane"`; 
string $diameter_float= 	`floatSliderGrp 	
   -value 1.0 	
   -minValue 1.0 	
   -fieldMinValue 1.0 	
   -field 1 	
   -label "Diameter"`;

The commands intSliderGrp and floatSliderGrp create sliders. Commands ending in Grp create a group of linked controls. The slider commands create controls for a label, a value box and a slider. The slider command has multiple flags. The name and path of the slider are stored as a variable. See Storing control names.

  • The editable flag can be used to enable or disable editing of the text field.
  • The minValue and maxValue flags set the minimum and maximum values for the slider.
  • The field flag enables the visibility of an editable value field beside the slider. By default, the field is not visible.
  • The fieldMaxValue and fieldMinValue flags set the minimum and maximum values for the field beside the slider.
  • The label flag sets the text that appears to the left of the slider.

Separator commands

separator -height 20 -width 120;

The command separator creates a horizontal line. It is used to space the controls vertically in the window. The separator command has multiple flags.

  • The width flag sets the visible width of the separator.
  • The height flag sets the amount of vertical spacing created by the separator.

Check box commands

string $box_sim_checkbox = 	`checkBox 	-value 1 	-label "Box Simulation"`; 
string $sphere_sim_checkbox = 	`checkBox 	-value 0 	-label "Sphere Simulation"`; 
separator -height 20 -width 120; 
button 
   -label "Execute!" 	
   -command "print (\"something\");";

The command checkBox creates a check box. The check box command has multiple flags. The name and path of the check box are stored as a variable. See Storing control names.

  • The value flag sets the initial value of the check box.

ShowWindow command

showWindow;

This command enables the last created window’s visibility. For more information, see Creating a window.

NoteIn the script above, you do not explicitly declare your variables. This is because the return type of user interface creation commands is known to be a string, and cannot be any other data type. Later in the lesson, you will allow a data type to be implied, as you do not know what data type the return will be.