Class Fire

java.lang.Object

Fire

public class Fire
extends java.lang.Object

This class represents a fire that is burning, which ejects a Fireball in a random direction every 3-6 seconds. This fire can slowly be extinguished through repeated collisions with water.

This class should contain and use at least the following private fields:

• private Graphic graphic;
• private Random randGen;
• private int fireballCountdown;
• private int heat;

Constructor Summary

Constructors

Constructor and Description
Fire(float x, float y, java.util.Random randGen) This constructor initializes a new instance of Fire at the appropriate location and with the appropriate amount of heat.

Method Summary

Modifier and Type	Method and Description
Graphic	getGraphic() This is a simple accessor for this object's Graphic, which may be used by other objects to check for collisions.
void	handleWaterCollisions(Water[] water) This method detects and handles collisions between any active (!= null) Water objects, and the current Fire.
boolean	shouldRemove() This method should return false until this Fire's heat drops down to 0 or less.
Fireball	update(int time) This method is called repeatedly by the Level to draw and occasionally launch a new Fireball in a random direction.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Fire

public Fire(float x,
            float y,
            java.util.Random randGen)

This constructor initializes a new instance of Fire at the appropriate location and with the appropriate amount of heat. The Random number generator should be used both to determine how much time remains before the next Fireball is propelled, and the random direction it is shot in.

Parameters:

x - the x-coordinate of this new Fire's position

y - the y-coordinate of this new Fire's position

randGen - a Random number generator to determine when and in which direction new Fireballs are created and launched.

Method Detail

update

public Fireball update(int time)

This method is called repeatedly by the Level to draw and occasionally launch a new Fireball in a random direction.

Parameters:

time - is the amount of time in milliseconds that has elapsed since the last time this update was called.

Returns:

null unless a new Fireball was just created and launched. In that case, a reference to that new Fireball is returned instead.

getGraphic

public Graphic getGraphic()

This is a simple accessor for this object's Graphic, which may be used by other objects to check for collisions.

Returns:

a reference to this Fire's Graphic object.

handleWaterCollisions

public void handleWaterCollisions(Water[] water)

This method detects and handles collisions between any active (!= null) Water objects, and the current Fire. When a collision is found, the colliding water should be removed, and this Fire's heat should be decremented by 1. If this Fire's heat dips below one, then it should no longer be drawn to the screen, eject new Fireballs, or collide with Water and its shouldRemove() method should start returning true.

Parameters:

water - is the Array of water objects that have been launched by the Hero (ignore any null references within this array).

shouldRemove

public boolean shouldRemove()

This method should return false until this Fire's heat drops down to 0 or less. After that it should begin to return true instead.

Returns:

false when this Fire's heat is greater than zero, otherwise true.