AdvancedRobot MethodsRobocode Robot API for .NET
The AdvancedRobot type exposes the following members.
Methods

  NameDescription
Public methodAddCustomEvent(Condition)
Registers a custom event to be called when a condition is met. When you are finished with your condition or just want to remove it you must call RemoveCustomEvent(Condition).

Examples

// Create the condition for our custom event
Condition triggerHitCondition = new Condition("triggerhit")
{
    public bool Test()
    {
        return (Energy <= trigger);
    }
}

// Add our custom event based on our condition
AddCustomEvent(triggerHitCondition);
Public methodAddCustomEvent(String, Int32, ConditionTest)
Same as AddCustomEvent(Condition), but alows to define condition as anonymous method.
Public methodAhead
Immediately moves your robot ahead (forward) by distance measured in pixels.

This call executes immediately, and does not return until it is complete, i.e. when the remaining distance to move is 0.

If the robot collides with a wall, the move is complete, meaning that the robot will not move any further. If the robot collides with another robot, the move is complete if you are heading toward the other robot.

Note that both positive and negative values can be given as input, where negative values means that the robot is set to move backward instead of forward.

Examples

// Move the robot 100 pixels forward
Ahead(100);

// Afterwards, move the robot 50 pixels backward
Ahead(-50);
(Inherited from Robot.)
Public methodBack
Immediately moves your robot backward by distance measured in pixels.

This call executes immediately, and does not return until it is complete, i.e. when the remaining distance to move is 0.

If the robot collides with a wall, the move is complete, meaning that the robot will not move any further. If the robot collides with another robot, the move is complete if you are heading toward the other robot.

Note that both positive and negative values can be given as input, where negative values means that the robot is set to move forward instead of backward.

Examples

// Move the robot 100 pixels backward
Back(100);

// Afterwards, move the robot 50 pixels forward
Back(-50);
(Inherited from Robot.)
Public methodClearAllEvents
Clears Out any pending events in the robot's event queue immediately.
Public methodDoNothing
Do nothing this turn, meaning that the robot will skip it's turn.

This call executes immediately, and does not return until the turn is over.
(Inherited from Robot.)
Public methodExecute
Executes any pending actions, or continues executing actions that are in process. This call returns after the actions have been started.

Note that advanced robots must call this function in order to Execute pending set* calls like e.g. SetAhead(Double), SetFire(Double), SetTurnLeft(Double) etc. Otherwise, these calls will never get executed.

In this example the robot will move while turning:
Examples

SetTurnRight(90);
SetAhead(100);
Execute();

while (DistanceRemaining > 0 && TurnRemaining > 0)
{
    Execute();
}
Public methodFire
Immediately fires a bullet. The bullet will travel in the direction the gun is pointing.

The specified bullet power is an amount of energy that will be taken from the robot's energy. Hence, the more power you want to spend on the bullet, the more energy is taken from your robot.

The bullet will do (4 * power) damage if it hits another robot. If power is greater than 1, it will do an additional 2 * (power - 1) damage. You will get (3 * power) back if you hit the other robot. You can call GetBulletDamage(Double) for getting the damage that a bullet with a specific bullet power will do.

The specified bullet power should be between MIN_BULLET_POWER and MAX_BULLET_POWER.

Note that the gun cannot Fire if the gun is overheated, meaning that GunHeat returns a value > 0.

A event is generated when the bullet hits a robot (BulletHitEvent), wall (BulletMissedEvent), or another bullet (BulletHitBulletEvent).

Examples

// Fire a bullet with maximum power if the gun is ready 
if (GetGunHeat() == 0)
{
    Fire(Rules.MAX_BULLET_POWER);
}
(Inherited from Robot.)
Public methodFireBullet
Immediately fires a bullet. The bullet will travel in the direction the gun is pointing.

The specified bullet power is an amount of energy that will be taken from the robot's energy. Hence, the more power you want to spend on the bullet, the more energy is taken from your robot.

The bullet will do (4 * power) damage if it hits another robot. If power is greater than 1, it will do an additional 2 * (power - 1) damage. You will get (3 * power) back if you hit the other robot. You can call GetBulletDamage(Double) for getting the damage that a bullet with a specific bullet power will do.

