Class Triangle

A geometric triangle as defined by three Vector3s representing its three corners.

Hierarchy

Base
- Triangle

Index

Constructors

constructor

new Triangle(a?: Vector3, b?: Vector3, c?: Vector3): Triangle

Creates a new Triangle.
Parameters
- a: Vector3 = ...
  
  The first corner of the triangle. Default is a Vector3 at (0, 0, 0).
- b: Vector3 = ...
  
  The second corner of the triangle. Default is a Vector3 at (0, 0, 0).
- c: Vector3 = ...
  
  The third corner of the triangle. Default is a Vector3 at (0, 0, 0).
Returns Triangle

Overrides Base.constructor

Properties

a

The first corner of the triangle. Default is a Vector3 at (0, 0, 0).

b

The second corner of the triangle. Default is a Vector3 at (0, 0, 0).

c

The final corner of the triangle. Default is a Vector3 at (0, 0, 0).

Accessors

isBox2

get isBox2(): boolean

Returns boolean

Inherited from Base.isBox2

isBox3

get isBox3(): boolean

Returns boolean

Inherited from Base.isBox3

isColor

get isColor(): boolean

Returns boolean

Inherited from Base.isColor

isCylindrical

get isCylindrical(): boolean

Returns boolean

Inherited from Base.isCylindrical

isEuler

get isEuler(): boolean

Returns boolean

Inherited from Base.isEuler

isLine3

get isLine3(): boolean

Returns boolean

Inherited from Base.isLine3

isMatrix3

get isMatrix3(): boolean

Returns boolean

Inherited from Base.isMatrix3

isMatrix4

get isMatrix4(): boolean

Returns boolean

Inherited from Base.isMatrix4

isPlane

get isPlane(): boolean

Returns boolean

Inherited from Base.isPlane

isQuaternion

get isQuaternion(): boolean

Returns boolean

Inherited from Base.isQuaternion

isRay

get isRay(): boolean

Returns boolean

Inherited from Base.isRay

isSphere

get isSphere(): boolean

Returns boolean

Inherited from Base.isSphere

isSpherical

get isSpherical(): boolean

Returns boolean

Inherited from Base.isSpherical

isTriangle

get isTriangle(): boolean

Read-only flag to check if a given object is of type Triangle.

Returns boolean

Overrides Base.isTriangle

isVector2

get isVector2(): boolean

Returns boolean

Inherited from Base.isVector2

isVector3

get isVector3(): boolean

Returns boolean

Inherited from Base.isVector3

isVector4

get isVector4(): boolean

Returns boolean

Inherited from Base.isVector4

Methods

clone

clone(): Triangle

Create a new triangle with the same a, b and c properties as this one.

Returns
A new Triangle instance equal to this triangle.

Returns Triangle

closestPointToPoint

closestPointToPoint(pt: Vector3, target?: Vector3): Vector3

Returns the closest point on the triangle to point.

Algorithm thanks to Real-Time Collision Detection by Christer Ericson, published by Morgan Kaufmann Publishers, (c) 2005 Elsevier Inc., under the accompanying license; see chapter 5.1.5 for detailed explanation. basically, we're distinguishing which of the voronoi regions of the triangle the point lies in with the minimum amount of redundant computation.

Returns
The closest point.
Parameters
- pt: Vector3
  
  Vector3
- target: Vector3 = ...
  
  — (Optional) The result will be copied into this Vector3.
Returns Vector3

containsPoint

containsPoint(point: Vector3): boolean

Determine if a point, when projected onto the plane of the triangle, lies within the triangle.

Returns
True if the triangle contains the point.
Parameters
- point: Vector3
  
  Vector3 to check.
Returns boolean

copy

copy(triangle: Triangle): Triangle

Copies the values of the passed triangles's a, b and c properties to this triangle.

Returns
This instance.
Parameters
- triangle: Triangle
  
  The source triangle.
Returns Triangle

equals

equals(triangle: Triangle): boolean

Determing if the two triangles have identical a, b and c properties.

Returns
True if triangle has the same component values as this triangle.
Parameters
- triangle: Triangle
  
  The source triangle
Returns boolean

getArea

getArea(): number

Copmute the area of the triangle.

Returns
The area of the triangle.

Returns number

getBarycoord

getBarycoord(point: Vector3, target?: Vector3): Vector3

