Triangle (jMonkeyEngine3)

java.lang.Object
- com.jme3.math.AbstractTriangle
- - com.jme3.math.Triangle

All Implemented Interfaces:

Collidable, Savable, java.io.Serializable, java.lang.Cloneable
```
public class Triangle
extends AbstractTriangle
implements Savable, java.lang.Cloneable, java.io.Serializable
```
Triangle defines a triangle in terms of its vertex locations, with auxiliary storage for its centroid, normal vector, projection, and index.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`Triangle()` Instantiate a zero-size Triangle at the origin.
`Triangle(Vector3f p1, Vector3f p2, Vector3f p3)` Instantiate a `Triangle` with the specified vertex locations.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`calculateCenter()` Recalculate the stored centroid based on the current vertex locations.
`void`	`calculateNormal()` Recalculate the stored normal based on the current vertex locations.
`Triangle`	`clone()` Create a copy of this triangle.
`static Vector3f`	`computeTriangleNormal(Vector3f v1, Vector3f v2, Vector3f v3, Vector3f store)`
`Vector3f`	`get(int i)` Access the location of the indexed vertex.
`Vector3f`	`get1()` Access the location of the first vertex.
`Vector3f`	`get2()` Access the location of the 2nd vertex.
`Vector3f`	`get3()` Access the location of the 3rd vertex.
`Vector3f`	`getCenter()` Access the stored centroid (the average of the 3 vertex locations) calculating it if it is null.
`int`	`getIndex()` Read the index of this triangle, used to identify it in an OBBTree.
`Vector3f`	`getNormal()` Access the stored normal, updating it if it is null.
`float`	`getProjection()` Read the projection of the vertices relative to the line origin.
`void`	`read(JmeImporter e)` De-serialize this triangle from the specified importer, for example when loading from a J3O file.
`void`	`set(int i, float x, float y, float z)` Alter the location of the indexed vertex and delete the stored centroid and normal.
`void`	`set(int i, Vector3f point)` Alter the location of the indexed vertex and delete the stored centroid and normal.
`void`	`set(Vector3f v1, Vector3f v2, Vector3f v3)` Alter the locations of all 3 vertices and delete the stored centroid and normal.
`void`	`set1(Vector3f v)` Alter the location of the first vertex and delete the stored centroid and normal.
`void`	`set2(Vector3f v)` Alter the location of the 2nd vertex and delete the stored centroid and normal.
`void`	`set3(Vector3f v)` Alter the location of the 3rd vertex and delete the stored centroid and normal.
`void`	`setCenter(Vector3f center)` Alter the stored centroid without affecting the stored normal or any vertex locations.
`void`	`setIndex(int index)` Alter the index of this triangle, used to identify it in an OBBTree.
`void`	`setNormal(Vector3f normal)` Alter the stored normal without affecting the stored centroid or any vertex locations.
`void`	`setProjection(float projection)` Alter the projection of the vertices relative to the line origin.
`void`	`write(JmeExporter e)` Serialize this triangle to the specified exporter, for example when saving to a J3O file.

Methods inherited from class com.jme3.math.AbstractTriangle
collideWith

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

- Constructor Detail
  - Triangle
```
public Triangle()
```
    Instantiate a zero-size Triangle at the origin.
  - Triangle
```
public Triangle(Vector3f p1,
                Vector3f p2,
                Vector3f p3)
```
    Instantiate a Triangle with the specified vertex locations. Vertices should be listed in the desired winding order, typically counter-clockwise.
    
    Parameters:
    
    p1 - the location of the first vertex (not null, unaffected)
    
    p2 - the location of the 2nd vertex (not null, unaffected)
    
    p3 - the location of the 3rd vertex (not null, unaffected)
- Method Detail
  - get
```
public Vector3f get(int i)
```
    Access the location of the indexed vertex.
    
    Parameters:
    
    i - the index of the vertex to access (0, 1, or 2)
    
    Returns:
    
    a pre-existing location vector, or null if the index is invalid
  - get1
```
public Vector3f get1()
```
    Access the location of the first vertex.
    
    Specified by:
    
    get1 in class AbstractTriangle
    
    Returns:
    
    the pre-existing location vector (not null)
  - get2
```
public Vector3f get2()
```
    Access the location of the 2nd vertex.
    
    Specified by:
    
    get2 in class AbstractTriangle
    
    Returns:
    
    the pre-existing location vector (not null)
  - get3
```
public Vector3f get3()
```
    Access the location of the 3rd vertex.
    
    Specified by:
    
    get3 in class AbstractTriangle
    
    Returns:
    
    the pre-existing location vector (not null)
  - set