The specified bullet power should be between MIN_BULLET_POWER and MAX_BULLET_POWER.

Note that the gun cannot Fire if the gun is overheated, meaning that GunHeat returns a value > 0.

A event is generated when the bullet hits a robot (BulletHitEvent), wall (BulletMissedEvent), or another bullet (BulletHitBulletEvent).

Examples

// Fire a bullet with maximum power if the gun is ready 
if (GetGunHeat() == 0)
{
    Bullet bullet = FireBullet(Rules.MAX_BULLET_POWER);

    // Get the velocity of the bullet 
    if (bullet != null)
    {
        double bulletVelocity = bullet.Velocity;
    }
}
Returns a Bullet That contains information about the bullet if it was actually fired, which can be used for tracking the bullet after it has been fired. If the bullet was not fired, null is returned.
(Inherited from Robot.)
Public methodGetAllEvents
Returns a list containing all events currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (Event evnt : GetAllEvents()) {
    if (evnt is HitRobotEvent) {
        // do something with the event
    } else if (evnt is HitByBulletEvent) {
        // do something with the event
    }
}
Public methodGetBulletHitBulletEvents
Returns a list containing all BulletHitBulletEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (BulletHitBulletEvent evnt : GetBulletHitBulletEvents())
{
    // do something with the event
}
Public methodGetBulletHitEvents
Returns a list containing all BulletHitEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (BulletHitEvent event: GetBulletHitEvents())
{
    // do something with the event
}
Public methodGetBulletMissedEvents
Returns a list containing all BulletMissedEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (BulletMissedEvent evnt : GetBulletMissedEvents())
{
    // do something with the event
}
Public methodGetDataDirectory
Returns a file representing a data directory for the robot.

The system will automatically create the directory for you, so you do not need to create it by yourself.
Public methodGetDataFile
Returns a file in your data directory that you can write to.

The system will automatically create the directory for you, so you do not need to create it by yourself.

Please notice that the max. size of your data file is set to 200000 bytes (~195 KB).

See the Sample.SittingDuck to see an example of how to use this method.
Public methodGetEventPriority
Returns the current priority of a class of events. An event priority is a value from 0 - 99. The higher value, the higher priority.

Examples

int myHitRobotPriority = GetEventPriority("HitRobotEvent");

The default priorities are, from highest to lowest:
BattleEndedEvent:     100 (reserved)
                WinEvent:             100 (reserved)
                SkippedTurnEvent:     100 (reserved)
                StatusEvent:           99
                Key and mouse events:  98
                CustomEvent:           80 (default value)
                MessageEvent:          75
                RobotDeathEvent:       70
                BulletMissedEvent:     60
                BulletHitBulletEvent:  55
                BulletHitEvent:        50
                HitByBulletEvent:      40
                HitWallEvent:          30
                HitRobotEvent:         20
                ScannedRobotEvent:     10
                PaintEvent:             5
                DeathEvent:            -1 (reserved)
              
Public methodGetHitByBulletEvents
Returns a list containing all HitByBulletEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (HitByBulletEvent evnt : GetHitByBulletEvents())
{
    // do something with the event
}
Public methodGetHitRobotEvents
Returns a list containing all HitRobotEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (HitRobotEvent evnt : GetHitRobotEvents())
{
    // do something with the event
}
Public methodGetHitWallEvents
Returns a list containing all HitWallEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (HitWallEvent evnt : GetHitWallEvents())
{
    // do something with the event
}
Public methodGetRobotDeathEvents
Returns a list containing all RobotDeathEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (RobotDeathEvent evnt : GetRobotDeathEvents())
{
    // do something with the event
}
Public methodGetScannedRobotEvents
Returns a list containing all ScannedRobotEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (ScannedRobotEvent evnt : GetScannedRobotEvents())
{
    // do something with the event
}
Public methodGetStatusEvents
Returns a list containing all StatusEvents currently in the robot's queue. You might, for example, call this while processing another event.

Examples

for (StatusEvent evnt : GetStatusEvents())
{
    // do something with the event
}
Public methodOnBattleEnded
This method is called after end of the battle, even when the battle is aborted. You should override it in your robot if you want to be informed of this event.

