org.apache.commons.geometry.io.euclidean.threed

Interface FacetDefinition

All Known Implementing Classes:

BinaryStlFacetDefinition, SimpleFacetDefinition

public interface FacetDefinition

Interface containing values (vertices and optional normal) used to define a convex, finite polygon in 3D space. In contrast to the similar ConvexPolygon3D class, no guarantees are made regarding the geometric validity of the data. For example, instances may contain vertices that do not lie in the same plane or have normals that are not unit length or point in an unexpected direction. This is lack of validation is intentional, since a primary purpose of this interface is to allow access to raw, possibly invalid, geometric data from input sources.

See Also:

ConvexPolygon3D, FacetDefinitions

Method Summary

Modifier and Type	Method and Description
Vector3D	getNormal() Get the normal defined for the facet or null if one has not been explicitly specified.
List<Vector3D>	getVertices() Get the facet vertices.

Method Detail

getVertices

List<Vector3D> getVertices()

Get the facet vertices.

Returns:

facet vertices

getNormal

Vector3D getNormal()

Get the normal defined for the facet or null if one has not been explicitly specified. No guarantees are made regarding the properties of the normal or its relationship to the vertices.

Returns:

the defined normal for the facet or null if one has not been explicitly specified