dev.roanh.convexmerger.game

Class ConvexObject

java.lang.Object

dev.roanh.convexmerger.animation.RenderableObject

dev.roanh.convexmerger.game.ConvexObject

All Implemented Interfaces:

Identity, java.io.Serializable

public class ConvexObject
extends RenderableObject
implements Identity, java.io.Serializable

Defines a convex object shown in the game the points on the boundary of the object are given in counter clockwise order.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private int	id The ID for this object.
private Player	owner The player that owns this object.
private java.util.List<java.awt.geom.Point2D>	points The points that make up this convex object, starting with the left most point in counter clockwise order.
private static long	serialVersionUID Serial ID.
private java.awt.geom.Path2D	shape The shape of this convex object.

Constructor Summary

Constructors

Constructor and Description
ConvexObject(double x1, double y1, double x2, double y2, double x3, double y3, double x4, double y4) Constructs a new convex object defined by the given four points.
ConvexObject(int x1, int y1, int x2, int y2, int x3, int y3) Constructs a new convex object defined by the given three points.
ConvexObject(int x1, int y1, int x2, int y2, int x3, int y3, int x4, int y4) Constructs a new convex object defined by the given four points.
ConvexObject(java.util.List<java.awt.geom.Point2D> data) Constructs a new convex object defined by the given list of points.

Method Summary

Modifier and Type	Method and Description
boolean	canClaim() Checks if this objects is unowned and thus claimable by any player.
private void	constructShape() Constructs the shape object for the bounds of this object.
boolean	contains(ConvexObject other) Checks if the given convex object is fully contained within this convex object.
boolean	contains(double x, double y) Checks if the given point is contained in this convex object.
boolean	equals(java.lang.Object other)
double	getArea() Computes the area of this convex object.
java.awt.geom.Point2D	getCentroid() Computes the centroid of this convex object.
int	getID() Gets the ID of this entity.
Player	getOwner() Gets the player that owns this object.
java.util.List<java.awt.geom.Point2D>	getPoints() Gets the points that define this convex object.
java.awt.geom.Path2D	getShape() Gets a closed path representing the shape of this convex object.
int	hashCode()
boolean	intersects(ConvexObject other) Checks if the given convex object intersects this convex object.
boolean	intersects(java.awt.geom.Point2D a, java.awt.geom.Point2D b) Checks if this convex object intersects the line segment defined by the given end points.
boolean	isOwned() Checks if this object is owned by a player.
boolean	isOwnedBy(Player player) Tests if this convex object is owned by the given player.
ConvexObject	merge(ConvexObject other) Merges this object with the given object.
ConvexObject	merge(GameState state, ConvexObject other) Attempts to merge this object with the given object while checking that the boundary of the resulting merged object does not intersect any other objects in the given game state.
ConvexObject	merge(GameState state, ConvexObject other, boolean saveSegments) Attempts to merge this object with the given object while checking that the boundary of the resulting merged object does not intersect any other objects in the given game state.
void	render(java.awt.Graphics2D g) Renders this object.
void	scale(double factor) Scales this object by the given scaling factor.
void	setID(int id) Sets the ID of this entity.
void	setOwner(Player player) Sets the player that owns this object.
java.lang.String	toString()

Methods inherited from class dev.roanh.convexmerger.animation.RenderableObject

getAnimation, hasAnimation, renderOrAnimate, runAnimation, setAnimation

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

Serial ID.

See Also:

Constant Field Values

id

private int id

The ID for this object.

points

private java.util.List<java.awt.geom.Point2D> points

The points that make up this convex object, starting with the left most point in counter clockwise order.

shape

private java.awt.geom.Path2D shape

The shape of this convex object.

owner

private transient Player owner

The player that owns this object.

Constructor Detail

ConvexObject

public ConvexObject(int x1,
                    int y1,
                    int x2,
                    int y2,
                    int x3,
                    int y3,
                    int x4,
                    int y4)

Constructs a new convex object defined by the given four points.

Parameters:

x1 - The x coordinate of the first point.

y1 - The y coordinate of the first point.

x2 - The x coordinate of the second point.

y2 - The y coordinate of the second point.

x3 - The x coordinate of the third point.

y3 - The y coordinate of the third point.

x4 - The x coordinate of the fourth point.

y4 - The y coordinate of the fourth point.

ConvexObject

public ConvexObject(double x1,
                    double y1,
                    double x2,
                    double y2,
                    double x3,
                    double y3,
                    double x4,
                    double y4)

Constructs a new convex object defined by the given four points.

Parameters:

x1 - The x coordinate of the first point.

y1 - The y coordinate of the first point.

x2 - The x coordinate of the second point.

y2 - The y coordinate of the second point.

x3 - The x coordinate of the third point.

y3 - The y coordinate of the third point.

x4 - The x coordinate of the fourth point.

y4 - The y coordinate of the fourth point.

ConvexObject

