Package com.starpoints.game.item

Class ItemRocket

java.lang.Object

com.starpoints.game.Thing

com.starpoints.game.Item

com.starpoints.game.item.ItemRocket

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

ItemBigBossRocket, ItemCleverRocket, ItemDropRocket, ItemDuckRocket, ItemFastRocket, ItemGrayRocket, ItemSwirlRocket, ItemVeryFastRocket

public class ItemRocket
extends Item

Rocket item that moves slowly to the next figures point if used and detonates there.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	active	State of the rocket (ACTIVE/INACTIVE)
protected boolean	DEBUG	Debug flag.
protected boolean	detonating	Flag, if currently detonating.
protected Point	dropPoint	The point on which the user fired the rocket.
protected int	explosionDuration	Duration of detonation.
protected java.lang.String	loopName	The name of the sound clip to loop as rocket warning.
protected static int	OFF	Sound constant for no sound.
protected Figure	owner	Owner after being picked up
protected int	speed	Speed of the rocket.
protected java.util.ArrayList<Point>	targetLine	The line of points to the target.
protected int	targetX	Target x position.
protected int	targetY	Target y position.

Fields inherited from class com.starpoints.game.Item

affectsBlue, category, DEFAULT_ITEM_PAINTERCLASS, dieReason, isBomb, isWeapon, pickupClip, pickupText, pointBonus, useClip, user

Fields inherited from class com.starpoints.game.Thing

energy, energyFx, energyMaxSoundPlayed, energyModifications, explosionCounter, game, imageName, innerColor, invulnCount, isAffectedByBlack, isAffectedByGray, level, MAX_TEXTPAINT, maxEnergy, nextID, outerColor, p, shieldCount, status, text

Constructor Summary

Constructors

Constructor	Description
ItemRocket()	Creates a new ItemRocket.

Method Summary

Modifier and Type	Method	Description
protected void	addStateProperties(ThingState state, AnimationInfo animation)	Adds properties necessary for rocket painting.
protected void	beFired()	Sets the state to ACTIVE, calls the fields rocketStarted-method, and starts the sound fx.
void	calculateTarget(int xpos, int ypos)	Calculates the rocket target using the given start coordinates.
void	calculateTarget(int xpos, int ypos, boolean checkInvisibility, boolean checkECM)	Determines the nearest target figure and calculates the target line.
protected void	calculateTargetLine()	Calculates the points to move over when fired.
void	detonate(Point p, AnimationInfo animation)	Detonates with a radius depending on the rockets energy.
void	die(Thing source, DieReason reason, AnimationInfo animation)	Explodes, if INACTIVE, otherwise detonate.
protected void	doSpecialUpdate(AnimationInfo animation)	Recalculates the target and target line.
ItemCategory	getCategory()	Returns the items category.
int	getItemRating()	Returns an item value for ComputerFigures rating in the items category.
int	getMoveAnimationLength()	Method that can be overwritten by moving item subclasses, in case move animation should not last for default of 3 update cycles.
protected Thing	getNearestTarget(int xpos, int ypos, boolean checkInvisibility, boolean checkECM)	Gets the nearest figure for target determination
protected Point	getNextCalculatedPoint()	Gets the first point of the target line.
protected Point	getNextPoint(int xp, int yp)	Gets the next point.
protected Figure	getOwner()	Returns this rockets owner.
java.lang.String	getPainterClassname()	Gets the fully qualified classname of the Painter to use for this item (in 2D game).
Item	getRocketeer()	Gets an ItemRocketeer, in case this figure is fired by one.
int	getSpeed()	Gets the speed of this rocket (nr of rounds between each move).
int	getSpeedCount()	Gets the current speed counter value.
Point	getStartingPoint()	Gets the starting point of this rocket.
java.util.ArrayList<Point>	getTargetLine()	Gets the line of points this rocket will move.
Point	getTargetPoint()	Gets the target point.
boolean	hasTarget()	Checks if this rocket has a target.
boolean	isActive()	Checks, if the rocket is active.
boolean	isDetonating()	Checks, if the rocket is currently deton
protected void	moveToTarget(AnimationInfo animation)	Moves to the target, in case the speedCounter has increased to the speed value.
boolean	onBePickedUp(Figure picker, AnimationInfo animation)	If INACTIVE, normal picking up, if ACTIVE, picker dies, if he has no explosion shielding, otherwise the pickers energy is reduced by 2 times this rockets energy, divided by the rocket shielding.
boolean	onBeUsed(Figure user, AnimationInfo animation)	Starts this rocket (if it is ok).
void	onEnemyKilled(Figure enemy, int round, DieReason reason, AnimationInfo animation)	Called, if the thing killed an enemy.
boolean	onHitItem(Item rammedItem, AnimationInfo animation)	Method called if this item moves and hits another item.
void	paintUpdate()	Increases the speed counter.
protected void	performFieldEffect(AnimationInfo animation)	Moves to the target if active and speedcount is reached.
void	setActive(boolean active)	Checks, if the rocket is active.
void	setDropPoint(Point p)	Sets the drop point
void	setNasty(boolean nasty)	Makes this rocket nasty (only targeting PlayerFigures).
protected void	setOwner(Figure owner)	Sets the owner.
void	setRocketeer(Item rocketeer)	Sets an ItemRocketeer, in case this figure is fired by one.
void	setSpeed(int speed)	Sets the speed of this rocket (nr of rounds between each move).
void	setTarget(int x, int y)	Sets the target point.
protected void	stopClip()	Stops the warning music.

