robocode
Class RobotStatus

java.lang.Object
  extended by robocode.RobotStatus
All Implemented Interfaces:
Serializable

public final class RobotStatus
extends Object
implements Serializable

Contains the status of a robot for a specific time/turn returned by StatusEvent.getStatus().

Since:
1.5
Author:
Flemming N. Larsen (original)
See Also:
Serialized Form

Method Summary
 double getDistanceRemaining()
          Returns the distance remaining in the robot's current move measured in pixels.
 double getEnergy()
          Returns the robot's current energy.
 double getGunHeading()
          Returns the direction that the robot's gun is facing, in degrees.
 double getGunHeadingRadians()
          Returns the direction that the robot's gun is facing, in radians.
 double getGunHeat()
          Returns the current heat of the gun.
 double getGunTurnRemaining()
          Returns the angle remaining in the gun's turn, in degrees.
 double getGunTurnRemainingRadians()
          Returns the angle remaining in the gun's turn, in radians.
 double getHeading()
          Returns the direction that the robot's body is facing, in degrees.
 double getHeadingRadians()
          Returns the direction that the robot's body is facing, in radians.
 int getNumRounds()
          Returns the number of rounds in the current battle.
 int getOthers()
          Returns how many opponents that are left in the current round.
 double getRadarHeading()
          Returns the direction that the robot's radar is facing, in degrees.
 double getRadarHeadingRadians()
          Returns the direction that the robot's radar is facing, in radians.
 double getRadarTurnRemaining()
          Returns the angle remaining in the radar's turn, in degrees.
 double getRadarTurnRemainingRadians()
          Returns the angle remaining in the radar's turn, in radians.
 int getRoundNum()
          Returns the current round number (0 to getNumRounds() - 1) of the battle.
 long getTime()
          Returns the game time of the round, where the time is equal to the current turn in the round.
 double getTurnRemaining()
          Returns the angle remaining in the robots's turn, in degrees.
 double getTurnRemainingRadians()
          Returns the angle remaining in the robots's turn, in radians.
 double getVelocity()
          Returns the velocity of the robot measured in pixels/turn.
 double getX()
          Returns the X position of the robot. (0,0) is at the bottom left of the battlefield.
 double getY()
          Returns the Y position of the robot. (0,0) is at the bottom left of the battlefield.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getEnergy

public double getEnergy()
Returns the robot's current energy.

Returns:
the robot's current energy

getX

public double getX()
Returns the X position of the robot. (0,0) is at the bottom left of the battlefield.

Returns:
the X position of the robot
See Also:
getY()

getY

public double getY()
Returns the Y position of the robot. (0,0) is at the bottom left of the battlefield.

Returns:
the Y position of the robot
See Also:
getX()

getHeadingRadians

public double getHeadingRadians()
Returns the direction that the robot's body is facing, in radians. The value returned will be between 0 and 2 * PI (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, PI / 2 means East, PI means South, and 3 * PI / 2 means West.

Returns:
the direction that the robot's body is facing, in radians.

getHeading

public double getHeading()
Returns the direction that the robot's body is facing, in degrees. The value returned will be between 0 and 360 (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, 90 means East, 180 means South, and 270 means West.

Returns:
the direction that the robot's body is facing, in degrees.

getGunHeadingRadians

public double getGunHeadingRadians()
Returns the direction that the robot's gun is facing, in radians. The value returned will be between 0 and 2 * PI (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, PI / 2 means East, PI means South, and 3 * PI / 2 means West.

Returns:
the direction that the robot's gun is facing, in radians.

getGunHeading

public double getGunHeading()
Returns the direction that the robot's gun is facing, in degrees. The value returned will be between 0 and 360 (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, 90 means East, 180 means South, and 270 means West.

Returns:
the direction that the robot's gun is facing, in degrees.

getRadarHeadingRadians

public double getRadarHeadingRadians()
Returns the direction that the robot's radar is facing, in radians. The value returned will be between 0 and 2 * PI (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, PI / 2 means East, PI means South, and 3 * PI / 2 means West.

Returns:
the direction that the robot's radar is facing, in radians.

getRadarHeading

