Tutorials/ROBOTC Interface
| Line 110: | Line 110: | ||
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.<br /><br /> | 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.<br /><br /> | ||
[[File:execution-stopped.png]] | [[File:execution-stopped.png]] | ||
| + | |} | ||
| + | <br /> | ||
| + | |||
| + | == Status Bar == | ||
| + | {|width="740px" | ||
| + | |- | ||
| + | |The Status Bar gives you information about the ROBOTC editor and the current program.<br /> | ||
| + | |||
| + | [[File:status-bar.png]]<br /><br /> | ||
| + | |||
| + | #Context Help - Hover over different sections of the ROBOTC interface for brief descriptions. | ||
| + | #Active Project - Displays the most recently compiled program. | ||
| + | #Read-only Status - Displays the file permissions for the most recently compiled program. | ||
| + | ##R/W - Read and Write Access | ||
| + | ##R/O - Read Only Access | ||
| + | #Compiler Errors - Displays the number of Warnings and Errors in a program, if any. | ||
| + | #Line/Column Display - Shows the line number and character of where the text cursor is currently located. | ||
|} | |} | ||
<br /> | <br /> | ||
Revision as of 13:22, 14 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. |
Status Bar
| The Status Bar gives you information about the ROBOTC editor and the current program.
|