Examples

public void OnBattleEnded(BattleEndedEvent evnt)
{
    Out.WriteLine("The battle has ended");
}
(Inherited from Robot.)
Public methodOnBulletHit
This method is called when one of your bullets hits another robot. You should override it in your robot if you want to be informed of this event.

Examples

public void OnBulletHit(BulletHitEvent evnt)
{
    Out.WriteLine("I hit " + evnt.Name + "!");
}
(Inherited from Robot.)
Public methodOnBulletHitBullet
This method is called when one of your bullets hits another bullet. You should override it in your robot if you want to be informed of this event.

Examples

public void OnBulletHitBullet(BulletHitBulletEvent evnt)
{
    Out.WriteLine("I hit a bullet fired by " + evnt.Bullet.Name + "!");
}
(Inherited from Robot.)
Public methodOnBulletMissed
This method is called when one of your bullets misses, i.e. hits a wall. You should override it in your robot if you want to be informed of this event.

Examples

public void OnBulletMissed(BulletMissedEvent evnt)
{
    Out.WriteLine("Drat, I missed.");
}
(Inherited from Robot.)
Public methodOnCustomEvent
This method is called when a custom condition is met.

See the sample robots for examples of use, e.g. the Sample.Target robot.
Public methodOnDeath
This method is called if your robot dies.

You should override it in your robot if you want to be informed of this event. Actions will have no effect if called from this section. The intent is to allow you to perform calculations or print something out when the robot is killed.
(Overrides Robot OnDeath(DeathEvent).)
Public methodOnHitByBullet
This method is called when your robot is hit by a bullet. You should override it in your robot if you want to be informed of this event.

Examples

void OnHitByBullet(HitByBulletEvent evnt)
{
    Out.WriteLine(event.RobotName + " hit me!");
}
(Inherited from Robot.)
Public methodOnHitRobot
This method is called when your robot collides with another robot. You should override it in your robot if you want to be informed of this event.

Examples

void OnHitRobot(HitRobotEvent evnt)
{
    if (event.Bearing > -90 && evnt.Bearing <= 90)
    {
        Back(100);
    }
    else
    {
        Ahead(100);
    }
}
public void OnHitRobot(HitRobotEvent evnt)
{
    if (event.Bearing > -90 && evnt.Bearing <= 90)
    {
        SetBack(100);
    }
    else
    {
        SetAhead(100);
    }
}
-- or perhaps, for a more advanced robot --

The angle is relative to your robot's facing. So 0 is straight ahead of you.

This event can be generated if another robot hits you, in which case IsMyFault will return false. In this case, you will not be automatically stopped by the game -- but if you continue moving toward the robot you will hit it (and generate another event). If you are moving away, then you won't hit it.
(Inherited from Robot.)
Public methodOnHitWall
This method is called when your robot collides with a wall. You should override it in your robot if you want to be informed of this event.

The wall at the top of the screen is 0 degrees, right is 90 degrees, bottom is 180 degrees, left is 270 degrees. But this event is relative to your heading, so: The bearing is such that TurnRight(Double)Bearing will point you perpendicular to the wall.

Examples

void OnHitWall(HitWallEvent evnt)
{
    Out.WriteLine("Ouch, I hit a wall bearing " + evnt.Bearing + " degrees.");
}
(Inherited from Robot.)
Public methodOnKeyPressed
This method is called when a key has been pressed.

See the Sample.Interactive robot for an example of how to use key events.
(Inherited from Robot.)
Public methodOnKeyReleased
This method is called when a key has been released.

See the Sample.Interactive robot for an example of how to use key events.
(Inherited from Robot.)
Public methodOnKeyTyped
This method is called when a key has been typed (pressed and released).

See the Sample.Interactive robot for an example of how to use key events.
(Inherited from Robot.)
Public methodOnMouseClicked
This method is called when a mouse button has been clicked (pressed and released).

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseDragged
This method is called when a mouse button has been pressed and then dragged.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseEntered
This method is called when the mouse has entered the battle view.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseExited
This method is called when the mouse has exited the battle view.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseMoved
This method is called when the mouse has been moved.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMousePressed
This method is called when a mouse button has been pressed.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseReleased
This method is called when a mouse button has been released.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnMouseWheelMoved
This method is called when the mouse wheel has been rotated.

