Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]

Run Menu


Run Menu items are enabled when an IDL program is loaded into an IDL Editor window and compiled. If you click the right mouse button while positioned over an editor window, a popup menu appears allowing you to quickly access several of the most convenient commands. The popup menu changes to display common debugging commands if IDL is running a program. See Debugging an IDL Program for more information.

Compile filename.pro [Ctrl+F5]

Select this option to compile a .pro file. The currently-selected file is only recognized as an IDL procedure or function if suffixed with .pro. Selecting this option is the same as entering .COMPILE at the Command Input Line, with the appropriate Editor window selected in the Multiple Document Panel.

You can also compile files from the Command Input Line. Enter the following at the IDL prompt:

.COMPILE file1 [file2 ... filen] 

where file is the name of the file you want to open. IDL opens your files in editor windows and compiles the procedures and functions contained therein. If the path is not specified in the Path Preferences from the File menu, you must enter the full path for file.

See .COMPILE for a more detailed explanation.

Compile filename.pro from Memory [Ctrl+F6]

Select this option to save and compile changes to the current editor window without affecting the last-saved version of the file. The temporary file created allows you to experiment without committing changes to the permanent file. Selecting this option is the same as entering .COMPILE -f at the Command Input Line. See .COMPILE for a more detailed explanation.

Compile All

Select this option to compile all currently open *.pro files.

Run filename [F5]

Select this option to execute the file called filename contained in the currently-active editor window. Selecting this option is the same as entering the procedure name at the Command Input Line or using the .GO executive command at the Command Input Line. If the file is interrupted while running, selecting this option resumes execution; it is the same as entering .CONTINUE at the Command Input Line. For more information, see .CONTINUE and .GO.

Warning
In order for the Run option to reflect the correct procedure name in the Run menu, the .pro filename must be the same as the main procedure name. For example, the file named squish.pro must include:
   pro squish

Resolve Dependencies [Alt+F5 (Motif)]

Select this option to iteratively compile all un-compiled IDL routines that are referenced in any open and compiled files. Selecting this option is the same as entering RESOLVE_ALL, /QUIET at the Command Input Line. The QUIET keyword suppresses informational messages. See RESOLVE_ALL for a more detailed explanation.

Profile

Select this option to access the Profile dialog. The IDL Code Profiler allows you to analyze the performance of your applications. You can identify which modules are used most frequently, and which modules take up the greatest amount of time.For more information about the IDL Code Profiler, see The IDL Code Profiler.

Test GUI [Ctrl+T (Microsoft Windows Only)]

Select this option to test the GUI interface in a GUIBuilder window. This option allows you to see how the interface you have designed will look when it is running.

To exit test mode:

Press the Esc key.

or

Click the X in the upper-right corner of the application window of the running test application.

Note
This option is not available if a blocking widget is currently active.

Break [Ctrl+Break (Windows), Ctrl+C (Motif)]

Select this option to interrupt program execution. IDL inserts a marker to the left of the line at which program execution was interrupted.

Stop [Ctrl+R]

Select this option to stop program execution and return to the main program level. Selecting this item is the same as entering the following at the Command Input Line:

RETALL 
WIDGET_CONTROL,/RESET 
CLOSE, /ALL 
HEAP_GC, /VERBOSE 

See RETALL, WIDGET_CONTROL, CLOSE, or HEAP_GC for more detailed explanations.

Reset

Select this option to completely reset the IDL environment. This option executes .RESET_SESSION. See .RESET_SESSIONfor more information.

Step Into [F8]

Select this option to execute a single statement in the current program. The current-line indicator advances one statement. If the statement being stepped into calls another IDL procedure or function, statements from that procedure or function are executed in order by successive Step commands. Selecting this item is the same as entering .STEP at the IDL Command Input Line. See .STEP for a more detailed explanation.

Step Over [F10]

Select this option to execute a single statement in the current program. The current-line indicator advances one statement. If the statement which is stepped over calls another IDL procedure or function, statements from that procedure or function are executed to the end without interactive capability. Selecting this item is the same as entering .STEPOVER at the IDL Command Input Line. See .STEPOVER for a more detailed explanation.

Step Out [Ctrl+F8]

Select this option to continue processing until the current program returns. Selecting this item is the same as entering .OUT at the IDL Command Input Line. See .OUT for a more detailed explanation.

Trace...

Select this option to access the Trace Execution dialog. You can modify the interval between successive .STEP or .STEPOVER commands, depending on whether Step into routines or Step over routines is checked. The current-line indicator points to program lines as they are executed. Selecting this item at full speed is the same as entering .TRACE at the IDL command prompt. See .TRACE for a more detailed explanation.

Run to Cursor [F7]

Select this option to execute statements in the current program up to the line where the cursor is positioned. Selecting this item is the same as setting a one-time breakpoint at a specific line. See BREAKPOINT for a more detailed explanation.

Run to Return [Ctrl+F7]

Select this option to execute statements in the current procedure or function up to the line where the return is positioned. Selecting this item is the same as setting a one-time breakpoint at a specific line. See .RETURN for a more detailed explanation.

Set Breakpoint [F9]

Select this option to set a breakpoint on the current line.

See Debugging an IDL Program for a more detailed explanation.

Disable Breakpoint [Ctrl+F12 (Motif)]

Select this option to access disable a breakpoint in the current line.

See Debugging an IDL Program for a more detailed explanation.

Edit Breakpoint...

Select this option to access the Edit Breakpoint dialog.

See Debugging an IDL Program for a more detailed explanation.

Up Stack [Ctrl+Up]

Select this option to move up the call stack by one.

Down Stack [Ctrl+Down]

Select this option to move down the call stack by one.

List Call Stack

Select this option to display the current nesting of procedures and functions. Selecting this item is the same as entering HELP, /TRACEBACK at the IDL Command Input Line. See HELP for a more detailed explanation.


Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]