Package org.gnome.graphene

Class Triangle

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.graphene.Triangle

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class Triangle
extends ProxyInstance

A triangle.

Constructor Summary

Constructors

Constructor	Description
Triangle()	Allocate a new Triangle.
Triangle(Arena arena)	Allocate a new Triangle.
Triangle(MemorySegment address)	Create a Triangle proxy instance for the provided memory address.
Triangle(Vec3 a, Vec3 b, Vec3 c)	Allocate a new Triangle with the fields set to the provided values.
Triangle(Vec3 a, Vec3 b, Vec3 c, Arena arena)	Allocate a new Triangle with the fields set to the provided values.

Method Summary

Modifier and Type	Method	Description
static Triangle	alloc()	Allocates a new graphene_triangle_t.
boolean	containsPoint(Point3D p)	Checks whether the given triangle this Triangle contains the point p.
boolean	equal(Triangle b)	Checks whether the two given graphene_triangle_t are equal.
void	free()	Frees the resources allocated by graphene_triangle_alloc().
float	getArea()	Computes the area of the given graphene_triangle_t.
boolean	getBarycoords(@Nullable Point3D p, Vec2 res)	Computes the barycentric coordinates of the given point p.
void	getBoundingBox(Box res)	Computes the bounding box of the given graphene_triangle_t.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
void	getMidpoint(Point3D res)	Computes the coordinates of the midpoint of the given graphene_triangle_t.
void	getNormal(Vec3 res)	Computes the normal vector of the given graphene_triangle_t.
void	getPlane(Plane res)	Computes the plane based on the vertices of the given graphene_triangle_t.
void	getPoints(@Nullable Point3D a, @Nullable Point3D b, @Nullable Point3D c)	Retrieves the three vertices of the given graphene_triangle_t and returns their coordinates as graphene_point3d_t.
static Type	getType()	Get the GType of the Triangle class
boolean	getUv(@Nullable Point3D p, Vec2 uvA, Vec2 uvB, Vec2 uvC, Vec2 res)	Computes the UV coordinates of the given point p.
void	getVertices(@Nullable Vec3 a, @Nullable Vec3 b, @Nullable Vec3 c)	Retrieves the three vertices of the given graphene_triangle_t.
Triangle	initFromFloat(float[] a, float[] b, float[] c)	Initializes a graphene_triangle_t using the three given arrays of floating point values, each representing the coordinates of a point in 3D space.
Triangle	initFromPoint3d(@Nullable Point3D a, @Nullable Point3D b, @Nullable Point3D c)	Initializes a graphene_triangle_t using the three given 3D points.
Triangle	initFromVec3(@Nullable Vec3 a, @Nullable Vec3 b, @Nullable Vec3 c)	Initializes a graphene_triangle_t using the three given vectors.
Vec3	readA()	Read the value of the field a.
Vec3	readB()	Read the value of the field b.
Vec3	readC()	Read the value of the field c.
void	writeA(Vec3 a)	Write a value in the field a.
void	writeB(Vec3 b)	Write a value in the field b.
void	writeC(Vec3 c)	Write a value in the field c.

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Triangle

public Triangle(MemorySegment address)

Create a Triangle proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Triangle

public Triangle(Arena arena)

Allocate a new Triangle.

Parameters:

arena - to control the memory allocation scope

Triangle

public Triangle()

Allocate a new Triangle. The memory is allocated with Arena.ofAuto().

Triangle

public Triangle(Vec3 a,
 Vec3 b,
 Vec3 c,
 Arena arena)

Allocate a new Triangle with the fields set to the provided values.

Parameters:

a - value for the field a

b - value for the field b

c - value for the field c

arena - to control the memory allocation scope

Triangle

public Triangle(Vec3 a,
 Vec3 b,
 Vec3 c)

Allocate a new Triangle with the fields set to the provided values. The memory is allocated with Arena.ofAuto().

Parameters:

a - value for the field a

b - value for the field b

c - value for the field c

Method Details

getType

public static Type getType()

Get the GType of the Triangle class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

readA

public Vec3 readA()

Read the value of the field a.

Returns:

The value of the field a

writeA

public void writeA(Vec3 a)

Write a value in the field a.

Parameters:

a - The new value for the field a

readB

public Vec3 readB()

Read the value of the field b.

Returns:

The value of the field b

writeB

public void writeB(Vec3 b)

Write a value in the field b.

Parameters:

b - The new value for the field b

readC

public Vec3 readC()