See the Sample.Interactive robot for an example of how to use mouse events.
(Inherited from Robot.)
Public methodOnPaint
This method is called every time the robot is painted. You should override this method if you want to draw items for your robot on the battle field, e.g. targets, virtual bullets etc.

This method is very useful for debugging your robot.

Note that the robot will only be painted if the "Paint" is enabled on the robot's console window; otherwise the robot will never get painted (the reason being that all robots might have graphical items that must be painted, and then you might not be able to tell what graphical items that have been painted for your robot).

Also note that the coordinate system for the graphical context where you paint items fits for the Robocode coordinate system where (0, 0) is at the bottom left corner of the battlefield, where X is towards right and Y is upwards.
(Inherited from Robot.)
Public methodOnRobotDeath
This method is called when another robot dies. You should override it in your robot if you want to be informed of this event.
(Inherited from Robot.)
Public methodOnRoundEnded
This method is called after the end of a round. You should override it in your robot if you want to be informed of this event.

Examples

public void OnRoundEnded(RoundEndedEvent event)
{
    Out.WriteLine("The round has ended");
}
(Inherited from Robot.)
Public methodOnScannedRobot
This method is called when your robot sees another robot, i.e. when the robot's radar scan "hits" another robot. You should override it in your robot if you want to be informed of this event. (Almost all robots should override this!)

This event is automatically called if there is a robot in range of your radar.

Note that the robot's radar can only see robot within the range defined by RADAR_SCAN_RADIUS (1200 pixels).

Also not that the bearing of the scanned robot is relative to your robot's heading.

Examples

void OnScannedRobot(ScannedRobotEvent evnt)
{
    // Assuming radar and gun are aligned... 
    if (event.Distance < 100)
    {
        Fire(3);
    }
    else
    {
        Fire(1);
    }
}

Note:
The game assists Robots in firing, as follows:
  • If the gun and radar are aligned (and were aligned last turn),
  • and the event is current,
  • and you call Fire() before taking any other actions, Robot.Fire(double) will Fire directly at the robot.

In essence, this means that if you can see a robot, and it doesn't move, then Fire will hit it.

AdvancedRobots will NOT be assisted in this manner, and are expected to examine the event to determine if Fire(Double) would hit. (i.e. you are spinning your gun around, but by the time you get the event, your gun is 5 degrees past the robot).
(Inherited from Robot.)
Public methodOnSkippedTurn
This method is called if the robot is using too much time between actions. When this event occur, the robot's turn is skipped, meaning that it cannot take action anymore in this turn.

If you receive 30 skipped turn event, your robot will be removed from the round and loose the round.

You will only receive this event after taking an action. So a robot in an infinite loop will not receive any events, and will simply be stopped.

No correctly working, reasonable robot should ever receive this event unless it is using too many CPU cycles.
Public methodOnStatus
This method is called every turn in a battle round in order to provide the robot status as a complete snapshot of the robot's current state at that specific time.

The main benefit of this method is that you'll automatically receive all current data values of the robot like e.g. the x and y coordinate, heading, gun heat etc., which are grouped into the exact same time/turn.

This is the only way to map the robots data values to a specific time. For example, it is not possible to determine the exact time of the robot's heading by calling first calling Time and then Heading afterwards, as the time might change after between the Time and Heading call.
(Inherited from Robot.)
Public methodOnWin
This method is called if your robot wins a battle.

Your robot could perform a victory dance here! :-)
(Inherited from Robot.)
Public methodRemoveCustomEvent
Removes a custom event that was previously added by calling AddCustomEvent(Condition).

Examples

// Create the condition for our custom event
Condition triggerHitCondition = new Condition("triggerhit")
{
    public bool Test()
    {
        return (Energy <= trigger);
    }
}

// Add our custom event based on our condition
AddCustomEvent(triggerHitCondition);
...
// do something with your robot
...
// Remove the custom event based on our condition
RemoveCustomEvent(triggerHitCondition);
Public methodResume
Immediately resumes the movement you stopped by Stop , if any.

