Difference between revisions of "Robocode/Robot Console"

From Robowiki
Jump to navigation Jump to search
(Created)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{stub}}
+
This page will explain how to use the Robot Console for your robot.
 +
 
 +
== The Robot Console ==
 +
The '''Robot Console''' is a window that first and foremost contains information dedicated to an individual robot. The information is printed out by the robot itself or from the [[Robocode]] game. Information is printed out by the robot using e.g. <code>System.out.print()</code>, <code>System.err.println()</code>, <code>out.println()</code>, and similar.
 +
 
 +
But information can also be printed out from the game about events that involves the robot. Such information will be prefixed with "System:", so you know that the information comes from the game itself. NOTE: If exceptions occur in a robot that is not catched/handled inside the robot, the game will catch the exception of the robot and dump the stack trace of the exception to the console. This is done to notify the developer of the robot that something went wrong inside the robot, but also where in robot it went wrong (can be seen using the stack trace).
 +
 
 +
Thus, if your robot does not behave as you expect, it might be a ''very'' good idea to open the console window for your robot and see if the robot is causing an exception, is skipping turns, or something else.
 +
 
 +
== How to open the Console Window ==
 +
So, when you want to read the output for your robot, you just have to open the console window of your robot. NOTE: In order to be able to open a console window of a robot, the robot must first be [[Robocode/Getting Started|added to the current battle]] as participant.
 +
 
 +
The console window of a robot is opened by clicking on the button on the right side of the battle view, which contains the name of the robot you want to open the console window for:
 +
 
 +
[[Image:RobotConsoleButtons.png|Shows the Robot Console buttons on the right side of the battle view, where the mouse pointer is pointing at the console button for the sample robot named Corner]]
 +
 
 +
 
 +
== Usage of the Console Window ==
 +
 
 +
When you have clicked on the button for the robot, the following console window will pop up:
  
This page will explain how to use the Robot Console for your robot.
+
[[Image:RobotConsole.png|Shows the Robot Console window for the sample robot named Corner]]
 +
 
 +
 
 +
As you can see on the image above, the Robot Console window contains some buttons, which are described here:
 +
 
 +
{| style="text-align:left"
 +
! OK
 +
| Closes the window
 +
|-
 +
! Clear
 +
| Clears all the text printed in the console
 +
|-
 +
! Kill Robot
 +
| Kills the robot
 +
|-
 +
! Paint
 +
| Enables/disables painting the robot (using the <code>onPaint</code> method)
 +
|-
 +
! Robocode SG
 +
| Enables/disables compability mode with a robot coded for [[RobocodeSG|Robocode SG]]
 +
|-
 +
! Pause/Debug
 +
| Pauses/resumes the game. The pause mode can be used when debugging
 +
|}
 +
 
 +
== See also ==
 +
 
 +
=== Robot API ===
 +
* [http://robocode.sourceforge.net/docs/robocode/ Robot API]
 +
 
 +
=== Tutorials ===
 +
* [[Robocode/System Requirements|System Requirements for Robocode]]
 +
* [[Robocode/Download|How to download and install Robocode]]
 +
* [[Robocode/Robot Anatomy|The anatomy of a robot]]
 +
* [[Robocode/Getting Started|Getting started with Robocode]]
 +
* [[Robocode/My First Robot|My First Robot Tutorial]]
 +
* [[Robocode/Game Physics|Robocode Game Physics]]
 +
* [[Robocode/Scoring|Scoring in Robocode]]
 +
* [[Robocode/Downloading_Robots|Downloading other robots]]
 +
* [[Robocode/Learning from Robots|Learning from other robots]]
 +
* [[Robocode/Package Robot|Package your robot]]
 +
* [[Robocode/FAQ|Frequently Asked Questions (FAQ)]]
 +
* [[Robocode/Articles|Articles about Robocode]]
 +
* [[Robocode/Console Usage|Starting Robocode from the command line]]
 +
* [[Robocode/Graphical_Debugging|Graphical debugging]]
 +
* [[Robocode/Eclipse|Using Eclipse as IDE]]
 +
* [[Robocode/Eclipse/Create_a_Project|Creating a project for your robots]]
 +
* [[Robocode/Eclipse/Create_a_Robot|Creating a robot in Eclipse]]
 +
* [[Robocode/Running from Eclipse|Running your robot from Eclipse]]
 +
* [[Robocode/Eclipse/Debugging Robot|Debugging your robot with Eclipse]]
 +
 
 +
=== News and Releases ===
 +
* [http://sourceforge.net/export/rss2_project.php?group_id=37202 RSS Feeds for the Robocode project]
 +
* [http://sourceforge.net/project/showfiles.php?group_id=37202&package_id=29609 Robocode file releases]
  
This page will be written by [[User:FlemmingLarsen]]
+
=== Home pages ===
 +
* [http://robocode.sourceforge.net/ Classic homepage]
 +
* [http://sourceforge.net/projects/robocode Robocode project at SourceForge]
 +
* [http://robocoderepository.com/ Robocode Repository]
 +
* [[wikipedia:Robocode|Wikipediaentry for Robocode]]
  
 
[[Category:Robocode Documentation]]
 
[[Category:Robocode Documentation]]
 +
[[Category:Tutorials]]
 
[[Category:Debugging]]
 
[[Category:Debugging]]

Revision as of 00:22, 11 October 2008

This page will explain how to use the Robot Console for your robot.

The Robot Console

The Robot Console is a window that first and foremost contains information dedicated to an individual robot. The information is printed out by the robot itself or from the Robocode game. Information is printed out by the robot using e.g. System.out.print(), System.err.println(), out.println(), and similar.

But information can also be printed out from the game about events that involves the robot. Such information will be prefixed with "System:", so you know that the information comes from the game itself. NOTE: If exceptions occur in a robot that is not catched/handled inside the robot, the game will catch the exception of the robot and dump the stack trace of the exception to the console. This is done to notify the developer of the robot that something went wrong inside the robot, but also where in robot it went wrong (can be seen using the stack trace).

Thus, if your robot does not behave as you expect, it might be a very good idea to open the console window for your robot and see if the robot is causing an exception, is skipping turns, or something else.

How to open the Console Window

So, when you want to read the output for your robot, you just have to open the console window of your robot. NOTE: In order to be able to open a console window of a robot, the robot must first be added to the current battle as participant.

The console window of a robot is opened by clicking on the button on the right side of the battle view, which contains the name of the robot you want to open the console window for:

Shows the Robot Console buttons on the right side of the battle view, where the mouse pointer is pointing at the console button for the sample robot named Corner


Usage of the Console Window

When you have clicked on the button for the robot, the following console window will pop up:

Shows the Robot Console window for the sample robot named Corner


As you can see on the image above, the Robot Console window contains some buttons, which are described here:

OK Closes the window
Clear Clears all the text printed in the console
Kill Robot Kills the robot
Paint Enables/disables painting the robot (using the onPaint method)
Robocode SG Enables/disables compability mode with a robot coded for Robocode SG
Pause/Debug Pauses/resumes the game. The pause mode can be used when debugging

See also

Robot API

Tutorials

News and Releases

Home pages