```
public void set(int i,
                Vector3f point)
```
    Alter the location of the indexed vertex and delete the stored centroid and normal.
    
    Parameters:
    
    i - the index of the vertex to alter (0, 1, or 2)
    
    point - the desired location (not null, unaffected)
  - set
```
public void set(int i,
                float x,
                float y,
                float z)
```
    Alter the location of the indexed vertex and delete the stored centroid and normal.
    
    Parameters:
    
    i - the index of the vertex to alter (0, 1, or 2)
    
    x - the desired X coordinate
    
    y - the desired Y coordinate
    
    z - the desired Z coordinate
  - set1
```
public void set1(Vector3f v)
```
    Alter the location of the first vertex and delete the stored centroid and normal.
    
    Parameters:
    
    v - the desired location (not null, unaffected)
  - set2
```
public void set2(Vector3f v)
```
    Alter the location of the 2nd vertex and delete the stored centroid and normal.
    
    Parameters:
    
    v - the desired location (not null, unaffected)
  - set3
```
public void set3(Vector3f v)
```
    Alter the location of the 3rd vertex and delete the stored centroid and normal.
    
    Parameters:
    
    v - the desired location (not null, unaffected)
  - set
```
public void set(Vector3f v1,
                Vector3f v2,
                Vector3f v3)
```
    Alter the locations of all 3 vertices and delete the stored centroid and normal.
    
    Specified by:
    
    set in class AbstractTriangle
    
    Parameters:
    
    v1 - the desired location of the first vertex (not null, unaffected)
    
    v2 - the desired location of the 2nd vertex (not null, unaffected)
    
    v3 - the desired location of the 3rd vertex (not null, unaffected)
  - calculateCenter
```
public void calculateCenter()
```
    Recalculate the stored centroid based on the current vertex locations.
  - calculateNormal
```
public void calculateNormal()
```
    Recalculate the stored normal based on the current vertex locations.
  - getCenter
```
public Vector3f getCenter()
```
    Access the stored centroid (the average of the 3 vertex locations) calculating it if it is null.
    
    Returns:
    
    the coordinates of the center (an internal vector subject to re-use)
  - setCenter
```
public void setCenter(Vector3f center)
```
    Alter the stored centroid without affecting the stored normal or any vertex locations.
    
    Parameters:
    
    center - the desired value (alias created if not null)
  - getNormal
```
public Vector3f getNormal()
```
    Access the stored normal, updating it if it is null.
    
    Returns:
    
    unit normal vector (an internal vector subject to re-use)
  - setNormal
```
public void setNormal(Vector3f normal)
```
    Alter the stored normal without affecting the stored centroid or any vertex locations.
    
    Parameters:
    
    normal - the desired value (alias created if not null)
  - getProjection
```
public float getProjection()
```
    Read the projection of the vertices relative to the line origin.
    
    Returns:
    
    the stored projection value
  - setProjection
```
public void setProjection(float projection)
```
    Alter the projection of the vertices relative to the line origin.
    
    Parameters:
    
    projection - the desired projection value
  - getIndex
```
public int getIndex()
```
    Read the index of this triangle, used to identify it in an OBBTree.
    
    Returns:
    
    the stored index
  - setIndex
```
public void setIndex(int index)
```
    Alter the index of this triangle, used to identify it in an OBBTree.
    
    Parameters:
    
    index - the desired index
  - computeTriangleNormal
```
public static Vector3f computeTriangleNormal(Vector3f v1,
                                             Vector3f v2,
                                             Vector3f v3,
                                             Vector3f store)
```
  - write
```
public void write(JmeExporter e)
           throws java.io.IOException
```
    Serialize this triangle to the specified exporter, for example when saving to a J3O file.
    
    Specified by:
    
    write in interface Savable
    
    Parameters:
    
    e - (not null)
    
    Throws:
    
    java.io.IOException - from the exporter
  - read
```
public void read(JmeImporter e)
          throws java.io.IOException
```
    De-serialize this triangle from the specified importer, for example when loading from a J3O file.
    
    Specified by:
    
    read in interface Savable
    
    Parameters:
    
    e - (not null)
    
    Throws:
    
    java.io.IOException - from the importer
  - clone
```
public Triangle clone()
```
    Create a copy of this triangle.
    
    Overrides:
    
    clone in class java.lang.Object
    
    Returns:
    
    a new instance, equivalent to this one

Class Triangle

Constructor Summary

Method Summary

Methods inherited from class com.jme3.math.AbstractTriangle

Methods inherited from class java.lang.Object

Constructor Detail

Triangle

Triangle

Method Detail

get

get1

get2

get3

set

set

set1

set2

set3

set

calculateCenter

calculateNormal

getCenter

setCenter

getNormal

setNormal

getProjection

setProjection

getIndex

setIndex

computeTriangleNormal

write

read

clone