This call executes immediately, and does not return until it is complete.
(Inherited from Robot.)
Public methodRun
The main method in every robot. You must override this to set up your robot's basic behavior.

Examples

// A basic robot that moves around in a square 
public void Run()
{
    while (true)
    {
        Ahead(100);
        TurnRight(90);
    }
}
(Inherited from Robot.)
Public methodScan
Scans for other robots. This method is called automatically by the game, as long as the robot is moving, turning its body, turning its gun, or turning its radar.

Scan will cause OnScannedRobot(ScannedRobotEvent) to be called if you see a robot.

There are 2 reasons to call Scan  manually:
  1. You want to scan after you stop moving.
  2. You want to interrupt the OnScannedRobot(ScannedRobotEvent) event. This is more likely. If you are in OnScannedRobot(ScannedRobotEvent) and call Scan , and you still see a robot, then the system will interrupt your OnScannedRobot(ScannedRobotEvent) event immediately and start it from the top.

This call executes immediately.
(Inherited from Robot.)
Public methodSetAhead
Sets the robot to move ahead (forward) by distance measured in pixels when the next execution takes place.

This call returns immediately, and will not execute until you call Execute  or take an action that executes.

Note that both positive and negative values can be given as input, where positive values means that the robot is set to move ahead, and negative values means that the robot is set to move back. If 0 is given as input, the robot will stop its movement, but will have to decelerate till it stands still, and will thus not be able to stop its movement immediately, but eventually.
Public methodSetAllColors
Sets all the robot's color to the same color in the same time, i.e. the color of the body, gun, radar, bullet, and scan arc.

You may only call this method one time per battle. A null indicates the default (blue) color for the body, gun, radar, and scan arc, but white for the bullet color.

Examples

// Don't forget to using System.Drawing at the top... 
using System.Drawing;
...

public void Run()
{
    SetAllColors(Color.Red);
    ...
}
(Inherited from Robot.)
Public methodSetBack
Sets the robot to move back by distance measured in pixels when the next execution takes place.

This call returns immediately, and will not execute until you call Execute  or take an action that executes.

Note that both positive and negative values can be given as input, where positive values means that the robot is set to move back, and negative values means that the robot is set to move ahead. If 0 is given as input, the robot will stop its movement, but will have to decelerate till it stands still, and will thus not be able to stop its movement immediately, but eventually.

Examples

// Set the robot to move 50 pixels back
SetBack(50);

// Set the robot to move 100 pixels ahead 
// (overrides the previous order)
SetBack(-100);

...
// Executes the last SetBack()
Execute();
Public methodSetColors(Color, Color, Color)
Sets the color of the robot's body, gun, and radar in the same time.

You may only call this method one time per battle. A null indicates the default (blue) color.

Examples

// Don't forget to using System.Drawing at the top... 
using System.Drawing;
...

public void Run()
{
    SetColors(null, Color.Red, Color.fromArgb(150, 0, 150));
    ...
}
(Inherited from Robot.)
Public methodSetColors(Color, Color, Color, Color, Color)
Sets the color of the robot's body, gun, radar, bullet, and scan arc in the same time.

You may only call this method one time per battle. A null indicates the default (blue) color for the body, gun, radar, and scan arc, but white for the bullet color.

Examples

// Don't forget to using System.Drawing at the top... 
using System.Drawing;
...

public void Run()
{
    SetColors(null, Color.Red, Color.Greeen, null, Color.fromArgb(150, 0, 150));
    ...
}
(Inherited from Robot.)
Public methodSetEventPriority
Sets the priority of a class of events.

Events are sent to the onXXX handlers in order of priority. Higher priority events can interrupt lower priority events. For events with the same priority, newer events are always sent first. Valid priorities are 0 - 99, where 100 is reserved and 80 is the default priority.

Examples

SetEventPriority("RobotDeathEvent", 15);

The default priorities are, from highest to lowest:
WinEvent:             100 (reserved)
                SkippedTurnEvent:     100 (reserved)
                StatusEvent:           99
                CustomEvent:           80
                MessageEvent:          75
                RobotDeathEvent:       70
                BulletMissedEvent:     60
                BulletHitBulletEvent:  55
                BulletHitEvent:        50
                HitByBulletEvent:      40
                HitWallEvent:          30
                HitRobotEvent:         20
                ScannedRobotEvent:     10
                PaintEvent:             5
                DeathEvent:            -1 (reserved)
              

