Tutorials/ROBOTC Interface
(→Status Bar) |
|||
| Line 96: | Line 96: | ||
'''To add a breakpoint:'''<br /> | '''To add a breakpoint:'''<br /> | ||
Right-click on the line number where you wish to add a break point and a context menu will appear. Select "Insert Breakpoint" to place a breakpoint at that line.<br /><br /> | Right-click on the line number where you wish to add a break point and a context menu will appear. Select "Insert Breakpoint" to place a breakpoint at that line.<br /><br /> | ||
| − | [[File:insert-breakpoint.png]]<br /> | + | [[File:insert-breakpoint.png]]<br /> |
| Line 113: | Line 113: | ||
<br /> | <br /> | ||
| − | == | + | === Bookmarks === |
{|width="740px" | {|width="740px" | ||
|- | |- | ||
| − | | | + | |Bookmarks are useful for navigating larger ROBOTC programs. You can use bookmarks to jump from one line of code to the next. |
| − | |||
| − | + | '''To Add/Remove a Bookmark: (Ctrl-F2)'''<br /> | |
| − | + | Right click on the line number that you wish to add or remove a bookmark and a context menu will appear. Select "Toggle Bookmark" to place or remove a bookmark at that line. Pressing Ctrl-F2 on your keyboard will also add or remove a bookmark on the line with the cursor.<br /><br /> | |
| − | + | [[File:bookmarks-1.png]]<br /> | |
| − | + | ||
| − | + | ||
| − | + | '''To Use Bookmarks: (F2) & (Shift + F2)'''<br /> | |
| − | + | You can jump to the next line of code that has a bookmark by pressing the (F2) key on your keyboard, or by going to the "Edit" menu and selecting "Find Next Bookmark." You can also go to a previous bookmark by pressing (Shift + F2) , or going to the "Edit" menu and selecting "Find Prev Bookmark."<br /> | |
| − | + | {| | |
| − | + | |- | |
| + | |[[File:bookmarks-next.png]] | ||
| + | |[[File:bookmarks-prev.png]] | ||
| + | |}<br /> | ||
| + | |||
| + | |||
| + | '''Clear all bookmarks: (Ctrl + Shift + F2)'''<br /> | ||
| + | You can clear all bookmarks by going to the "Edit" menu and clicking "Clear All Bookmarks". You can also use the keyboard shortcut (Ctrl + Shift + F2) to clear all bookmarks as well.<br /><br /> | ||
| + | [[File:bookmarks-clear.png]]<br /> | ||
| + | |||
| + | |||
| + | '''Bookmarks Toolbar:'''<br /> | ||
| + | If you have the Bookmarks toolbar enabled, you can use it to toggle, switch between, and clear bookmarks as well. To enable the Bookmarks toolbar, right-click on your toolbar and select "Bookmark".<br /><br /> | ||
| + | [[File:bookmarks-bar.png]] | ||
|} | |} | ||
<br /> | <br /> | ||
Revision as of 11:21, 15 May 2012
Contents |
Overview
| ROBOTC for Mindstorms is an Integrated Development Environment. It has been developed to provide as much support as possible for the platforms it is compatible with. The ROBOTC interface will modify itself to accommodate the functionality found in your controller. ROBOTC extends the ‘C’ programming language with a number of built-in variables and functions to provide control over a robot’s hardware devices, i.e. the motors and sensors.
|
Editor
| This is the part of the interface where the user can write code.
|
Code Templates / Function Library
| This portion of the interface allows user to see all the functions available in ROBOTC at their user level. Portions of code from the "Function Library" can be dragged into the Editor.
|
Main Menu / Toolbar
| This area allows you to perform basic tasks (saving, copy & pasting, undo, etc.), switch between multiple open programs using the tabbed interface, and access all of ROBOTC's additional functionality through the various menus.
|
Code Editor
Writing Code
| Writing Code is the primary focus of ROBOTC, being a C-Based development environment. The ROBOTC Code Editor provides some visual assistance while programming with the use of line numbers and color coding:
Normal Text is displayed as black text. Normal text is used for variable and function names that are user-defined and not recognized by the compiler as reserved words. Comments are displayed as green text . Comment are any bits of text in a program prefaced with a "//" or a "/*". This "commented text" is not considered code and is ignored when the compiler is generating byte-code to send to the robot controller. Reserved Words/Pre-Defined Functions (int, motor) are displayed as bold blue text and italicized blue text. Constants and Parameters (127, port1) are displayed as red text. Syntax and Operands (+, -, *, {, <, [, etc.) are displayed as light red text. |
Error Display
| At compilation time, the ROBOTC compiler analyzes your code to identify syntax errors, capitalization and spelling mistakes, and code inefficiency, such as unused variables and redundant code. The ROBOTC compiler also has a powerful code optimizer that can shrink your program size by up to 50% before sending it to the robot to preserve memory space on your controller.
The Error display screen reports the number of errors in your code, as well as their types. Double-clicking a compiler message in the Error display screen will highlight the relevant line of code in your program. The "Previous", "Select", and "Next" buttons can also be used to cycle through and select the errors in your program. Depending on the type of error, ROBOTC will only be able to highlight the approximate location of the error. For instance, in the example below the missing semicolon is on line 6, but ROBOTC will highlight line 7. ROBOTC generates three types of compiler messages: Errors, Warnings and Information Statements. Errors: Warnings: Information: |
Breakpoints
| Breakpoints are a useful debugging tool in ROBOTC. Breakpoints can be placed on any line of code and tell the controller to stop executing the program when that line is reached. When a breakpoint is reached, the ROBOTC debugger informs the programmer, who can then check the status of the robot, code editor, and debugger windows at that point. ROBOTC supports multiple break points.
Breakpoints are denoted by a red circle in the gray area between the code and the line numbers. To add a breakpoint:
This message is just an indication that the breakpoint has been reached. Click OK and then look at your program in the code editor. ROBOTC will highlight the line of the breakpoint that program stopped at, allowing you to see exactly which breakpoint the program executed. |
Bookmarks
| Bookmarks are useful for navigating larger ROBOTC programs. You can use bookmarks to jump from one line of code to the next.
|
