eu.printingin3d.javascad.vrl

Class Polygon

java.lang.Object

eu.printingin3d.javascad.vrl.Polygon

public final class Polygon
extends Object

Represents a convex polygon. A polygon is represented by its points which should be on the same plane (not tested, but guaranteed by the used algorithms), its normal (calculated from the points), its color and its distance from the origin.

Method Summary

Modifier and Type	Method and Description
Polygon	flip() Flips this polygon.
static Polygon	fromPolygons(List<Coords3d> vertices, Color color) Creates a new polygon that consists of the specified vertices.
protected List<Coords3d>	getVertices()
void	splitPolygon(Polygon polygon, List<Polygon> coplanarFront, List<Polygon> coplanarBack, List<Polygon> front, List<Polygon> back) Splits a Polygon by this plane if needed.
List<Facet>	toFacets() Converts this polygon to triangles.
Polygon	transformed(ITransformation transform) Returns a transformed copy of this polygon.

Methods inherited from class java.lang.Object

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

Method Detail

fromPolygons

public static Polygon fromPolygons(List<Coords3d> vertices,
                                   Color color)

Creates a new polygon that consists of the specified vertices. Note: the vertices used to initialize a polygon must be coplanar and form a convex loop.

Parameters:

vertices - polygon vertices

color - the color of the polygon

Returns:

a new polygon that consists of the specified vertices

flip

public Polygon flip()

Flips this polygon.

Returns:

a new polygon with the vertices in reversed order

toFacets

public List<Facet> toFacets()

Converts this polygon to triangles.

Returns:

a list of triangles

getVertices

protected List<Coords3d> getVertices()

transformed

public Polygon transformed(ITransformation transform)

Returns a transformed copy of this polygon. Note: if the applied transformation performs a mirror operation the vertex order of this polygon is reversed. Note: this polygon is not modified

Parameters:

transform - the transformation to apply

Returns:

a transformed copy of this polygon

splitPolygon

public void splitPolygon(Polygon polygon,
                         List<Polygon> coplanarFront,
                         List<Polygon> coplanarBack,
                         List<Polygon> front,
                         List<Polygon> back)

Splits a Polygon by this plane if needed. After that it puts the polygons or the polygon fragments in the appropriate lists (front, back). Coplanar polygons go into either coplanarFront, coplanarBack depending on their orientation with respect to this plane. Polygons in front or back of this plane go into either front or back.

Parameters:

polygon - polygon to split

coplanarFront - "coplanar front" polygons

coplanarBack - "coplanar back" polygons

front - front polygons

back - back polgons