CatmullRomSegment3F Class

Defines a single segment of a 3-dimensional cubic Catmull-Rom spline (single-precision).

Inheritance Hierarchy

SystemObject
DigitalRune.Mathematics.InterpolationCatmullRomSegment3F

Namespace: DigitalRune.Mathematics.Interpolation
Assembly: DigitalRune.Mathematics (in DigitalRune.Mathematics.dll) Version: 1.14.0.0 (1.14.0.14427)

Syntax

C++

Copy

public class CatmullRomSegment3F : ICurve<float, Vector3F>, 
	IRecyclable

Public Class CatmullRomSegment3F
	Implements ICurve(Of Single, Vector3F), 
	IRecyclable

public ref class CatmullRomSegment3F : ICurve<float, Vector3F>, 
	IRecyclable

type CatmullRomSegment3F =  
    class
        interface ICurve<float32, Vector3F>
        interface IRecyclable
    end

The CatmullRomSegment3F type exposes the following members.

Constructors

	Name	Description
	CatmullRomSegment3F	Initializes a new instance of the CatmullRomSegment3F class

Top

Methods

	Name	Description
	Create	Creates an instance of the CatmullRomSegment3F class. (This method reuses a previously recycled instance or allocates a new instance if necessary.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	Flatten	Computes the points of a sequence of line segments which approximate the curve.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLength	Computes the approximated length of the curve for the parameter interval [start, end].
	GetPoint	Computes a point on the curve.
	GetTangent	Computes the tangent for a point on the curve.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Recycle	Recycles this instance.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Properties

	Name	Description
	Point1	Gets or sets the previous point.
	Point2	Gets or sets the start point.
	Point3	Gets or sets the end point.
	Point4	Gets or sets the subsequent point.

Top

Remarks

A CatmullRomSegment3F can be used to smoothly interpolate between two points.

Given a series of points (Point1, Point2, Point3, Point4) this method performs a smooth interpolation between the points Point2 and Point3. The interpolation curve is known as Catmull-Rom spline. The curve (spline) is a specialization of the cubic Hermit spline. The curve runs through the control points Point2 and Point3. The tangent at each point is the average of the slope from the previous point and the slope to the next point.

The Catmull-Rom spline is defined as:

C(u) = ((-u³ + 2 u² - u) p₁ + (3 u³ - 5 u² + 2) p₂ + (-3 u³ + 4 u² + u) p₃ + (u³ - u²) p₄ )/ 2

where u is the interpolation parameter.

The curve function point = C(parameter) takes a scalar parameter and returns a point on the curve (see GetPoint(Single)). The curve parameter lies in the interval [0,1]; it is also known as interpolation parameter, interpolation factor or weight of the target point. C(0) returns the start point Point2; C(1) returns the end point Point3.

Reference

DigitalRune.Mathematics.Interpolation Namespace