Methods inherited from class com.starpoints.game.Item

affectsBlue, bePickedUp, beUsed, bombPlaced, createState, entersColor, explodes, gainsEnergy, gainsPermanentItem, gainsSlots, getDieReason, getDrawText, getItemRating, getName, getPickUpClip, getPickupText, getPointBonus, getRamPower, getUseClip, getUser, heatChanges, is3DItem, isAffectedByColor, isAvailableInEditor, isBomb, isRammed, isRocketTarget, isStunned, isWeapon, killedEnemy, losesEnergy, losesItem, losesPermanentItem, lostPermanentItem, onBeforeDie, onBeHitByItem, onDrop, onLevelFinished, pickesUpBomb, pickesUpExplosive, pickesUpItem, pointsChange, pointSumChanges, removeAfterLevel, retrieveState, rocketStarted, setUser, startsHovering, staysOnColor, toString, updateExplodingStatus, updateThing, usesItem, visibilityChanges

Methods inherited from class com.starpoints.game.Thing

addEnergy, addShielding, clearTexts, displayText, displayText, entersColor, equals, getColor, getEnergy, getEnergyMaxCount, getExplosionCounter, getField, getGame, getID, getImageName, getInnerColor, getInvulnerableRounds, getLevel, getMaxEnergy, getNextID, getOuterColor, getPoint, getShadowColor, getShield, getStateObject, getStatus, getText, getTextColor, getTextPaintCount, getX, getY, hashCode, invulnerable, isAffectedByBlack, isAffectedByGray, isDestroyed, isExploding, isInvulnerable, isOK, isShowingEnergyFx, onExplode, removeEnergy, retrieveState, setEnergy, setEnergyMaxCount, setGame, setMaxEnergy, setPoint, setStatus, staysOnColor, stepText, updateEnergy

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEBUG

protected boolean DEBUG

Debug flag.

OFF

protected static int OFF

Sound constant for no sound.

explosionDuration

protected int explosionDuration

Duration of detonation.

active

protected boolean active

State of the rocket (ACTIVE/INACTIVE)

dropPoint

protected Point dropPoint

The point on which the user fired the rocket.

detonating

protected boolean detonating

Flag, if currently detonating.

targetX

protected int targetX

Target x position.

targetY

protected int targetY

Target y position.

targetLine

protected java.util.ArrayList<Point> targetLine

