Package eu.mihosoft.vrl.v3d

Class Plane

java.lang.Object

eu.mihosoft.vrl.v3d.Plane

public class Plane
extends Object

Represents a plane in 3D space.

Author:

Michael Hoffer <info@michaelhoffer.de>

Field Summary

Fields

Modifier and Type	Field	Description
double	dist	Distance to origin.
static final double	EPSILON	EPSILON is the tolerance used by splitPolygon(eu.mihosoft.vrl.v3d.Polygon, java.util.List, java.util.List, java.util.List, java.util.List) to decide if a point is on the plane.
Vector3d	normal	Normal vector.
static final Plane	XY_PLANE	XY plane.
static final Plane	XZ_PLANE	XZ plane.
static final Plane	YZ_PLANE	YZ plane.

Constructor Summary

Constructors

Constructor	Description
Plane(Vector3d normal, double dist)	Constructor.

Method Summary

Modifier and Type	Method	Description
Plane	clone()
static Plane	createFromPoints(Vector3d a, Vector3d b, Vector3d c)	Creates a plane defined by the the specified points.
void	flip()	Flips this plane.
void	splitPolygon(Polygon polygon, List<Polygon> coplanarFront, List<Polygon> coplanarBack, List<Polygon> front, List<Polygon> back)	Splits a Polygon by this plane if needed.

Methods inherited from class java.lang.Object

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

Field Details

EPSILON

public static final double EPSILON

EPSILON is the tolerance used by splitPolygon(eu.mihosoft.vrl.v3d.Polygon, java.util.List, java.util.List, java.util.List, java.util.List) to decide if a point is on the plane.

See Also:

• Constant Field Values

XY_PLANE

public static final Plane XY_PLANE

XY plane.

XZ_PLANE

public static final Plane XZ_PLANE

XZ plane.

YZ_PLANE

public static final Plane YZ_PLANE

YZ plane.

normal

public Vector3d normal

Normal vector.

dist

public double dist

Distance to origin.

Constructor Details

Plane

public Plane(Vector3d normal,
 double dist)

Constructor. Creates a new plane defined by its normal vector and the distance to the origin.

Parameters:

normal - plane normal

dist - distance from origin

Method Details

createFromPoints

public static Plane createFromPoints(Vector3d a,
 Vector3d b,
 Vector3d c)

Creates a plane defined by the the specified points.

Parameters:

a - first point

b - second point

c - third point

Returns:

a plane

clone

public Plane clone()

Overrides:

clone in class Object

flip

public void flip()

Flips this plane.

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