Note that you cannot change the priority for events with the special priority value -1 or 100 (reserved) as these events are system events. Also note that you cannot change the priority of CustomEvent. Instead you must change the priority of the condition(s) for your custom event(s).
Public methodSetFire
Sets the gun to Fire a bullet when the next execution takes place. The bullet will travel in the direction the gun is pointing.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

The specified bullet power is an amount of energy that will be taken from the robot's energy. Hence, the more power you want to spend on the bullet, the more energy is taken from your robot.

The bullet will do (4 * power) damage if it hits another robot. If power is greater than 1, it will do an additional 2 * (power - 1) damage. You will get (3 * power) back if you hit the other robot. You can call Rules.GetBulletDamage(double)} for getting the damage that a bullet with a specific bullet power will do.

The specified bullet power should be between MIN_BULLET_POWER and MAX_BULLET_POWER.

Note that the gun cannot Fire if the gun is overheated, meaning that GunHeat returns a value > 0.

An event is generated when the bullet hits a robot, wall, or another bullet.

Examples

// Fire a bullet with maximum power if the gun is ready 
if (GunGeat == 0)
{
    SetFire(Rules.MAX_BULLET_POWER);
}
...
Execute();
Public methodSetFireBullet
Sets the gun to Fire a bullet when the next execution takes place. The bullet will travel in the direction the gun is pointing.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

The specified bullet power is an amount of energy that will be taken from the robot's energy. Hence, the more power you want to spend on the bullet, the more energy is taken from your robot.

The bullet will do (4 * power) damage if it hits another robot. If power is greater than 1, it will do an additional 2 * (power - 1) damage. You will get (3 * power) back if you hit the other robot. You can call GetBulletDamage(Double) for getting the damage that a bullet with a specific bullet power will do.

The specified bullet power should be between MIN_BULLET_POWER and MAX_BULLET_POWER.

Note that the gun cannot Fire if the gun is overheated, meaning that GunHeat returns a value > 0.

An event is generated when the bullet hits a robot (BulletHitEvent), wall (BulletMissedEvent), or another bullet (BulletHitBulletEvent).

Examples

Bullet bullet = null;

// Fire a bullet with maximum power if the gun is ready 
if (GunHeat == 0)
{
    bullet = SetFireBullet(Rules.MAX_BULLET_POWER);
}
...
Execute();
...
// Get the velocity of the bullet 
if (bullet != null)
{
    double bulletVelocity = bullet.Velocity;
}
Public methodSetResume
Sets the robot to resume the movement stopped by Stop  or SetStop , if any.

This call returns immediately, and will not execute until you call Execute  or take an action that executes.
Public methodSetStop 
This call is identical to Stop , but returns immediately, and will not execute until you call Execute  or take an action that executes.

If there is already movement saved from a previous stop, this will have no effect.

This call is equivalent to calling SetStop(false);
Public methodSetStop(Boolean)
This call is identical to Stop(Boolean), but returns immediately, and will not execute until you call Execute  or take an action that executes.

If there is already movement saved from a previous stop, you can overwrite it by calling SetStop(true).
Public methodSetTurnGunLeft
Sets the robot's gun to turn left by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn right instead of left.

Examples

// Set the gun to turn 180 degrees to the left
SetTurnGunLeft(180);

// Set the gun to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnGunLeft(-90);

...
// Executes the last SetTurnGunLeft()
Execute();
Public methodSetTurnGunLeftRadians
Sets the robot's gun to turn left by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn right instead of left.

Examples

// Set the gun to turn 180 degrees to the left
SetTurnGunLeftRadians(Math.PI);

// Set the gun to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnGunLeftRadians(-Math.PI / 2);

...
// Executes the last SetTurnGunLeftRadians()
Execute();
Public methodSetTurnGunRight
Sets the robot's gun to turn right by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn left instead of right.

Examples

// Set the gun to turn 180 degrees to the right
SetTurnGunRight(180);

// Set the gun to turn 90 degrees to the left instead of right 
// (overrides the previous order)
SetTurnGunRight(-90);

