Package org.joml

Class Interpolationd

java.lang.Object

org.joml.Interpolationd

public class Interpolationd
extends java.lang.Object

Contains various interpolation functions.

Author:

Kai Burjack

Constructor Summary

Constructors

Constructor	Description
Interpolationd()

Method Summary

Modifier and Type	Method	Description
static Vector2d	dFdxLinear(double v0X, double v0Y, double f0X, double f0Y, double v1X, double v1Y, double f1X, double f1Y, double v2X, double v2Y, double f2X, double f2Y, Vector2d dest)	Compute the first-order derivative of a linear two-dimensional function f with respect to X and store the result in dest.
static Vector2d	dFdyLinear(double v0X, double v0Y, double f0X, double f0Y, double v1X, double v1Y, double f1X, double f1Y, double v2X, double v2Y, double f2X, double f2Y, Vector2d dest)	Compute the first-order derivative of a linear two-dimensional function f with respect to Y and store the result in dest.
static double	interpolateTriangle(double v0X, double v0Y, double f0, double v1X, double v1Y, double f1, double v2X, double v2Y, double f2, double x, double y)	Bilinearly interpolate the single scalar value f over the given triangle.
static Vector3d	interpolateTriangle(double v0X, double v0Y, double f0X, double f0Y, double f0Z, double v1X, double v1Y, double f1X, double f1Y, double f1Z, double v2X, double v2Y, double f2X, double f2Y, double f2Z, double x, double y, Vector3d dest)	Bilinearly interpolate the three-dimensional vector f over the given triangle and store the result in dest.
static Vector2d	interpolateTriangle(double v0X, double v0Y, double f0X, double f0Y, double v1X, double v1Y, double f1X, double f1Y, double v2X, double v2Y, double f2X, double f2Y, double x, double y, Vector2d dest)	Bilinearly interpolate the two-dimensional vector f over the given triangle and store the result in dest.
static Vector3d	interpolationFactorsTriangle(double v0X, double v0Y, double v1X, double v1Y, double v2X, double v2Y, double x, double y, Vector3d dest)	Compute the interpolation factors (t0, t1, t2) in order to interpolate an arbitrary value over a given triangle at the given point (x, y).

Methods inherited from class java.lang.Object

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

Constructor Detail

Interpolationd

public Interpolationd()

Method Detail

interpolateTriangle

public static double interpolateTriangle(double v0X,
                                         double v0Y,
                                         double f0,
                                         double v1X,
                                         double v1Y,
                                         double f1,
                                         double v2X,
                                         double v2Y,
                                         double f2,
                                         double x,
                                         double y)

Bilinearly interpolate the single scalar value f over the given triangle.

Reference: https://en.wikipedia.org/

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

f0 - the value of f at the first vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

f1 - the value of f at the second vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

f2 - the value of f at the third vertex

x - the x coordinate of the point to interpolate f at

y - the y coordinate of the point to interpolate f at

Returns:

the interpolated value of f

interpolateTriangle

public static Vector2d interpolateTriangle(double v0X,
                                           double v0Y,
                                           double f0X,
                                           double f0Y,
                                           double v1X,
                                           double v1Y,
                                           double f1X,
                                           double f1Y,
                                           double v2X,
                                           double v2Y,
                                           double f2X,
                                           double f2Y,
                                           double x,
                                           double y,
                                           Vector2d dest)

Bilinearly interpolate the two-dimensional vector f over the given triangle and store the result in dest.

Reference: https://en.wikipedia.org/

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

f0X - the x component of the value of f at the first vertex

f0Y - the y component of the value of f at the first vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

f1X - the x component of the value of f at the second vertex

f1Y - the y component of the value of f at the second vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

f2X - the x component of the value of f at the third vertex

f2Y - the y component of the value of f at the third vertex

x - the x coordinate of the point to interpolate f at

y - the y coordinate of the point to interpolate f at

dest - will hold the interpolation result

Returns:

dest

dFdxLinear

public static Vector2d dFdxLinear(double v0X,
                                  double v0Y,
                                  double f0X,
                                  double f0Y,
                                  double v1X,
                                  double v1Y,
                                  double f1X,
                                  double f1Y,
                                  double v2X,
                                  double v2Y,
                                  double f2X,
                                  double f2Y,
                                  Vector2d dest)

