robocode
Class RobotStatus
java.lang.Object
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 |
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.