Package megamek.common

Class HexTarget

java.lang.Object

megamek.common.HexTarget

All Implemented Interfaces:

Serializable, InGameObject, BTObject, Targetable

public class HexTarget
extends Object
implements Targetable

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
HexTarget(BoardLocation boardLocation, int nType)
HexTarget(Coords c, int nType)
HexTarget(Coords c, int boardId, int nType)
HexTarget(Coords c, Board board, 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.
HexTarget	getOriginalTarget()
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	getTargetLevel()
int	getTargetType()
static BoardLocation	idToLocation(int id)
boolean	isAirborne()
boolean	isAirborneVTOLorWIGE()
boolean	isEnemyOf(Entity other)	Determines if this target should be considered the enemy of the supplied player.
boolean	isIgniting()
boolean	isImmobile()	Returns true if the target is considered immobile (-4 to hit).
boolean	isOffBoard()
static int	locationToId(BoardLocation boardLocation)	Allows a 9999 x 999 map and board IDs up to 200
int	relHeight()
void	setId(int newId)	Sets this InGameObject's id.
void	setOriginalTarget(HexTarget target)
void	setOwnerId(int newOwnerId)	Sets the unique id of this InGameObject's owning player.
void	setTargetLevel(int targetLevel)
int	sideTable(Coords src)
int	sideTable(Coords src, boolean usePrior)
String	specificName()	Returns the specific name or type name of this unit/object.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, 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

HexTarget

public HexTarget(Coords c,
 int nType)

HexTarget

public HexTarget(Coords c,
 int boardId,
 int nType)

HexTarget

public HexTarget(Coords c,
 Board board,
 int nType)

HexTarget

public HexTarget(BoardLocation boardLocation,
 int nType)

Method Details

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

isIgniting

public boolean isIgniting()

locationToId

public static int locationToId(BoardLocation boardLocation)

Allows a 9999 x 999 map and board IDs up to 200

idToLocation

public static BoardLocation idToLocation(int id)

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

setOriginalTarget

public void setOriginalTarget(HexTarget target)

getOriginalTarget

public HexTarget getOriginalTarget()

getTargetLevel

public int getTargetLevel()

setTargetLevel

public void setTargetLevel(int targetLevel)

toString

public String toString()

Overrides:

toString in class Object