city.cs.engine

Class PolygonShape

java.lang.Object

city.cs.engine.Shape

city.cs.engine.PolygonShape

Direct Known Subclasses:

BoxShape

public class PolygonShape
extends Shape

A solid convex polygonal shape, to be used as the shape of a Fixture. A shape is convex if the line connecting any two points of the shape always lies within the shape.

A body with a concave shape can be constructed from two or more convex shapes.

A polygon must have at least 3 and no more than 8 vertices.

Constructor Summary

Constructors

Constructor and Description
PolygonShape(float... coords) Initialise a convex polygon given a list of its vertices, relative to the shape's origin.
PolygonShape(List<Vec2> vertices) Initialise a convex polygon given a list of its vertices, relative to the shape's origin.

Method Summary

Methods inherited from class java.lang.Object

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

Constructor Detail

PolygonShape

public PolygonShape(List<Vec2> vertices)

Initialise a convex polygon given a list of its vertices, relative to the shape's origin.

Parameters:

vertices - a list of vertex coordinates

Throws:

IllegalArgumentException - if the polygon is not convex

PolygonShape

public PolygonShape(float... coords)

Initialise a convex polygon given a list of its vertices, relative to the shape's origin. The vertices are specified by a list of numbers, with each consecutive pair in the list specifying a single vertex.

Parameters:

coords - the list of alternating x, y values for the vertex coordinates (in metres)

Throws:

IllegalArgumentException - if the polygon is not convex or if coords is empty or not of even length