...
// Executes the last SetTurnGunRight()
Execute();
Public methodSetTurnGunRightRadians
Sets the robot's gun to turn right by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn left instead of right.

Examples

// Set the gun to turn 180 degrees to the right
SetTurnGunRightRadians(Math.PI);

// Set the gun to turn 90 degrees to the left instead of right 
// (overrides the previous order)
SetTurnGunRightRadians(-Math.PI / 2);

...
// Executes the last SetTurnGunRightRadians()
Execute();
Public methodSetTurnLeft
Sets the robot's body to turn left by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn right instead of left.

Examples

// Set the robot to turn 180 degrees to the left
SetTurnLeft(180);

// Set the robot to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnLeft(-90);

...
// Executes the last SetTurnLeft()
Execute();
Public methodSetTurnLeftRadians
Sets the robot's body to turn left by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn right instead of left.

Examples

// Set the robot to turn 180 degrees to the left
SetTurnLeftRadians(Math.PI);

// Set the robot to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnLeftRadians(-Math.PI / 2);

...
// Executes the last SetTurnLeftRadians()
Execute();
Public methodSetTurnRadarLeft
Sets the robot's radar to turn left by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn right instead of left.

Examples

// Set the radar to turn 180 degrees to the left
SetTurnRadarLeft(180);

// Set the radar to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnRadarLeft(-90);

...
// Executes the last SetTurnRadarLeft()
Execute();
Public methodSetTurnRadarLeftRadians
Sets the robot's radar to turn left by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn right instead of left.

Examples

// Set the radar to turn 180 degrees to the left
SetTurnRadarLeftRadians(Math.PI);

// Set the radar to turn 90 degrees to the right instead of left 
// (overrides the previous order)
SetTurnRadarLeftRadians(-Math.PI / 2);

...
// Executes the last SetTurnRadarLeftRadians()
Execute();
Public methodSetTurnRadarRight
Sets the robot's radar to turn right by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn left instead of right.

Examples

// Set the radar to turn 180 degrees to the right
SetTurnRadarRight(180);

// Set the radar to turn 90 degrees to the right instead of right 
// (overrides the previous order)
SetTurnRadarRight(-90);

...
// Executes the last SetTurnRadarRight()
Execute();
Public methodSetTurnRadarRightRadians
Sets the robot's radar to turn right by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn left instead of right.

Examples

// Set the radar to turn 180 degrees to the right
SetTurnRadarRightRadians(Math.PI);

// Set the radar to turn 90 degrees to the right instead of right 
// (overrides the previous order)
SetTurnRadarRightRadians(-Math.PI / 2);

...
// Executes the last SetTurnRadarRightRadians()
Execute();
Public methodSetTurnRight
Sets the robot's body to turn right by degrees when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn left instead of right.

Examples

// Set the robot to turn 180 degrees to the right
SetTurnRight(180);

// Set the robot to turn 90 degrees to the left instead of right 
// (overrides the previous order)
SetTurnRight(-90);

...
// Executes the last SetTurnRight()
Execute();
Public methodSetTurnRightRadians
Sets the robot's body to turn right by radians when the next execution takes place.

This call returns immediately, and will not execute until you call Execute() or take an action that executes.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn left instead of right.

Examples

// Set the robot to turn 180 degrees to the right
SetTurnRightRadians(Math.PI);

// Set the robot to turn 90 degrees to the left instead of right 
// (overrides the previous order)
SetTurnRightRadians(-Math.PI / 2);

...
// Executes the last SetTurnRightRadians()
Execute();
Public methodStop 
Immediately stops all movement, and saves it for a call to Resume . If there is already movement saved from a previous stop, this will have no effect.

This method is equivalent to Stop(false).
(Inherited from Robot.)
Public methodStop(Boolean)
Immediately stops all movement, and saves it for a call to Resume . If there is already movement saved from a previous stop, you can overwrite it by calling Stop(true).
(Inherited from Robot.)
Public methodTurnGunLeft
Immediately turns the robot's gun to the left by degrees.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the gun's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn right instead of left.

Examples

// Turn the robot's gun 180 degrees to the left
TurnGunLeft(180);

