Class CatmullRomSplined<T extends Vectord<T>>

java.lang.Object
gaiasky.util.math.CatmullRomSplined<T>
All Implemented Interfaces:
Pathd<T>

public class CatmullRomSplined<T extends Vectord<T>> extends Object implements Pathd<T>
  • Field Details

    • controlPoints

      public T extends Vectord<T>[] controlPoints
    • continuous

      public boolean continuous
    • spanCount

      public int spanCount
  • Constructor Details

    • CatmullRomSplined

      public CatmullRomSplined()
    • CatmullRomSplined

      public CatmullRomSplined(T[] controlPoints, boolean continuous)
  • Method Details

    • calculate

      public static <T extends Vectord<T>> T calculate(T out, double t, T[] points, boolean continuous, T tmp)
      Calculates the catmullrom value for the given position (t).
      Parameters:
      out - The Vectord to set to the result.
      t - The position (0invalid input: '<'=tinvalid input: '<'=1) on the spline
      points - The control points
      continuous - If true the b-spline restarts at 0 when reaching 1
      tmp - A temporary vector used for the calculation
      Returns:
      The value of out
    • calculate

      public static <T extends Vectord<T>> T calculate(T out, int i, double u, T[] points, boolean continuous, T tmp)
      Calculates the catmullrom value for the given span (i) at the given position (u).
      Parameters:
      out - The Vectord to set to the result.
      i - The span (0invalid input: '<'=iinvalid input: '<'spanCount) spanCount = continuous ? points.length : points.length - degree
      u - The position (0invalid input: '<'=uinvalid input: '<'=1) on the span
      points - The control points
      continuous - If true the b-spline restarts at 0 when reaching 1
      tmp - A temporary vector used for the calculation
      Returns:
      The value of out
    • derivative

      public static <T extends Vectord<T>> T derivative(T out, double t, T[] points, boolean continuous, T tmp)
      Calculates the derivative of the catmullrom spline for the given position (t).
      Parameters:
      out - The Vectord to set to the result.
      t - The position (0invalid input: '<'=tinvalid input: '<'=1) on the spline
      points - The control points
      continuous - If true the b-spline restarts at 0 when reaching 1
      tmp - A temporary vector used for the calculation
      Returns:
      The value of out
    • derivative

      public static <T extends Vectord<T>> T derivative(T out, int i, double u, T[] points, boolean continuous, T tmp)
      Calculates the derivative of the catmullrom spline for the given span (i) at the given position (u).
      Parameters:
      out - The Vectord to set to the result.
      i - The span (0invalid input: '<'=iinvalid input: '<'spanCount) spanCount = continuous ? points.length : points.length - degree
      u - The position (0invalid input: '<'=uinvalid input: '<'=1) on the span
      points - The control points
      continuous - If true the b-spline restarts at 0 when reaching 1
      tmp - A temporary vector used for the calculation
      Returns:
      The value of out
    • set

      public CatmullRomSplined set(T[] controlPoints, boolean continuous)
    • valueAt

      public T valueAt(T out, double t)
      Specified by:
      valueAt in interface Pathd<T extends Vectord<T>>
      Returns:
      The value of the path at t where 0invalid input: '<'=tinvalid input: '<'=1
    • valueAt

      public T valueAt(T out, int span, double u)
      Returns:
      The value of the spline at position u of the specified span
    • derivativeAt

      public T derivativeAt(T out, double t)
      Specified by:
      derivativeAt in interface Pathd<T extends Vectord<T>>
    • derivativeAt

      public T derivativeAt(T out, int span, double u)
      Returns:
      The derivative of the spline at position u of the specified span
    • nearest

      public int nearest(T in)
      Returns:
      The span closest to the specified value
    • nearest

      public int nearest(T in, int start, int count)
      Returns:
      The span closest to the specified value, restricting to the specified spans.
    • approximate

      public double approximate(T v)
      Specified by:
      approximate in interface Pathd<T extends Vectord<T>>
      Returns:
      The approximated value (between 0 and 1) on the path which is closest to the specified value. Note that the implementation of this method might be optimized for speed against precision, see Pathd.locate(Object) for a more precise (but more intensive) method.
    • approximate

      public double approximate(T in, int start, int count)
    • approximate

      public double approximate(T in, int near)
    • locate

      public double locate(T v)
      Specified by:
      locate in interface Pathd<T extends Vectord<T>>
      Returns:
      The precise location (between 0 and 1) on the path which is closest to the specified value. Note that the implementation of this method might be CPU intensive, see Pathd.approximate(Object) for a faster (but less precise) method.
    • approxLength

      public double approxLength(int samples)
      Specified by:
      approxLength in interface Pathd<T extends Vectord<T>>
      Parameters:
      samples - The amount of divisions used to approximate length. Higher values will produce more precise results, but will be more CPU intensive.
      Returns:
      An approximated length of the spline through sampling the curve and accumulating the euclidean distances between the sample points.