Read the value of the field c.

Returns:

The value of the field c

writeC

public void writeC(Vec3 c)

Write a value in the field c.

Parameters:

c - The new value for the field c

alloc

public static Triangle alloc()

Allocates a new graphene_triangle_t.

The contents of the returned structure are undefined.

Returns:

the newly allocated graphene_triangle_t structure. Use graphene_triangle_free() to free the resources allocated by this function

containsPoint

public boolean containsPoint(Point3D p)

Checks whether the given triangle this Triangle contains the point p.

Parameters:

p - a graphene_point3d_t

Returns:

true if the point is inside the triangle

equal

public boolean equal(Triangle b)

Checks whether the two given graphene_triangle_t are equal.

Parameters:

b - a graphene_triangle_t

Returns:

true if the triangles are equal

free

public void free()

Frees the resources allocated by graphene_triangle_alloc().

getArea

public float getArea()

Computes the area of the given graphene_triangle_t.

Returns:

the area of the triangle

getBarycoords

public boolean getBarycoords(@Nullable
 @Nullable Point3D p,
 Vec2 res)

Computes the barycentric coordinates of the given point p.

The point p must lie on the same plane as the triangle this Triangle; 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_t contains the following values, in order:

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

Parameters:

p - a graphene_point3d_t

res - return location for the vector with the barycentric coordinates

Returns:

true if the barycentric coordinates are valid

getBoundingBox

public void getBoundingBox(Box res)

Computes the bounding box of the given graphene_triangle_t.

Parameters:

res - return location for the box

getMidpoint

public void getMidpoint(Point3D res)

Computes the coordinates of the midpoint of the given graphene_triangle_t.

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

Parameters:

res - return location for the coordinates of the midpoint

getNormal

public void getNormal(Vec3 res)

Computes the normal vector of the given graphene_triangle_t.

Parameters:

res - return location for the normal vector

getPlane

public void getPlane(Plane res)

Computes the plane based on the vertices of the given graphene_triangle_t.

Parameters:

res - return location for the plane

getPoints

public void getPoints(@Nullable
 @Nullable Point3D a,
 @Nullable
 @Nullable Point3D b,
 @Nullable
 @Nullable Point3D c)

Retrieves the three vertices of the given graphene_triangle_t and returns their coordinates as graphene_point3d_t.

Parameters:

a - return location for the coordinates of the first vertex

b - return location for the coordinates of the second vertex

c - return location for the coordinates of the third vertex

getUv

public boolean getUv(@Nullable
 @Nullable Point3D p,
 Vec2 uvA,
 Vec2 uvB,
 Vec2 uvC,
 Vec2 res)

Computes the UV coordinates of the given point p.

The point p must lie on the same plane as the triangle this Triangle; 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 - a graphene_point3d_t

uvA - the UV coordinates of the first point

uvB - the UV coordinates of the second point

uvC - the UV coordinates of the third point

res - a vector containing the UV coordinates of the given point p

Returns:

true if the coordinates are valid

getVertices

public void getVertices(@Nullable
 @Nullable Vec3 a,
 @Nullable
 @Nullable Vec3 b,
 @Nullable
 @Nullable Vec3 c)

Retrieves the three vertices of the given graphene_triangle_t.

Parameters:

a - return location for the first vertex

b - return location for the second vertex

c - return location for the third vertex

initFromFloat

public Triangle initFromFloat(float[] a,
 float[] b,
 float[] c)

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

Parameters:

a - an array of 3 floating point values

b - an array of 3 floating point values

c - an array of 3 floating point values

Returns:

the initialized graphene_triangle_t

initFromPoint3d

public Triangle initFromPoint3d(@Nullable
 @Nullable Point3D a,
 @Nullable
 @Nullable Point3D b,
 @Nullable
 @Nullable Point3D c)

Initializes a graphene_triangle_t using the three given 3D points.

Parameters:

a - a graphene_point3d_t

b - a graphene_point3d_t

c - a graphene_point3d_t

Returns:

the initialized graphene_triangle_t

initFromVec3

public Triangle initFromVec3(@Nullable
 @Nullable Vec3 a,
 @Nullable
 @Nullable Vec3 b,
 @Nullable
 @Nullable Vec3 c)

Initializes a graphene_triangle_t using the three given vectors.

Parameters:

a - a graphene_vec3_t

b - a graphene_vec3_t

c - a graphene_vec3_t

Returns:

the initialized graphene_triangle_t