Infinity::Types::Spatial::Spline4D Class Reference

Four-dimensional spline curve for extended parameter space interpolation. More...

#include <Spline.hpp>

Inheritance diagram for Infinity::Types::Spatial::Spline4D:

Collaboration diagram for Infinity::Types::Spatial::Spline4D:

Public Types
using	Vec = Math::Vector4

Public Member Functions
	Spline4D ()
	Default constructor.
	Spline4D (SplineKind kind)
	Constructs a spline with specified interpolation type.
	Spline4D (const Spline4D &other)
	Copy constructor.
	~Spline4D ()
	Destructor.
Spline4D &	operator= (const Spline4D &other)
	Copy assignment operator.
Vec	evaluate (float t) const
	Evaluates the spline position at parameter t.
Vec	tangent (float t) const
	Computes the tangent vector at parameter t.
void	setCurveKind (SplineKind kind)
	Changes the spline interpolation type.
SplineKind	type () const
	Gets the current spline interpolation type.
const Infinity::Types::TypeID &	typeId () const override
	Gets the TypeID for Spline4D.
Public Member Functions inherited from Infinity::Types::Core::Data
	Data ()
	Data (const Data &other)
	Data (Data &&other)
Data &	operator= (const Data &other)
Data &	operator= (Data &&other)
std::unique_ptr< Base >	clone () const override
virtual	~Data ()
	Virtual destructor.
bool	hasProperty (const std::string &key) const
template<typename T >
void	setProperty (const std::string &key, T &&value)
	Sets a typed property value.
template<typename T >
void	setProperty (const std::string &key, const T &value)
	Sets a typed property value.
void	setProperty (const std::string &key, PropertyValue &&value)
	Sets a typed property value.
const PropertyValue &	getProperty (const std::string &key) const
	Gets a property value without type checking.
template<typename T >
const T &	getProperty (const std::string &key) const
	Gets a typed property value.
void	removeProperty (const std::string &key)
Public Member Functions inherited from Infinity::Types::Core::Base
virtual	~Base ()
	Virtual destructor.
virtual std::istream &	legibleDataRead (std::istream &in) override
	Deserializes the object from a single-line text representation.
virtual std::ostream &	legibleDataWrite (std::ostream &out) const override
	Serializes the object to a single-line text representation.

Public Attributes
Containers::Array< Vec >	points
	Control points defining the spline curve.
Public Attributes inherited from Infinity::Types::Core::Data
std::unordered_map< std::string, PropertyValue >	properties
	Property storage for arbitrary metadata.

Detailed Description

Four-dimensional spline curve for extended parameter space interpolation.

Spline4D provides smooth curve interpolation through 4D control points using various mathematical methods (Bezier, Catmull-Rom, B-Spline, or Linear). While less common than 2D/3D splines, it is useful for:

• Color animation paths (RGBA over time)
• Quaternion interpolation paths (when represented as 4-vectors)
• Combined spatial + parameter curves (position + intensity/temperature/etc.)
• Homogeneous coordinate paths
• Multi-parameter procedural animation

The spline can be evaluated at any parametric position t ∈ [0, 1] to obtain interpolated 4D positions and tangent vectors.

Note

The parameter t is normalized: 0 = start of curve, 1 = end of curve.

Tangent vectors are not normalized.

For quaternion interpolation, consider using dedicated slerp/squad methods instead.

Example usage:

// Create a color animation path (RGBA)
Spline4D colorPath(SplineKind::CatmullRom);
colorPath.points.push_back(Vector4{1.0f, 0.0f, 0.0f, 1.0f}); // Red
colorPath.points.push_back(Vector4{1.0f, 1.0f, 0.0f, 1.0f}); // Yellow
colorPath.points.push_back(Vector4{0.0f, 1.0f, 0.0f, 1.0f}); // Green
colorPath.points.push_back(Vector4{0.0f, 0.0f, 1.0f, 1.0f}); // Blue
 
// Evaluate color at different times
Vector4 color = colorPath.evaluate(0.5f);
 
// Use with ProceduralSystem
system->setIn("color_gradient", std::move(colorPath));

Member Typedef Documentation

Vec

using Infinity::Types::Spatial::Spline4D::Vec = Math::Vector4

Constructor & Destructor Documentation

Spline4D() [1/3]

Infinity::Types::Spatial::Spline4D::Spline4D

(

)

Default constructor.

Creates an empty spline with Bezier interpolation.

Spline4D() [2/3]

Infinity::Types::Spatial::Spline4D::Spline4D ( SplineKind  kind )

explicit

Constructs a spline with specified interpolation type.

Parameters

kind	Interpolation method to use (Bezier, CatmullRom, BSpline, or Linear).

Spline4D() [3/3]

Infinity::Types::Spatial::Spline4D::Spline4D

(

const Spline4D &

other

)

Copy constructor.

Creates a deep copy of the spline, including all control points and settings.

Parameters

other

Spline to copy from.

~Spline4D()

Infinity::Types::Spatial::Spline4D::~Spline4D

(

)

Destructor.

Member Function Documentation

evaluate()

Vec Infinity::Types::Spatial::Spline4D::evaluate

(

float

t

)

const

Evaluates the spline position at parameter t.

Computes the interpolated 4D position on the curve.

Parameters

t	Parameter value in range [0, 1].

Returns

Interpolated 4D position on the curve.

operator=()

Spline4D & Infinity::Types::Spatial::Spline4D::operator=

(

const Spline4D &

other

)

Copy assignment operator.

Parameters

other

Spline to copy from.

Returns

Reference to this spline.

setCurveKind()

void Infinity::Types::Spatial::Spline4D::setCurveKind

(

SplineKind

kind

)

Changes the spline interpolation type.

Parameters

kind	New interpolation method to use.

tangent()

Vec Infinity::Types::Spatial::Spline4D::tangent

(

float

t

)

const

Computes the tangent vector at parameter t.

Calculates the 4D derivative of the curve.

Parameters

t	Parameter value in range [0, 1].

Returns

4D tangent vector at the specified position.

Note

The tangent vector is NOT normalized.

type()

SplineKind Infinity::Types::Spatial::Spline4D::type

(

)

const

Gets the current spline interpolation type.

Returns

Current SplineKind being used for interpolation.

typeId()

const Infinity::Types::TypeID & Infinity::Types::Spatial::Spline4D::typeId ( ) const

overridevirtual

Gets the TypeID for Spline4D.

Returns

TypeID identifying this Spline4D type.

Reimplemented from Infinity::Types::Core::Data.

Member Data Documentation

points

Containers::Array<Vec> Infinity::Types::Spatial::Spline4D::points

Control points defining the spline curve.

Public array of Vector4 control points that define the curve shape. Modify this array directly to change the spline geometry.