Triangle (patrimoine de base SIRIUS 4.11 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.
`protected double`	`distanceTo(Line line)` Computes minimal distance between provided line and triangle provided that line does not cross triangle.
`static double`	`dotProduct(Vector3D v1, Vector3D v2)` Fast dot product of two 3D vectors.
`Vector3D`	`getCenter()` Returns the triangle barycenter.
`int`	`getID()` The triangle identifier.
`Vector3D`	`getIntersection(Line line)` Returns intersection point with triangle, null if there is no intersection or if line is included in triangle.
`List<Triangle>`	`getNeighbors()` Returns the triangle neighbors (i.e.
`Vector3D`	`getNormal()` Returns the normal to the triangle.
`double`	`getSphereRadius()` Returns the encompassing sphere radius squared.
`double`	`getSurface()` Returns the triangle surface.
`Vertex[]`	`getVertices()` 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.

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

- Constructor Detail
  - Triangle
```
public Triangle(int idIn,
                Vertex v1,
                Vertex v2,
                Vertex v3)
```
    Constructor.
    
    Parameters:
    
    idIn - the triangle identifier
    
    v1 - first vertex
    
    v2 - second vertex
    
    v3 - third vertex
- Method Detail
  - getIntersection
```
public Vector3D getIntersection(Line line)
```
    Returns 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.
  - 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()
```
    The triangle identifier.
    
    Returns:
    
    the triangle identifier
  - getVertices
```
public Vertex[] getVertices()
```
    The triangle vertices.
    
    Returns:
    
    the triangle vertices
  - getCenter
```
public Vector3D getCenter()
```
    Returns the triangle barycenter.
    
    Returns:
    
    the triangle barycenter
  - getNormal
```
public Vector3D getNormal()
```
    Returns the normal to the triangle.
    
    Returns:
    
    the normal to the triangle
  - getSurface
```
public double getSurface()
```
    Returns the triangle surface.
    
    Returns:
    
    the triangle surface
  - getNeighbors
```
public List<Triangle> getNeighbors()
```
    Returns the triangle neighbors (i.e. which have a side in common).
    
    Returns:
    
    the triangle neighbors
  - getSphereRadius
```
public double getSphereRadius()
```
    Returns 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 line does not cross triangle.
    This method is package-protected and is not supposed to be used by user. It assumes line does not cross triangle
    
    Parameters:
    
    line - line
    
    Returns:
    
    minimal distance between provided line and 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

Class Triangle

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Triangle

Method Detail

getIntersection

closestPointTo

pointInTriangle

dotProduct

getID

getVertices

getCenter

getNormal

getSurface

getNeighbors

getSphereRadius

addNeighbors

isNeighborByVertexID

isVisible

distanceTo

setHandled

isHandled