Package megamek.common.units

Class BuildingTarget

java.lang.Object

megamek.common.units.BuildingTarget

All Implemented Interfaces:

Serializable, InGameObject, BTObject, Targetable

public class BuildingTarget
extends Object
implements Targetable

This class represents a single, targetable hex of a building. The building itself may occupy multiple hexes.

See Also:

• Serialized Form

Field Summary

Fields inherited from interface megamek.common.units.BTObject

NONE

Fields inherited from interface megamek.common.units.Targetable

TYPE_BLDG_IGNITE, TYPE_BLDG_TAG, TYPE_BUILDING, TYPE_ENTITY, TYPE_FLARE_DELIVER, TYPE_FUEL_TANK, TYPE_FUEL_TANK_IGNITE, TYPE_HEX_AERO_BOMB, TYPE_HEX_ARTILLERY, TYPE_HEX_BOMB, TYPE_HEX_CLEAR, TYPE_HEX_EXTINGUISH, TYPE_HEX_IGNITE, TYPE_HEX_SCREEN, TYPE_HEX_TAG, TYPE_I_NARC_POD, TYPE_MINEFIELD_CLEAR, TYPE_MINEFIELD_DELIVER, TYPE_SATURATION, TYPE_SEARCHLIGHT

Constructor Summary

Constructors

Constructor	Description
BuildingTarget(Coords coords, Board board, boolean ignite)	Target a single hex of a building.
BuildingTarget(Coords coords, Board board, int nType)	Target a single hex of a building.
BuildingTarget(Game game, BoardLocation boardLocation, int nType)

Method Summary

Modifier and Type	Method	Description
String	generalName()	Returns the general name or type name of this unit/object.
int	getAltitude()
int	getBoardId()
String	getDisplayName()
int	getElevation()	Returns the elevation of this target, relative to the position Hex's surface
int	getHeight()	Returns the height of the target, that is, how many levels above its elevation it is for LOS purposes.
int	getId()	Returns this InGameObject's id.
int	getOwnerId()	Returns the unique id of this InGameObject's owning player.
Coords	getPosition()
Map<Integer,Coords>	getSecondaryPositions()
int	getStrength()	Returns the current (remaining) battle strength of this unit or object.
int	getTargetType()
protected void	init(Coords coords, Board board, int nType)	Initialize this object from the input.
boolean	isAirborne()
boolean	isAirborneVTOLorWIGE()
boolean	isEnemyOf(Entity other)	Determines if this target should be considered the enemy of the supplied player.
boolean	isImmobile()	Returns true if the target is considered immobile (-4 to hit).
boolean	isOffBoard()
int	relHeight()
void	setId(int newId)	Sets this InGameObject's id.
void	setOwnerId(int newOwnerId)	Sets the unique id of this InGameObject's owning player.
int	sideTable(Coords src)
int	sideTable(Coords src, boolean usePrior)
String	specificName()	Returns the specific name or type name of this unit/object.

Methods inherited from class java.lang.Object

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

Methods inherited from interface megamek.common.units.BTObject

getFluffImage, getIcon, hasAerodyneSpheroidDistinction, isAero, isAerodyne, isAerospace, isAerospaceFighter, isAerospaceSV, isBattleArmor, isBattlefieldSupportAsset, isBattleMek, isCarryableObject, isCombatVehicle, isConventionalFighter, isConventionalInfantry, isDropShip, isFighter, isFixedWingSupport, isGround, isHandheldWeapon, isIndustrialMek, isInfantry, isJumpShip, isLargeAerospace, isMek, isObjectiveMarker, isProtoMek, isQuadMek, isSingleUnit, isSmallCraft, isSpaceStation, isSpheroid, isSupportVehicle, isTripodMek, isUnitGroup, isVehicle, isWarShip

Methods inherited from interface megamek.common.game.InGameObject

countForStrengthSum, hasOwner

Methods inherited from interface megamek.common.units.Targetable

equals, getBoardLocation, hashCode, isBomber, isBracing, isBuildingEntityOrGunEmplacement, isHexBeingBombed, isOnBoard, tracksHeat

Constructor Details

BuildingTarget

public BuildingTarget(Coords coords,
 Board board,
 int nType)

Target a single hex of a building.

Parameters:

coords - - the Coords of the hex being targeted.

board - - the game's Board object.

nType - - an int value that indicates whether the player is attempting to set the building on fire, or not.

Throws:

IllegalArgumentException - will be thrown if the given coordinates do not contain a building.

BuildingTarget

public BuildingTarget(Game game,
 BoardLocation boardLocation,
 int nType)

BuildingTarget

public BuildingTarget(Coords coords,
 Board board,
 boolean ignite)

Target a single hex of a building.

Parameters:

coords - - the Coords of the hex being targeted.

board - - the game's Board object.

ignite - - a boolean flag that indicates whether the player is attempting to set the building on fire, or not.

Throws:

IllegalArgumentException - will be thrown if the given coordinates do not contain a building.

Method Details

init

protected void init(Coords coords,
 Board board,
 int nType)

Initialize this object from the input.

Parameters:

coords - - the Coords of the hex being targeted.

board - - the game's Board object.

nType - the target type

Throws:

IllegalArgumentException - will be thrown if the given coordinates do not contain a building.