Compute the first-order derivative of a linear two-dimensional function f with respect to X and store the result in dest.

This method computes the constant rate of change for f given the three values of f at the specified three inputs (v0X, v0Y), (v1X, v1Y) and (v2X, v2Y).

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

f0X - the x component of the value of f at the first vertex

f0Y - the y component of the value of f at the first vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

f1X - the x component of the value of f at the second vertex

f1Y - the y component of the value of f at the second vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

f2X - the x component of the value of f at the third vertex

f2Y - the y component of the value of f at the third vertex

dest - will hold the result

Returns:

dest

dFdyLinear

public static Vector2d dFdyLinear(double v0X,
                                  double v0Y,
                                  double f0X,
                                  double f0Y,
                                  double v1X,
                                  double v1Y,
                                  double f1X,
                                  double f1Y,
                                  double v2X,
                                  double v2Y,
                                  double f2X,
                                  double f2Y,
                                  Vector2d dest)

Compute the first-order derivative of a linear two-dimensional function f with respect to Y and store the result in dest.

This method computes the constant rate of change for f given the three values of f at the specified three inputs (v0X, v0Y), (v1X, v1Y) and (v2X, v2Y).

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

f0X - the x component of the value of f at the first vertex

f0Y - the y component of the value of f at the first vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

f1X - the x component of the value of f at the second vertex

f1Y - the y component of the value of f at the second vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

f2X - the x component of the value of f at the third vertex

f2Y - the y component of the value of f at the third vertex

dest - will hold the result

Returns:

dest

interpolateTriangle

public static Vector3d interpolateTriangle(double v0X,
                                           double v0Y,
                                           double f0X,
                                           double f0Y,
                                           double f0Z,
                                           double v1X,
                                           double v1Y,
                                           double f1X,
                                           double f1Y,
                                           double f1Z,
                                           double v2X,
                                           double v2Y,
                                           double f2X,
                                           double f2Y,
                                           double f2Z,
                                           double x,
                                           double y,
                                           Vector3d dest)

Bilinearly interpolate the three-dimensional vector f over the given triangle and store the result in dest.

Reference: https://en.wikipedia.org/

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

f0X - the x component of the value of f at the first vertex

f0Y - the y component of the value of f at the first vertex

f0Z - the z component of the value of f at the first vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

f1X - the x component of the value of f at the second vertex

f1Y - the y component of the value of f at the second vertex

f1Z - the z component of the value of f at the second vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

f2X - the x component of the value of f at the third vertex

f2Y - the y component of the value of f at the third vertex

f2Z - the z component of the value of f at the third vertex

x - the x coordinate of the point to interpolate f at

y - the y coordinate of the point to interpolate f at

dest - will hold the interpolation result

Returns:

dest

interpolationFactorsTriangle

public static Vector3d interpolationFactorsTriangle(double v0X,
                                                    double v0Y,
                                                    double v1X,
                                                    double v1Y,
                                                    double v2X,
                                                    double v2Y,
                                                    double x,
                                                    double y,
                                                    Vector3d dest)

Compute the interpolation factors (t0, t1, t2) in order to interpolate an arbitrary value over a given triangle at the given point (x, y).

This method takes in the 2D vertex positions of the three vertices of a triangle and stores in dest the factors (t0, t1, t2) in the equation v' = v0 * t0 + v1 * t1 + v2 * t2 where (v0, v1, v2) are arbitrary (scalar or vector) values associated with the respective vertices of the triangle. The computed value v' is the interpolated value at the given position (x, y).

Parameters:

v0X - the x coordinate of the first triangle vertex

v0Y - the y coordinate of the first triangle vertex

v1X - the x coordinate of the second triangle vertex

v1Y - the y coordinate of the second triangle vertex

v2X - the x coordinate of the third triangle vertex

v2Y - the y coordinate of the third triangle vertex

x - the x coordinate of the point to interpolate at

y - the y coordinate of the point to interpolate at

dest - will hold the interpolation factors (t0, t1, t2)

Returns:

dest