Package robocode

Class HitByBulletEvent

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Comparable<Event>

    public final class HitByBulletEvent
    extends Event
    A HitByBulletEvent is sent to onHitByBullet() when your robot has been hit by a bullet. You can use the information contained in this event to determine what to do.
    Author:
    Mathew A. Nelson (original), Flemming N. Larsen (contributor)
    See Also:
    Serialized Form
    • Constructor Summary

      Constructors 
      Constructor Description
      HitByBulletEvent​(double bearing, Bullet bullet)
      Called by the game to create a new HitByBulletEvent.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      double getBearing()
      Returns the bearing to the bullet, relative to your robot's heading, in degrees (-180 < getBearing() <= 180).
      double getBearingRadians()
      Returns the bearing to the bullet, relative to your robot's heading, in radians (-Math.PI < getBearingRadians() <= Math.PI).
      Bullet getBullet()
      Returns the bullet that hit your robot.
      double getHeading()
      Returns the heading of the bullet when it hit you, in degrees (0 <= getHeading() < 360).
      double getHeadingDegrees()
      Deprecated.
      Use getHeading() instead.
      double getHeadingRadians()
      Returns the heading of the bullet when it hit you, in radians (0 <= getHeadingRadians() < 2 * PI).
      java.lang.String getName()
      Returns the name of the robot that fired the bullet.
      double getPower()
      Returns the power of this bullet.
      double getVelocity()
      Returns the velocity of this bullet.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • HitByBulletEvent

        public HitByBulletEvent​(double bearing,
                                Bullet bullet)
        Called by the game to create a new HitByBulletEvent.
        Parameters:
        bearing - the bearing of the bullet that hit your robot, in radians
        bullet - the bullet that has hit your robot
    • Method Detail

      • getBearing

        public double getBearing()
        Returns the bearing to the bullet, relative to your robot's heading, in degrees (-180 < getBearing() <= 180).

        If you were to turnRight(event.getBearing()), you would be facing the direction the bullet came from. The calculation used here is: (bullet's heading in degrees + 180) - (your heading in degrees)

        Returns:
        the bearing to the bullet, in degrees
      • getBearingRadians

        public double getBearingRadians()
        Returns the bearing to the bullet, relative to your robot's heading, in radians (-Math.PI < getBearingRadians() <= Math.PI).

        If you were to turnRightRadians(event.getBearingRadians()), you would be facing the direction the bullet came from. The calculation used here is: (bullet's heading in radians + Math.PI) - (your heading in radians)

        Returns:
        the bearing to the bullet, in radians
      • getBullet

        public Bullet getBullet()
        Returns the bullet that hit your robot.
        Returns:
        the bullet that hit your robot
      • getHeading

        public double getHeading()
        Returns the heading of the bullet when it hit you, in degrees (0 <= getHeading() < 360).

        Note: This is not relative to the direction you are facing. The robot that fired the bullet was in the opposite direction of getHeading() when it fired the bullet.

        Returns:
        the heading of the bullet, in degrees
      • getHeadingDegrees

        @Deprecated
        public double getHeadingDegrees()
        Deprecated.
        Use getHeading() instead.
        Returns:
        the heading of the bullet, in degrees
      • getHeadingRadians

        public double getHeadingRadians()
        Returns the heading of the bullet when it hit you, in radians (0 <= getHeadingRadians() < 2 * PI).

        Note: This is not relative to the direction you are facing. The robot that fired the bullet was in the opposite direction of getHeadingRadians() when it fired the bullet.

        Returns:
        the heading of the bullet, in radians
      • getName

        public java.lang.String getName()
        Returns the name of the robot that fired the bullet.
        Returns:
        the name of the robot that fired the bullet
      • getPower

        public double getPower()
        Returns the power of this bullet. The damage you take (in fact, already took) is 4 * power, plus 2 * (power-1) if power > 1. The robot that fired the bullet receives 3 * power back.
        Returns:
        the power of the bullet
      • getVelocity

        public double getVelocity()
        Returns the velocity of this bullet.
        Returns:
        the velocity of the bullet