// Afterwards, turn the robot's gun 90 degrees to the right
TurnGunLeft(-90);
(Inherited from Robot.)
Public methodTurnGunLeftRadians
Immediately turns the robot's gun to the left by radians.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the gun's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn right instead of left.

Examples

// Turn the robot's gun 180 degrees to the left
TurnGunLeftRadians(Math.PI);

// Afterwards, turn the robot's gun 90 degrees to the right
TurnGunLeftRadians(-Math.PI / 2);
Public methodTurnGunRight
Immediately turns the robot's gun to the right by degrees. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the gun's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn left instead of right.

Examples

// Turn the robot's gun 180 degrees to the right
TurnGunRight(180);

// Afterwards, turn the robot's gun 90 degrees to the left
TurnGunRight(-90);
(Inherited from Robot.)
Public methodTurnGunRightRadians
Immediately turns the robot's gun to the right by radians. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the gun's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's gun is set to turn left instead of right.

Examples

// Turn the robot's gun 180 degrees to the right
TurnGunRightRadians(Math.PI);

// Afterwards, turn the robot's gun 90 degrees to the left
TurnGunRightRadians(-Math.PI / 2);
Public methodTurnLeft
Immediately turns the robot's body to the left by degrees.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the robot's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn right instead of left.

Examples

// Turn the robot 180 degrees to the left
TurnLeft(180);

// Afterwards, turn the robot 90 degrees to the right
TurnLeft(-90);
(Inherited from Robot.)
Public methodTurnLeftRadians
Immediately turns the robot's body to the left by radians.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the robot's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn right instead of left.

Examples

// Turn the robot 180 degrees to the left
TurnLeftRadians(Math.PI);

// Afterwards, turn the robot 90 degrees to the right
TurnLeftRadians(-Math.PI / 2);
Public methodTurnRadarLeft
Immediately turns the robot's radar to the left by degrees.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the radar's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn right instead of left.

Examples

// Turn the robot's radar 180 degrees to the left
TurnRadarLeft(180);

// Afterwards, turn the robot's radar 90 degrees to the right
TurnRadarLeft(-90);
(Inherited from Robot.)
Public methodTurnRadarLeftRadians
Immediately turns the robot's radar to the left by radians.

This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the radar's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn right instead of left.

Examples

// Turn the robot's radar 180 degrees to the left
TurnRadarLeftRadians(Math.PI);

// Afterwards, turn the robot's radar 90 degrees to the right
TurnRadarLeftRadians(-Math.PI / 2);
Public methodTurnRadarRight
Immediately turns the robot's radar to the right by degrees. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the radar's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn left instead of right.

Examples

// Turn the robot's radar 180 degrees to the right
TurnRadarRight(180);

// Afterwards, turn the robot's radar 90 degrees to the left
TurnRadarRight(-90);
(Inherited from Robot.)
Public methodTurnRadarRightRadians
Immediately turns the robot's radar to the right by radians. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the radar's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's radar is set to turn left instead of right.

Examples

// Turn the robot's radar 180 degrees to the right
TurnRadarRightRadians(Math.PI);

// Afterwards, turn the robot's radar 90 degrees to the left
TurnRadarRightRadians(-Math.PI / 2);
Public methodTurnRight
Immediately turns the robot's body to the right by degrees. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the robot's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn left instead of right.

Examples

// Turn the robot 180 degrees to the right
TurnRight(180);

// Afterwards, turn the robot 90 degrees to the left
TurnRight(-90);
(Inherited from Robot.)
Public methodTurnRightRadians
Immediately turns the robot's body to the right by radians. This call executes immediately, and does not return until it is complete, i.e. when the angle remaining in the robot's turn is 0.

Note that both positive and negative values can be given as input, where negative values means that the robot's body is set to turn left instead of right.

Examples

// Turn the robot 180 degrees to the right
TurnRightRadians(Math.PI);

// Afterwards, turn the robot 90 degrees to the left
TurnRightRadians(-Math.PI / 2);
Public methodWaitFor
Does not return until a condition is met, i.e. when a Test  returns true.

This call executes immediately.

See the Sample.Crazy robot for how this method can be used.
Back to Top
See Also