The line of points to the target.

speed

protected int speed

Speed of the rocket.

owner

protected Figure owner

Owner after being picked up

loopName

protected java.lang.String loopName

The name of the sound clip to loop as rocket warning.

Constructor Detail

ItemRocket

public ItemRocket()

Creates a new ItemRocket.

Method Detail

getPainterClassname

public java.lang.String getPainterClassname()

Gets the fully qualified classname of the Painter to use for this item (in 2D game).

Overrides:

getPainterClassname in class Item

Returns:

"com.starpoints.painter.arena2D.PainterItemRocket"

getItemRating

public int getItemRating()

Returns an item value for ComputerFigures rating in the items category.

Overrides:

getItemRating in class Item

Returns:

energy * 12.

addStateProperties

protected void addStateProperties(ThingState state,
                                  AnimationInfo animation)

Adds properties necessary for rocket painting.

Overrides:

addStateProperties in class Thing

Parameters:

state - The state to add properties to.

animation - The current AnimationInfo.

getCategory

public ItemCategory getCategory()

Returns the items category.

Overrides:

getCategory in class Item

Returns:

the category

die

public void die(Thing source,
                DieReason reason,
                AnimationInfo animation)

Explodes, if INACTIVE, otherwise detonate.

Overrides:

die in class Item

Parameters:

source - The explosion source.

reason - The reason.

animation - The AnimationInfo.

getOwner

protected Figure getOwner()

Returns this rockets owner.

Returns:

The owner.

setOwner

protected void setOwner(Figure owner)

Sets the owner.

Parameters:

owner - the owner to set

detonate

public void detonate(Point p,
                     AnimationInfo animation)

Detonates with a radius depending on the rockets energy.

Parameters:

p - The detonation point.

animation - The AnimationInfo.

stopClip

protected void stopClip()

Stops the warning music.

onEnemyKilled

public void onEnemyKilled(Figure enemy,
                          int round,
                          DieReason reason,
                          AnimationInfo animation)

Called, if the thing killed an enemy.

Overrides:

onEnemyKilled in class Item

Parameters:

enemy - The killed enemy.

round - The round count.

reason - The reason.

animation - The AnimationInfo.

onBePickedUp

public boolean onBePickedUp(Figure picker,
                            AnimationInfo animation)

If INACTIVE, normal picking up, if ACTIVE, picker dies, if he has no explosion shielding, otherwise the pickers energy is reduced by 2 times this rockets energy, divided by the rocket shielding.

Overrides:

onBePickedUp in class Item

Parameters:

picker - The picker

animation - The AnimationInfo.

Returns:

true, if pickable, false otherwise.

onBeUsed

public boolean onBeUsed(Figure user,
                        AnimationInfo animation)

Starts this rocket (if it is ok). Calculates the line (list of points) to the target, calls the rocketStarted()- method on the field, and inserts the warning sound loop.

Overrides:

onBeUsed in class Item

Parameters:

user - The user who fires the rocket

animation - The AnimationInfo.

Returns:

true, if rocket is ok.

beFired

protected void beFired()

Sets the state to ACTIVE, calls the fields rocketStarted-method, and starts the sound fx.

getTargetPoint

public Point getTargetPoint()

Gets the target point.

Returns:

The target point.

performFieldEffect

protected void performFieldEffect(AnimationInfo animation)

Moves to the target if active and speedcount is reached.

Overrides:

performFieldEffect in class Item

Parameters:

animation - The AnimationInfo.

doSpecialUpdate

protected void doSpecialUpdate(AnimationInfo animation)

Recalculates the target and target line.

Overrides:

doSpecialUpdate in class Item

Parameters:

animation - The AnimationInfo.

paintUpdate

public void paintUpdate()

Increases the speed counter. Can be used for dummy rocket painting.

onHitItem

public boolean onHitItem(Item rammedItem,
                         AnimationInfo animation)

Method called if this item moves and hits another item.

Overrides:

