Graphene-1.0 ▶ Graphene ▶ TriangleSince 1.2

constructor

• new Triangle(properties?: Partial<{}>): Triangle

  Parameters

  • Optionalproperties: Partial<{}>

  Returns Triangle

Static$gtype

contains_point

• contains_point(p: Point3D): boolean

  Checks whether the given triangle t contains the point p.

  Parameters

  • p: Point3D

    a Graphene.Point3D

  Returns boolean

  true if the point is inside the triangle

equal

• equal(b: Triangle): boolean

  Checks whether the two given Graphene.Triangle are equal.

  Parameters

  • b: Triangle

    a Graphene.Triangle

  Returns boolean

  true if the triangles are equal

free

• free(): void

  Frees the resources allocated by graphene_triangle_alloc().

  Returns void

get_area

• get_area(): number

  Computes the area of the given Graphene.Triangle.

  Returns number

  the area of the triangle

get_barycoords

• get_barycoords(p: Point3D): [boolean, Vec2]

  Computes the barycentric coordinates of the given point p.

  The point p must lie on the same plane as the triangle t; if the point is not coplanar, the result of this function is undefined.

  If we place the origin in the coordinates of the triangle's A point, the barycentric coordinates are u, which is on the AC vector; and v which is on the AB vector:

  

  The returned Graphene.Vec2 contains the following values, in order:

  • res.x = u
  • res.y = v

  Parameters

  • p: Point3D

    a Graphene.Point3D

  Returns [boolean, Vec2]

  true if the barycentric coordinates are valid

get_bounding_box

• get_bounding_box(): Graphene.Box

  Computes the bounding box of the given Graphene.Triangle.

  Returns Graphene.Box

get_midpoint

• get_midpoint(): Point3D

  Computes the coordinates of the midpoint of the given Graphene.Triangle.

  The midpoint G is the centroid of the triangle, i.e. the intersection of its medians.

  Returns Point3D

get_normal

• get_normal(): Vec3

  Computes the normal vector of the given Graphene.Triangle.

  Returns Vec3

get_plane

• get_plane(): Plane

  Computes the plane based on the vertices of the given Graphene.Triangle.

  Returns Plane

get_points

• get_points(): [Point3D, Point3D, Point3D]

  Retrieves the three vertices of the given Graphene.Triangle and returns their coordinates as Graphene.Point3D.

  Returns [Point3D, Point3D, Point3D]

get_uv

• get_uv(p: Point3D, uv_a: Vec2, uv_b: Vec2, uv_c: Vec2): [boolean, Vec2]

  Computes the UV coordinates of the given point p.

  The point p must lie on the same plane as the triangle t; if the point is not coplanar, the result of this function is undefined. If p is null, the point will be set in (0, 0, 0).

  The UV coordinates will be placed in the res vector:

  • res.x = u
  • res.y = v

  See also: graphene_triangle_get_barycoords()

  Parameters

  • p: Point3D

    a Graphene.Point3D

  • uv_a: Vec2

    the UV coordinates of the first point

  • uv_b: Vec2

    the UV coordinates of the second point

  • uv_c: Vec2

    the UV coordinates of the third point

  Returns [boolean, Vec2]

  true if the coordinates are valid

get_vertices

• get_vertices(): [Vec3, Vec3, Vec3]

  Retrieves the three vertices of the given Graphene.Triangle.

  Returns [Vec3, Vec3, Vec3]

init_from_float

• init_from_float(a: number[], b: number[], c: number[]): Triangle

  Initializes a Graphene.Triangle using the three given arrays of floating point values, each representing the coordinates of a point in 3D space.

  Parameters

  • a: number[]

    an array of 3 floating point values

  • b: number[]

    an array of 3 floating point values

  • c: number[]

    an array of 3 floating point values

  Returns Triangle

  the initialized Graphene.Triangle

init_from_point3d

• init_from_point3d(a?: Point3D, b?: Point3D, c?: Point3D): Triangle

  Initializes a Graphene.Triangle using the three given 3D points.

  Parameters

  • Optionala: Point3D

    a Graphene.Point3D

  • Optionalb: Point3D

    a Graphene.Point3D

  • Optionalc: Point3D

    a Graphene.Point3D

  Returns Triangle

  the initialized Graphene.Triangle

init_from_vec3

• init_from_vec3(a?: Vec3, b?: Vec3, c?: Vec3): Triangle

  Initializes a Graphene.Triangle using the three given vectors.

  Parameters

  • Optionala: Vec3

    a Graphene.Vec3

  • Optionalb: Vec3

    a Graphene.Vec3

  • Optionalc: Vec3

    a Graphene.Vec3

  Returns Triangle

  the initialized Graphene.Triangle

Staticalloc

• alloc(): Triangle

  Returns Triangle