public ConvexObject(int x1,
                    int y1,
                    int x2,
                    int y2,
                    int x3,
                    int y3)

Constructs a new convex object defined by the given three points.

Parameters:

x1 - The x coordinate of the first point.

y1 - The y coordinate of the first point.

x2 - The x coordinate of the second point.

y2 - The y coordinate of the second point.

x3 - The x coordinate of the third point.

y3 - The y coordinate of the third point.

ConvexObject

public ConvexObject(java.util.List<java.awt.geom.Point2D> data)

Constructs a new convex object defined by the given list of points. The points are assumed to define a valid convex polygon in counter clockwise order with the first point being the left most point.

Parameters:

data - The point data.

Method Detail

constructShape

private void constructShape()

Constructs the shape object for the bounds of this object.

getShape

public java.awt.geom.Path2D getShape()

Gets a closed path representing the shape of this convex object. The shape is guaranteed to be convex.

Returns:

The shape of this convex object.

getPoints

public java.util.List<java.awt.geom.Point2D> getPoints()

Gets the points that define this convex object. The points define the convex polygon in counter clockwise order and the first point is the leftmost point.

Returns:

The points that define this convex object.

getOwner

public Player getOwner()

Gets the player that owns this object.

Returns:

The player that owns this object or null if this object is currently unowned.

See Also:

isOwned()

isOwned

public boolean isOwned()

Checks if this object is owned by a player.

Returns:

True if this object is owned by a player.

See Also:

getOwner()

setOwner

public void setOwner(Player player)

Sets the player that owns this object.

Parameters:

player - The player to own this object.

contains

public boolean contains(double x,
                        double y)

Checks if the given point is contained in this convex object.

Parameters:

x - The x coordinate of the point to test.

y - The y coordinate of the point to test.

Returns:

True if the given point is contained in this object.

merge

public ConvexObject merge(ConvexObject other)

Merges this object with the given object.

Parameters:

other - The object to merge with.

Returns:

The resulting merged convex object.

See Also:

merge(GameState, ConvexObject)

merge

public ConvexObject merge(GameState state,
                          ConvexObject other)

Attempts to merge this object with the given object while checking that the boundary of the resulting merged object does not intersect any other objects in the given game state.

Parameters:

state - The game state to check with if the resulting object has any intersections. Can be null to skip this check.

other - The object to merge with.

Returns:

The resulting merged convex object.

See Also:

merge(ConvexObject)

merge

public ConvexObject merge(GameState state,
                          ConvexObject other,
                          boolean saveSegments)
                   throws java.lang.InterruptedException

Attempts to merge this object with the given object while checking that the boundary of the resulting merged object does not intersect any other objects in the given game state.

Parameters:

state - The game state to check with if the resulting object has any intersections. Can be null to skip this check.

other - The object to merge with.

saveSegments - True if the merge lines for the merge should be added to the game state.

Returns:

The resulting merged convex object.

Throws:

java.lang.InterruptedException - When the player was interrupted while making its move. Signalling that the game was aborted.

See Also:

merge(ConvexObject)

intersects

public boolean intersects(java.awt.geom.Point2D a,
                          java.awt.geom.Point2D b)

Checks if this convex object intersects the line segment defined by the given end points.

Parameters:

a - The first endpoint of the line segment.

b - The second endpoint of the line segment.

Returns:

True if this object intersects the given line segment.

contains

public boolean contains(ConvexObject other)

Checks if the given convex object is fully contained within this convex object.

Parameters:

other - The object to check.

Returns:

True if this convex object contains the other given convex object.

intersects

public boolean intersects(ConvexObject other)

Checks if the given convex object intersects this convex object.

Parameters:

other - The object to check for intersection with.

Returns:

True if this convex object intersects the other given convex object.

getArea

public double getArea()

Computes the area of this convex object.

Returns:

The area for this convex object.

isOwnedBy

public boolean isOwnedBy(Player player)

Tests if this convex object is owned by the given player.

Parameters:

player - The player to check.

Returns:

True if the given player owns this object.

getCentroid

public java.awt.geom.Point2D getCentroid()

Computes the centroid of this convex object.

Returns:

The centroid of this convex object.

canClaim

public boolean canClaim()

Checks if this objects is unowned and thus claimable by any player.

Returns:

True if this object can be claimed.

scale

public void scale(double factor)

Scales this object by the given scaling factor.

Parameters:

factor - The scaling factor.

render

public void render(java.awt.Graphics2D g)

Description copied from class: RenderableObject

Renders this object.

Specified by:

render in class RenderableObject

Parameters:

g - The graphics context to use.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getID

public int getID()

Description copied from interface: Identity

Gets the ID of this entity.

Specified by:

getID in interface Identity

Returns:

The ID of this entity.

setID

public void setID(int id)

Description copied from interface: Identity

Sets the ID of this entity.

Specified by:

setID in interface Identity

Parameters:

id - The new ID of this entity, must be unique.