onHitItem in class Item

Parameters:

rammedItem - The rammed item

animation - The AnimationInfo.

Returns:

true, if this item is placed on the rammed items point.

moveToTarget

protected void moveToTarget(AnimationInfo animation)

Moves to the target, in case the speedCounter has increased to the speed value.

Parameters:

animation - The AnimationInfo.

getNextPoint

protected Point getNextPoint(int xp,
                             int yp)

Gets the next point.

Parameters:

xp - The last x position.

yp - The last y position.

Returns:

The next point.

setDropPoint

public void setDropPoint(Point p)

Sets the drop point

Parameters:

p - The point.

calculateTargetLine

protected void calculateTargetLine()

Calculates the points to move over when fired.

getStartingPoint

public Point getStartingPoint()

Gets the starting point of this rocket.

Returns:

The point of the owner.

getTargetLine

public java.util.ArrayList<Point> getTargetLine()

Gets the line of points this rocket will move.

Returns:

The target line.

calculateTarget

public void calculateTarget(int xpos,
                            int ypos)

Calculates the rocket target using the given start coordinates.

Parameters:

xpos - X position.

ypos - Y position.

calculateTarget

public void calculateTarget(int xpos,
                            int ypos,
                            boolean checkInvisibility,
                            boolean checkECM)

Determines the nearest target figure and calculates the target line.

Parameters:

xpos - The xpos, the rocket is fired from.

ypos - The ypos, the rocket is fired from.

checkInvisibility - Flag, if invisible figures are no target.

checkECM - Flag, if an ECM system prevents the figures from being the target.

getNearestTarget

protected Thing getNearestTarget(int xpos,
                                 int ypos,
                                 boolean checkInvisibility,
                                 boolean checkECM)

Gets the nearest figure for target determination

Parameters:

xpos - The current x pos

ypos - The current y pos

checkInvisibility - Flag, if invisible figures should be ignored

checkECM - Flag, if figures with ECM system should be ignored.

Returns:

The nearest possible target

hasTarget

public boolean hasTarget()

Checks if this rocket has a target.

Returns:

true, if rocket has target.

isActive

public boolean isActive()

Checks, if the rocket is active.

Returns:

state == ACTIVE

setActive

public void setActive(boolean active)

Checks, if the rocket is active.

Parameters:

active - The new state.

getNextCalculatedPoint

protected Point getNextCalculatedPoint()

Gets the first point of the target line.

Returns:

The first point of the target line.

setTarget

public void setTarget(int x,
                      int y)

Sets the target point.

Parameters:

x - target x coordinate

y - target y coordinate

getSpeedCount

public int getSpeedCount()

Gets the current speed counter value.

Returns:

The current speed counter value.

getSpeed

public int getSpeed()

Gets the speed of this rocket (nr of rounds between each move).

Returns:

The speed of this rocket.

setSpeed

public void setSpeed(int speed)

Sets the speed of this rocket (nr of rounds between each move).

Parameters:

speed - The new speed of this rocket.

isDetonating

public boolean isDetonating()

Checks, if the rocket is currently deton

Returns:

true if detonating.

setNasty

public void setNasty(boolean nasty)

Makes this rocket nasty (only targeting PlayerFigures).

Parameters:

nasty - Flag, if rocket will be nasty or not.

getRocketeer

public Item getRocketeer()

Gets an ItemRocketeer, in case this figure is fired by one. Needed for targetline-calculation.

Returns:

The rocketeer.

setRocketeer

public void setRocketeer(Item rocketeer)

Sets an ItemRocketeer, in case this figure is fired by one. Needed for targetline-calculation. Should be called by items, that generate rockets during game.

Parameters:

rocketeer - The rocketeer.

getMoveAnimationLength

public int getMoveAnimationLength()

Method that can be overwritten by moving item subclasses, in case move animation should not last for default of 3 update cycles.

Overrides:

getMoveAnimationLength in class Item

Returns:

3 by default.