getBoardId

public int getBoardId()

Specified by:

getBoardId in interface Targetable

Returns:

The board ID of the board this targetable is on. This defaults to 0 so that any code that doesn't support multiple boards yet safely points to the first (and only) board; should eventually default to -1

getTargetType

public int getTargetType()

Specified by:

getTargetType in interface Targetable

getId

public int getId()

Description copied from interface: InGameObject

Returns this InGameObject's id. The id must be unique to this InGameObject within the current game. equals() must return true for two InGameObject objects with the same id.

Specified by:

getId in interface InGameObject

Returns:

The game-unique id of this InGameObject (Entity, AlphaStrikeElement etc.)

setId

public void setId(int newId)

Description copied from interface: InGameObject

Sets this InGameObject's id. The id must be unique to this InGameObject within the current game. equals() must return true for two InGameObject objects with the same id.

Specified by:

setId in interface InGameObject

Parameters:

newId - The game-unique id of this InGameObject (Entity, AlphaStrikeElement etc.)

getOwnerId

public int getOwnerId()

Description copied from interface: InGameObject

Returns the unique id of this InGameObject's owning player. This id may be Player.NONE.

Specified by:

getOwnerId in interface InGameObject

Returns:

The player id of the owner of this InGameObject.

setOwnerId

public void setOwnerId(int newOwnerId)

Description copied from interface: InGameObject

Sets the unique id of this InGameObject's owning player. This id may be Player.NONE.

Specified by:

setOwnerId in interface InGameObject

Parameters:

newOwnerId - The player id of the owner of this InGameObject.

getStrength

public int getStrength()

Description copied from interface: InGameObject

Returns the current (remaining) battle strength of this unit or object. For combat units, this is the battle value (BV) or the point value (PV).

Specified by:

getStrength in interface InGameObject

Returns:

The current battle strength (BV/PV)

getPosition

public Coords getPosition()

Specified by:

getPosition in interface Targetable

Returns:

the coordinates of the hex containing the target

getSecondaryPositions

public Map<Integer,Coords> getSecondaryPositions()

Specified by:

getSecondaryPositions in interface Targetable

relHeight

public int relHeight()

Specified by:

relHeight in interface Targetable

Returns:

elevation of the top (e.g. torso) of the target relative to surface

getHeight

public int getHeight()

Description copied from interface: Targetable

Returns the height of the target, that is, how many levels above its elevation it is for LOS purposes.

Specified by:

getHeight in interface Targetable

Returns:

height of the target in elevation levels

getElevation

public int getElevation()

Description copied from interface: Targetable

Returns the elevation of this target, relative to the position Hex's surface

Specified by:

getElevation in interface Targetable

Returns:

elevation of the bottom (e.g. legs) of the target relative to surface

isImmobile

public boolean isImmobile()

Description copied from interface: Targetable

Returns true if the target is considered immobile (-4 to hit). If this is a game unit, implementations should check the status of the unit (shutdown, damage) and also the status of the crew (unconscious) if any.

Specified by:

isImmobile in interface Targetable

Returns:

True if the target is considered immobile

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface Targetable

Returns:

name of the target for ui purposes

sideTable

public int sideTable(Coords src)

Specified by:

sideTable in interface Targetable

Returns:

side hit from location

sideTable

public int sideTable(Coords src,
 boolean usePrior)

Specified by:

sideTable in interface Targetable

Returns:

side hit from location

isOffBoard

public boolean isOffBoard()

Specified by:

isOffBoard in interface Targetable

Returns:

if this is off the board

isAirborne

public boolean isAirborne()

Specified by:

isAirborne in interface Targetable

Returns:

Is the entity airborne in the fashion of an aerospace unit? Does not include VTOL movement (see Targetable.isAirborneVTOLorWIGE()

isAirborneVTOLorWIGE

public boolean isAirborneVTOLorWIGE()

Specified by:

isAirborneVTOLorWIGE in interface Targetable

Returns:

is the entity airborne in the fashion of a VTOL Not used for aerospace units, see Targetable.isAirborne()

getAltitude

public int getAltitude()

Specified by:

getAltitude in interface Targetable

Returns:

altitude of target

isEnemyOf

public boolean isEnemyOf(Entity other)

Description copied from interface: Targetable

Determines if this target should be considered the enemy of the supplied player. Targets that aren't owned by any player, such as buildings or terrain, are always considered enemies, since this will most often be used to determine if something is valid to be shot at.

Specified by:

isEnemyOf in interface Targetable

generalName

public String generalName()

Description copied from interface: BTObject

Returns the general name or type name of this unit/object. For standard individual units, this is the chassis. For other types of units or objects this can be the full designation or a general part of the designation. Much like the chassis, this can be much more narrow than the general type of unit ("Mek").

The general name should not be empty and not return null. Return the chassis in Entity and AlphaStrikeElement.

Specified by:

generalName in interface BTObject

Returns:

The general name / chassis

specificName

public String specificName()

Description copied from interface: BTObject

Returns the specific name or type name of this unit/object. For standard individual units, this is the model. For other types of units or objects this can be a part of the designation, or empty.

The specific name should not return null. Return the model in Entity and AlphaStrikeElement.

Specified by:

specificName in interface BTObject

Returns:

The specific name / model