Triangle (patrimoine de base SIRIUS 4.13 API)

java.lang.Object
- fr.cnes.sirius.patrius.bodies.mesh.Triangle

All Implemented Interfaces:

Serializable
```
public class Triangle
extends Object
implements Serializable
```
3D triangle definition. A triangle contains 3 3D-points or "vertices" (defined by Vertex class). This class also stores data related to the triangle for efficient computation (center, surface, normal vector, neighboring Triangle).

Since:

4.6

Author:

Emmanuel Bignon

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

Triangle(int idIn, Vertex v1, Vertex v2, Vertex v3)
Constructor.

Constructors
Constructor and Description
`Triangle(int idIn, Vertex v1, Vertex v2, Vertex v3)` Constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addNeighbors(Triangle neighbor)` Add a triangle neighbor (package method only to be used at initialization of `FacetBodyShape`).
`Vector3D[]`	`closestPointTo(Line line)` Computes the points of the triangle and the line realizing the shortest distance.
`Vector3D`	`closestPointTo(Vector3D point)` Getter for the closest point of triangle to provided point.
`protected double`	`distanceTo(Line line)` Computes minimal distance between provided line and triangle provided that the line does not cross this triangle.
`double`	`distanceTo(Vector3D point)` Computes distance from triangle to provided.
`static double`	`dotProduct(Vector3D v1, Vector3D v2)` Fast dot product of two 3D vectors.
`Vector3D`	`getCenter()` Getter for the triangle barycenter.
`int`	`getID()` Getter for the triangle identifier.
`Vector3D`	`getIntersection(Line line)` Getter for the intersection point with triangle, null if there is no intersection or if line is included in triangle.
`List<Triangle>`	`getNeighbors()` Getter for the triangle neighbors (i.e.
`Vector3D`	`getNormal()` Getter for the normal to the triangle.
`double`	`getSphereRadius()` Getter for the encompassing sphere radius squared.
`double`	`getSurface()` Getter for the triangle surface.
`Vertex[]`	`getVertices()` Getter for the triangle vertices.
`boolean`	`isHandled()` Returns a boolean representing triangle status for fast algorithms.
`boolean`	`isNeighborByVertexID(Triangle triangle)` Returns true if provided triangle is a neighbor by checking their vertices ID (i.e.
`boolean`	`isVisible(Vector3D position)` Returns true if the triangle is visible from the provided position (culling test).
`boolean`	`pointInTriangle(Vector3D point)` Check if the projection on triangle's plane of a point of space belongs to the triangle.
`void`	`setHandled(boolean handled)` Set a boolean representing triangle status for fast algorithms.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Triangle
```
public Triangle(int idIn,
                Vertex v1,
                Vertex v2,
                Vertex v3)
```
    Constructor.
    
    Parameters:
    
    idIn - Triangle identifier
    
    v1 - First vertex
    
    v2 - Second vertex
    
    v3 - Third vertex
- Method Detail
  - getIntersection
```
public Vector3D getIntersection(Line line)
```
    Getter for the intersection point with triangle, null if there is no intersection or if line is included in triangle.
    Algorithm from article "Fast, Minimum Storage Ray/Triangle Intersection" from Thomas Moller, 1997.
    
    Parameters:
    
    line - line of sight (considered infinite)
    
    Returns:
    
    intersection point with triangle, null if there is no intersection
  - closestPointTo
```
public Vector3D[] closestPointTo(Line line)
```
    Computes the points of the triangle and the line realizing the shortest distance.
    If the line intersects the triangle, the returned points are identical. Semi-finite lines are handled by this method.
    
    Parameters:
    
    line - the line
    
    Returns:
    
    the two points : first the one from the line, and the one from the shape.
  - closestPointTo
```
public Vector3D closestPointTo(Vector3D point)
```
    Getter for the closest point of triangle to provided point.
    
    Parameters:
    
    point - a point
    
    Returns:
    
    closest point of triangle to provided point
  - pointInTriangle
```
public final boolean pointInTriangle(Vector3D point)
```
    Check if the projection on triangle's plane of a point of space belongs to the triangle.
    
    Parameters:
    
    point - a point of space
    
    Returns:
    
    true if the point's projection belongs to the triangle, false otherwise
  - dotProduct
```
public static final double dotProduct(Vector3D v1,
                                      Vector3D v2)
