eu.printingin3d.javascad.coords

Class Triangle3d

java.lang.Object

eu.printingin3d.javascad.coords.Triangle3d

public class Triangle3d
extends Object

An implementation of a 3D triangle. It is used by the OpenSCAD rendering. This class is also used by the Polyhedron class as input.

Author:

ivivan

Constructor Summary

Constructors

Constructor and Description
Triangle3d(Coords3d point1, Coords3d point2, Coords3d point3) Created the triangle by defining the three corner.

Method Summary

Modifier and Type	Method and Description
static Triangle3d	fromByteArray(ByteBuffer bb) Reads the given byte buffer and creates a triangle based on its content.
List<Coords3d>	getPoints() Returns with the corners of the triangle as a list.
static List<Triangle3d>	getTriangles(Coords3d... coords) Creates a list of triangles which covers the polygon defined by the given list of coordinates.
static List<Triangle3d>	getTriangles(List<Coords3d> coords) Creates a list of triangles which covers the polygon defined by the given list of coordinates.
void	toByteArray(ByteBuffer byteBuffer) Writes the byte array representation of this triangle to the given buffer.
String	toTriangleString(List<Coords3d> coords) Renders the triangle as is used by OpenSCAD: three index of a list of points - that's why this method requires a coordinate list as a parameter.

Methods inherited from class java.lang.Object

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

Constructor Detail

Triangle3d

public Triangle3d(Coords3d point1,
                  Coords3d point2,
                  Coords3d point3)
           throws IllegalValueException

Created the triangle by defining the three corner.

Parameters:

point1 - the first corner

point2 - the second corner

point3 - the third corner

Throws:

IllegalValueException - if any of the parameters is null

Method Detail

fromByteArray

public static Triangle3d fromByteArray(ByteBuffer bb)

Reads the given byte buffer and creates a triangle based on its content. It is the inverse operation of toByteArray(ByteBuffer).

Parameters:

bb - the byte buffer the content will be read from

Returns:

a triangle created based on the content of the buffer

getTriangles

public static List<Triangle3d> getTriangles(List<Coords3d> coords)

Creates a list of triangles which covers the polygon defined by the given list of coordinates. The given list should contain at least three coordinates.

Parameters:

coords - the list of coordinates used to generate the triangles

Returns:

the triangles

Throws:

IllegalValueException - if the given coords list is null or the list contains less than three coordinates

getTriangles

public static List<Triangle3d> getTriangles(Coords3d... coords)

Creates a list of triangles which covers the polygon defined by the given list of coordinates. The given list should contain at least three coordinates.

Parameters:

coords - the list of coordinates used to generate the triangles

Returns:

the triangles

Throws:

IllegalValueException - if the given coords list is null or the list contains less than three coordinates

getPoints

public List<Coords3d> getPoints()

Returns with the corners of the triangle as a list. It always contains three points in an order as it was given in the constructor.

Returns:

the list of the corners

toTriangleString

public String toTriangleString(List<Coords3d> coords)
                        throws IllegalValueException

Renders the triangle as is used by OpenSCAD: three index of a list of points - that's why this method requires a coordinate list as a parameter.

Parameters:

coords - the list of coordinates which is used to determine the indexes

Returns:

the OpenSCAD version of the triangle

Throws:

IllegalValueException - if any of the three corners of the triangle cannot be found in the given list

toByteArray

public void toByteArray(ByteBuffer byteBuffer)

Writes the byte array representation of this triangle to the given buffer.

Parameters:

byteBuffer - the byte buffer the representation of this vertex will be written to