Compute a barycentric coordinate from the given vector.

Returns
The barycentric coordinate.
Parameters
- point: Vector3
  
  Vector3
- target: Vector3 = ...
  
  (Optional) The result will be copied into this Vector3.
Returns Vector3

getMidpoint

getMidpoint(target?: Vector3): Vector3

Calculate the midpoint of the triangle.

Returns
The midpoint.
Parameters
- target: Vector3 = ...
  
  (Optional) The result will be copied into this Vector3.
Returns Vector3

getNormal

getNormal(target?: Vector3): Vector3

Calculate the normal vector of the triangle.

Returns
The normal vector.
Parameters
- Optional target: Vector3
  
  (Optional) The result will be copied into this Vector3.
Returns Vector3

getPlane

getPlane(target?: Plane): Plane

Calculate a plane based on the triangle. .

Returns
The plane.
Parameters
- target: Plane = ...
  
  (Optional) The result will be copied into this Plane.
Returns Plane

getUV

getUV(point: Vector3, uv1: Vector2, uv2: Vector2, uv3: Vector2, target?: Vector2): Vector2

Compute the uv coordinates for the given point on the triangle.

Returns
The UV coordinate
Parameters
- point: Vector3
  
  The point on the triangle.
- uv1: Vector2
  
  The uv coordinate of the triangle's first vertex.
- uv2: Vector2
  
  The uv coordinate of the triangle's second vertex.
- uv3: Vector2
  
  The uv coordinate of the triangle's third vertex.
- target: Vector2 = ...
  
  — (optional) The result will be copied into this Vector2
Returns Vector2

intersectsBox

intersectsBox(box: Box3): boolean

Determines whether or not this triangle intersects box.

Returns
True if the box intersects this triangle.
Parameters
- box: Box3
  
  Box to check for intersection against.
Returns boolean

isFrontFacing

isFrontFacing(direction: Vector3): boolean

Determine if the triangle is oriented towards the given direction or not.

Returns
True if the triangle is oriented towards the direction parameter.
Parameters
- direction: Vector3
  
  The direction to test.
Returns boolean

set

set(a: Vector3, b: Vector3, c: Vector3): Triangle

Sets the triangle's a, b and c properties to the passed vector3s. Please note that this method only copies the values from the given objects.

Returns
This instance.
Parameters
- a: Vector3
  
  The first point
- b: Vector3
  
  The second point
- c: Vector3
  
  The third point.
Returns Triangle

setFromPointsAndIndices

setFromPointsAndIndices(points: Vector3[], i0: number, i1: number, i2: number): Triangle

Sets the triangle's vectors to the vectors in the array.

Returns
This instance
Parameters
- points: Vector3[]
  
  Array of Vector3s
- i0: number
  
  index into points array
- i1: number
  
  index into points array
- i2: number
  
  index into points array
Returns Triangle

`Static` containsPoint

containsPoint(point: Vector3, a: Vector3, b: Vector3, c: Vector3): boolean

Parameters
- point: Vector3
- a: Vector3
- b: Vector3
- c: Vector3
Returns boolean

`Static` getBarycoord

getBarycoord(point: Vector3, a: Vector3, b: Vector3, c: Vector3, target?: Vector3): Vector3

Returns
Parameters
- point: Vector3
- a: Vector3
- b: Vector3
- c: Vector3
- target: Vector3 = ...
Returns Vector3

`Static` getNormal

getNormal(a: Vector3, b: Vector3, c: Vector3, target?: Vector3): Vector3

Returns
Parameters
- a: Vector3
- b: Vector3
- c: Vector3
- target: Vector3 = ...
Returns Vector3

`Static` getUV

getUV(point: Vector3, p1: Vector3, p2: Vector3, p3: Vector3, uv1: Vector2, uv2: Vector2, uv3: Vector2, target: Vector2): Vector2

Parameters
- point: Vector3
- p1: Vector3
- p2: Vector3
- p3: Vector3
- uv1: Vector2
- uv2: Vector2
- uv3: Vector2
- target: Vector2
Returns Vector2

`Static` isFrontFacing

isFrontFacing(a: Vector3, b: Vector3, c: Vector3, direction: Vector3): boolean

Parameters
- a: Vector3
- b: Vector3
- c: Vector3
- direction: Vector3
Returns boolean