```
    Fast dot product of two 3D vectors.
    
    Parameters:
    
    v1 - First vector
    
    v2 - Second vector
    
    Returns:
    
    dot product of two 3D vectors
  - getID
```
public int getID()
```
    Getter for the triangle identifier.
    
    Returns:
    
    the triangle identifier
  - getVertices
```
public Vertex[] getVertices()
```
    Getter for the triangle vertices.
    
    Returns:
    
    the triangle vertices
  - getCenter
```
public Vector3D getCenter()
```
    Getter for the triangle barycenter.
    
    Returns:
    
    the triangle barycenter
  - getNormal
```
public Vector3D getNormal()
```
    Getter for the normal to the triangle.
    
    Returns:
    
    the normal to the triangle
  - getSurface
```
public double getSurface()
```
    Getter for the triangle surface.
    
    Returns:
    
    the triangle surface
  - getNeighbors
```
public List<Triangle> getNeighbors()
```
    Getter for the triangle neighbors (i.e. which have a side in common).
    
    Returns:
    
    the triangle neighbors
  - getSphereRadius
```
public double getSphereRadius()
```
    Getter for the encompassing sphere radius squared.
    
    Returns:
    
    the encompassing sphere radius squared
  - addNeighbors
```
protected void addNeighbors(Triangle neighbor)
```
    Add a triangle neighbor (package method only to be used at initialization of FacetBodyShape).
    Warning: no check is performed in order to verify is the provided triangle is really a neighbor.
    
    Parameters:
    
    neighbor - the triangle neighbor to set
  - isNeighborByVertexID
```
public boolean isNeighborByVertexID(Triangle triangle)
```
    Returns true if provided triangle is a neighbor by checking their vertices ID (i.e. has 2 identical vertex ID).
    
    Parameters:
    
    triangle - a triangle
    
    Returns:
    
    true if provided triangle is a neighbor by checking their vertices ID (i.e. has 2 identical vertex ID)
  - isVisible
```
public boolean isVisible(Vector3D position)
```
    Returns true if the triangle is visible from the provided position (culling test).
    
    Parameters:
    
    position - position
    
    Returns:
    
    true if the triangle is visible
  - distanceTo
```
protected double distanceTo(Line line)
```
    Computes minimal distance between provided line and triangle provided that the line does not cross this triangle.
    This method is package-protected and is not supposed to be used by user. It assumes that the line does not cross this triangle.
    
    Parameters:
    
    line - line
    
    Returns:
    
    minimal distance between the provided line and this triangle
  - distanceTo
```
public double distanceTo(Vector3D point)
```
    Computes distance from triangle to provided.
    
    Parameters:
    
    point - point
    
    Returns:
    
    minimal distance between the provided point and this triangle
  - setHandled
```
public void setHandled(boolean handled)
```
    Set a boolean representing triangle status for fast algorithms. This boolean can be set alternatively to true/false.
    
    Parameters:
    
    handled - status to set
  - isHandled
```
public boolean isHandled()
```
    Returns a boolean representing triangle status for fast algorithms. This boolean can be set alternatively to true/false.
    
    Returns:
    
    triangle status
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Triangle

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Triangle

Method Detail

getIntersection

closestPointTo

closestPointTo

pointInTriangle

dotProduct

getID

getVertices

getCenter

getNormal

getSurface

getNeighbors

getSphereRadius

addNeighbors

isNeighborByVertexID

isVisible

distanceTo

distanceTo

setHandled

isHandled

toString