Class ScannedRobotEvent
- All Implemented Interfaces:
Serializable
,Comparable<Event>
onScannedRobot()
when you scan a robot.
You can use the information contained in this event to determine what to do.
Note: You should not inherit from this class in your own event class! The internal logic of this event class might change. Hence, your robot might not work in future Robocode versions, if you choose to inherit from this class.
- Author:
- Mathew A. Nelson (original), Flemming N. Larsen (contributor)
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.ScannedRobotEvent
(String name, double energy, double bearing, double distance, double heading, double velocity) Deprecated.ScannedRobotEvent
(String name, double energy, double bearing, double distance, double heading, double velocity, boolean isSentryRobot) Called by the game to create a new ScannedRobotEvent. -
Method Summary
Modifier and TypeMethodDescriptionfinal int
Compares this event to another event regarding precedence.double
Returns the bearing to the robot you scanned, relative to your robot's heading, in degrees (-180 <= getBearing() < 180)double
Returns the bearing to the robot you scanned, relative to your robot's heading, in radians (-PI <= getBearingRadians() < PI)double
Returns the distance to the robot (your center to his center).double
Returns the energy of the robot.double
Returns the heading of the robot, in degrees (0 <= getHeading() < 360)double
Returns the heading of the robot, in radians (0 <= getHeading() < 2 * PI)double
getLife()
Deprecated.UsegetEnergy()
instead.getName()
Returns the name of the robot.double
Deprecated.UsegetBearing()
instead.double
Deprecated.UsegetBearing()
instead.double
Deprecated.UsegetBearingRadians()
instead.double
Deprecated.UsegetDistance()
instead.double
Deprecated.UsegetHeading()
instead.double
Deprecated.UsegetHeading()
instead.double
Deprecated.UsegetHeadingRadians()
instead.double
Deprecated.UsegetEnergy()
instead.Deprecated.UsegetName()
instead.double
Deprecated.UsegetVelocity()
instead.double
Returns the velocity of the robot.boolean
Checks if the scanned robot is a sentry robot.Methods inherited from class robocode.Event
getPriority, getTime, setPriority, setTime
-
Constructor Details
-
ScannedRobotEvent
public ScannedRobotEvent()Deprecated.This constructor is only provided in order to preserve backwards compatibility with old robots that inherits from this Event class.Note: You should not inherit from this class in your own event class! The internal logic of this event class might change. Hence, your robot might not work in future Robocode versions, if you choose to inherit from this class.
-
ScannedRobotEvent
public ScannedRobotEvent(String name, double energy, double bearing, double distance, double heading, double velocity) Deprecated.Called by the game to create a new ScannedRobotEvent.- Parameters:
name
- the name of the scanned robotenergy
- the energy of the scanned robotbearing
- the bearing of the scanned robot, in radiansdistance
- the distance from your robot to the scanned robotheading
- the heading of the scanned robotvelocity
- the velocity of the scanned robot
-
ScannedRobotEvent
public ScannedRobotEvent(String name, double energy, double bearing, double distance, double heading, double velocity, boolean isSentryRobot) Called by the game to create a new ScannedRobotEvent.- Parameters:
name
- the name of the scanned robotenergy
- the energy of the scanned robotbearing
- the bearing of the scanned robot, in radiansdistance
- the distance from your robot to the scanned robotheading
- the heading of the scanned robotvelocity
- the velocity of the scanned robotisSentryRobot
- flag specifying if the scanned robot is a sentry robot- Since:
- 1.9.0.0
-
-
Method Details
-
getBearing
public double getBearing()Returns the bearing to the robot you scanned, relative to your robot's heading, in degrees (-180 <= getBearing() < 180)- Returns:
- the bearing to the robot you scanned, in degrees
-
getBearingRadians
public double getBearingRadians()Returns the bearing to the robot you scanned, relative to your robot's heading, in radians (-PI <= getBearingRadians() < PI)- Returns:
- the bearing to the robot you scanned, in radians
-
getDistance
public double getDistance()Returns the distance to the robot (your center to his center).- Returns:
- the distance to the robot.
-
getEnergy
public double getEnergy()Returns the energy of the robot.- Returns:
- the energy of the robot
-
getHeading
public double getHeading()Returns the heading of the robot, in degrees (0 <= getHeading() < 360)- Returns:
- the heading of the robot, in degrees
-
getHeadingRadians
public double getHeadingRadians()Returns the heading of the robot, in radians (0 <= getHeading() < 2 * PI)- Returns:
- the heading of the robot, in radians
-
getLife
Deprecated.UsegetEnergy()
instead.- Returns:
- the energy of the robot
-
getName
Returns the name of the robot.- Returns:
- the name of the robot
-
getRobotBearing
Deprecated.UsegetBearing()
instead.- Returns:
- the bearing to the robot you scanned, in degrees
-
getRobotBearingDegrees
Deprecated.UsegetBearing()
instead.- Returns:
- the robot bearing in degrees
-
getRobotBearingRadians
Deprecated.UsegetBearingRadians()
instead.- Returns:
- the bearing to the robot you scanned, in radians
-
getRobotDistance
Deprecated.UsegetDistance()
instead.- Returns:
- the distance to the robot.
-
getRobotHeading
Deprecated.UsegetHeading()
instead.- Returns:
- the heading of the robot, in degrees
-
getRobotHeadingDegrees
Deprecated.UsegetHeading()
instead.- Returns:
- the heading of the robot, in degrees
-
getRobotHeadingRadians
Deprecated.UsegetHeadingRadians()
instead.- Returns:
- the heading of the robot, in radians
-
getRobotLife
Deprecated.UsegetEnergy()
instead.- Returns:
- the energy of the robot
-
getRobotName
Deprecated.UsegetName()
instead.- Returns:
- the name of the robot
-
getRobotVelocity
Deprecated.UsegetVelocity()
instead.- Returns:
- the velocity of the robot
-
getVelocity
public double getVelocity()Returns the velocity of the robot.- Returns:
- the velocity of the robot
-
isSentryRobot
public boolean isSentryRobot()Checks if the scanned robot is a sentry robot.- Returns:
true
if the scanned robot is a sentry robot;false
otherwise.- Since:
- 1.9.0.0
-
compareTo
Compares this event to another event regarding precedence. The event precedence is first and foremost determined by the event time, secondly the event priority, and lastly specific event information.This method will first compare the time of each event. If the event time is the same for both events, then this method compared the priority of each event. If the event priorities are equals, then this method will compare the two event based on specific event information.
This method is called by the game in order to sort the event queue of a robot to make sure the events are listed in chronological order.
- Specified by:
compareTo
in interfaceComparable<Event>
- Overrides:
compareTo
in classEvent
- Parameters:
event
- the event to compare to this event.- Returns:
- a negative value if this event has higher precedence, i.e. must be listed before the specified event. A positive value if this event has a lower precedence, i.e. must be listed after the specified event. 0 means that the precedence of the two events are equal.
-
ScannedRobotEvent(String, double, double, double, double, double, boolean)
instead.