APIdia Launch Partner
Top Description Fields Constructors Methods
com.badlogic.gdx.math

public Class Circle

extends Object
implements Serializable, Shape2D
Class Inheritance
All Implemented Interfaces
com.badlogic.gdx.math.Shape2D, java.io.Serializable
Imports
java.io.Serializable, com.badlogic.gdx.utils.NumberUtils

A convenient 2D circle class.
Author
mzechner

Field Summary

Modifier and TypeField and Description
public float
public float
x

public float
y

Constructor Summary

AccessConstructor and Description
public
Circle()

Constructs a new circle with all values set to zero

public
Circle(float
X coordinate of the center of the circle
x
,
float
Y coordinate of the center of the circle
y
,
float
The radius of the circle
radius
)

Constructs a new circle with the given X and Y coordinates and the given radius.

public
Circle(Vector2
The position Vector2 of the center of the circle
position
,
float
The radius
radius
)

Constructs a new circle using a given Vector2 that contains the desired X and Y coordinates, and a given radius.

public
Circle(Circle
The circle to construct a copy of.
circle
)

Copy constructor

public
Circle(Vector2
The center of the new circle
center
,
Vector2
Any point on the edge of the given circle
edge
)

Creates a new Circle in terms of its center and a point on its edge.

Method Summary

Modifier and TypeMethod and Description
public float
area()

Returns: The area of this circle (as MathUtils#PI * radius * radius).

public float
circumference()

Returns: The circumference of this circle (as 2 * MathUtils#PI2) * radius

public boolean

Returns:

true if this circle contains the given point.
contains
(float
X coordinate
x
,
float
Y coordinate
y
)

Implements com.badlogic.gdx.math.Shape2D.contains.

Checks whether or not this circle contains a given point.

public boolean

Returns:

true if this circle contains this point; false otherwise.
contains
(Vector2
The Vector2 that contains the point coordinates.
point
)

Implements com.badlogic.gdx.math.Shape2D.contains.

Checks whether or not this circle contains a given point.

public boolean
contains(Circle
the other Circle
c
)

Returns: whether this circle contains the other circle.

public boolean
equals(Object o)

Overrides java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

public int
hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code value for this object.

public boolean
overlaps(Circle
the other Circle
c
)

Returns: whether this circle overlaps the other circle.

public void
set(float
X coordinate of the center of the circle
x
,
float
Y coordinate of the center of the circle
y
,
float
Circle radius
radius
)

Sets a new location and radius for this circle.

public void
set(Vector2
Position Vector2 for this circle.
position
,
float
Circle radius
radius
)

Sets a new location and radius for this circle.

public void
set(Circle
The circle to copy the position and radius of.
circle
)

Sets a new location and radius for this circle, based upon another circle.

public void
set(Vector2
The new center of the circle
center
,
Vector2
Any point on the edge of the given circle
edge
)

Sets this Circle's values in terms of its center and a point on its edge.

public void
setPosition(Vector2
The position vector
position
)

Sets the x and y-coordinates of circle center from vector

public void
setPosition(float
The x-coordinate
x
,
float
The y-coordinate
y
)

Sets the x and y-coordinates of circle center

public void
setRadius(float
The radius
radius
)

Sets the radius of circle

public void
setX(float
The x-coordinate
x
)

Sets the x-coordinate of circle center

public void
setY(float
The y-coordinate
y
)

Sets the y-coordinate of circle center

public String
toString()

Overrides java.lang.Object.toString.

Returns a String representation of this Circle of the form x,y,radius.

Inherited from java.lang.Object:
clonefinalizegetClassnotifynotifyAllwaitwaitwait

Field Detail

radiusback to summary
public float radius
xback to summary
public float x
yback to summary
public float y

Constructor Detail

Circleback to summary
public Circle()

Constructs a new circle with all values set to zero

Circleback to summary
public Circle(float x, float y, float radius)

Constructs a new circle with the given X and Y coordinates and the given radius.

Parameters
x:float

X coordinate of the center of the circle

y:float

Y coordinate of the center of the circle

radius:float

The radius of the circle

Circleback to summary
public Circle(Vector2 position, float radius)

Constructs a new circle using a given Vector2 that contains the desired X and Y coordinates, and a given radius.

Parameters
position:Vector2

The position Vector2 of the center of the circle

radius:float

The radius

Circleback to summary
public Circle(Circle circle)

Copy constructor

Parameters
circle:Circle

The circle to construct a copy of.

Circleback to summary
public Circle(Vector2 center, Vector2 edge)

Creates a new Circle in terms of its center and a point on its edge.

Parameters
center:Vector2

The center of the new circle

edge:Vector2

Any point on the edge of the given circle

Method Detail

areaback to summary
public float area()
Returns:float

The area of this circle (as MathUtils#PI * radius * radius).

circumferenceback to summary
public float circumference()
Returns:float

The circumference of this circle (as 2 * MathUtils#PI2) * radius

containsback to summary
public boolean contains(float x, float y)

Implements com.badlogic.gdx.math.Shape2D.contains.

Checks whether or not this circle contains a given point.

Parameters
x:float

X coordinate

y:float

Y coordinate

Returns:boolean

true if this circle contains the given point.

containsback to summary
public boolean contains(Vector2 point)

Implements com.badlogic.gdx.math.Shape2D.contains.

Checks whether or not this circle contains a given point.

Parameters
point:Vector2

The Vector2 that contains the point coordinates.

Returns:boolean

true if this circle contains this point; false otherwise.

containsback to summary
public boolean contains(Circle c)
Parameters
c:Circle

the other Circle

Returns:boolean

whether this circle contains the other circle.

equalsback to summary
public boolean equals(Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Annotations
@Override
hashCodeback to summary
public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Annotations
@Override
overlapsback to summary
public boolean overlaps(Circle c)
Parameters
c:Circle

the other Circle

Returns:boolean

whether this circle overlaps the other circle.

setback to summary
public void set(float x, float y, float radius)

Sets a new location and radius for this circle.

Parameters
x:float

X coordinate of the center of the circle

y:float

Y coordinate of the center of the circle

radius:float

Circle radius

setback to summary
public void set(Vector2 position, float radius)

Sets a new location and radius for this circle.

Parameters
position:Vector2

Position Vector2 for this circle.

radius:float

Circle radius

setback to summary
public void set(Circle circle)

Sets a new location and radius for this circle, based upon another circle.

Parameters
circle:Circle

The circle to copy the position and radius of.

setback to summary
public void set(Vector2 center, Vector2 edge)

Sets this Circle's values in terms of its center and a point on its edge.

Parameters
center:Vector2

The new center of the circle

edge:Vector2

Any point on the edge of the given circle

setPositionback to summary
public void setPosition(Vector2 position)

Sets the x and y-coordinates of circle center from vector

Parameters
position:Vector2

The position vector

setPositionback to summary
public void setPosition(float x, float y)

Sets the x and y-coordinates of circle center

Parameters
x:float

The x-coordinate

y:float

The y-coordinate

setRadiusback to summary
public void setRadius(float radius)

Sets the radius of circle

Parameters
radius:float

The radius

setXback to summary
public void setX(float x)

Sets the x-coordinate of circle center

Parameters
x:float

The x-coordinate

setYback to summary
public void setY(float y)

Sets the y-coordinate of circle center

Parameters
y:float

The y-coordinate

toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Returns a String representation of this Circle of the form x,y,radius.

Annotations
@Override