public double getRadarHeading()
Returns the direction that the robot's radar is facing, in degrees. The value returned will be between 0 and 360 (is excluded).

Note that the heading in Robocode is like a compass, where 0 means North, 90 means East, 180 means South, and 270 means West.

Returns:
the direction that the robot's radar is facing, in degrees.

getVelocity

public double getVelocity()
Returns the velocity of the robot measured in pixels/turn.

The maximum velocity of a robot is defined by Rules.MAX_VELOCITY (8 pixels / turn).

Returns:
the velocity of the robot measured in pixels/turn
See Also:
Rules.MAX_VELOCITY

getTurnRemainingRadians

public double getTurnRemainingRadians()
Returns the angle remaining in the robots's turn, in radians.

This call returns both positive and negative values. Positive values means that the robot is currently turning to the right. Negative values means that the robot is currently turning to the left.

Returns:
the angle remaining in the robots's turn, in radians

getTurnRemaining

public double getTurnRemaining()
Returns the angle remaining in the robots's turn, in degrees.

This call returns both positive and negative values. Positive values means that the robot is currently turning to the right. Negative values means that the robot is currently turning to the left.

Returns:
the angle remaining in the robots's turn, in degrees

getRadarTurnRemainingRadians

public double getRadarTurnRemainingRadians()
Returns the angle remaining in the radar's turn, in radians.

This call returns both positive and negative values. Positive values means that the radar is currently turning to the right. Negative values means that the radar is currently turning to the left.

Returns:
the angle remaining in the radar's turn, in radians

getRadarTurnRemaining

public double getRadarTurnRemaining()
Returns the angle remaining in the radar's turn, in degrees.

This call returns both positive and negative values. Positive values means that the radar is currently turning to the right. Negative values means that the radar is currently turning to the left.

Returns:
the angle remaining in the radar's turn, in degrees

getGunTurnRemainingRadians

public double getGunTurnRemainingRadians()
Returns the angle remaining in the gun's turn, in radians.

This call returns both positive and negative values. Positive values means that the gun is currently turning to the right. Negative values means that the gun is currently turning to the left.

Returns:
the angle remaining in the gun's turn, in radians

getGunTurnRemaining

public double getGunTurnRemaining()
Returns the angle remaining in the gun's turn, in degrees.

This call returns both positive and negative values. Positive values means that the gun is currently turning to the right. Negative values means that the gun is currently turning to the left.

Returns:
the angle remaining in the gun's turn, in degrees

getDistanceRemaining

public double getDistanceRemaining()
Returns the distance remaining in the robot's current move measured in pixels.

This call returns both positive and negative values. Positive values means that the robot is currently moving forwards. Negative values means that the robot is currently moving backwards.

Returns:
the distance remaining in the robot's current move measured in pixels.

getGunHeat

public double getGunHeat()
Returns the current heat of the gun. The gun cannot fire unless this is 0. (Calls to fire will succeed, but will not actually fire unless getGunHeat() == 0).

The amount of gun heat generated when the gun is fired is 1 + (firePower / 5). Each turn the gun heat drops by the amount returned by Robot.getGunCoolingRate(), which is a battle setup.

Note that all guns are "hot" at the start of each round, where the gun heat is 3.

Returns:
the current gun heat
See Also:
Robot.getGunCoolingRate(), Robot.fire(double), Robot.fireBullet(double)

getOthers

public int getOthers()
Returns how many opponents that are left in the current round.

Returns:
how many opponents that are left in the current round.
Since:
1.6.2

getNumRounds

public int getNumRounds()
Returns the number of rounds in the current battle.

Returns:
the number of rounds in the current battle
Since:
1.6.2
See Also:
getRoundNum()

getRoundNum

public int getRoundNum()
Returns the current round number (0 to getNumRounds() - 1) of the battle.

Returns:
the current round number of the battle (zero indexed).
Since:
1.6.2
See Also:
getNumRounds()

getTime

public long getTime()
Returns the game time of the round, where the time is equal to the current turn in the round.

Returns:
the game time/turn of the current round.
Since:
1.6.2


Copyright © 2013 Robocode. All Rights Reserved.