NCollection_Lerp< T > Class Template Reference

Simple linear interpolation tool (also known as mix() in GLSL). The main purpose of this template class is making interpolation routines more readable. More...

#include <NCollection_Lerp.hxx>

Public Member Functions
	NCollection_Lerp ()
	Empty constructor. More...
	NCollection_Lerp (const T &theStart, const T &theEnd)
	Main constructor. More...
void	Init (const T &theStart, const T &theEnd)
	Initialize values. More...
void	Interpolate (double theT, T &theResult) const
	Compute interpolated value between two values. More...
template<>
void	Interpolate (const double theT, Handle< Graphic3d_Camera > &theResult) const
	Linear interpolation tool for camera orientation and position. This tool interpolates camera parameters scale, eye, center, rotation (up and direction vectors) independently. More...

Static Public Member Functions
static T	Interpolate (const T &theStart, const T &theEnd, double theT)
	Compute interpolated value between two values. More...

Detailed Description

template<class T>
class NCollection_Lerp< T >

Simple linear interpolation tool (also known as mix() in GLSL). The main purpose of this template class is making interpolation routines more readable.

Constructor & Destructor Documentation

NCollection_Lerp() [1/2]

template<class T>

NCollection_Lerp< T >::NCollection_Lerp ( )

inline

Empty constructor.

NCollection_Lerp() [2/2]

template<class T>

NCollection_Lerp< T >::NCollection_Lerp ( const T &  theStart, const T &  theEnd  )

inline

Main constructor.

Member Function Documentation

Init()

template<class T>

void NCollection_Lerp< T >::Init ( const T &  theStart, const T &  theEnd  )

inline

Initialize values.

Interpolate() [1/3]

template<class T>

static T NCollection_Lerp< T >::Interpolate ( const T &  theStart, const T &  theEnd, double  theT  )

inlinestatic

Compute interpolated value between two values.

Parameters

theStart	first value
theEnd	second value
theT	normalized interpolation coefficient within [0, 1] range, with 0 pointing to theStart and 1 to theEnd.

Interpolate() [2/3]

template<class T>

void NCollection_Lerp< T >::Interpolate ( double  theT, T &  theResult  ) const

inline

Compute interpolated value between two values.

Parameters

theT	normalized interpolation coefficient within [0, 1] range, with 0 pointing to first value and 1 to the second value.
theResult	[out] interpolated value

Interpolate() [3/3]

template<>

void NCollection_Lerp< Handle< Graphic3d_Camera > >::Interpolate	(	const double	theT,
		Handle< Graphic3d_Camera > &	theResult
	)		const

Linear interpolation tool for camera orientation and position. This tool interpolates camera parameters scale, eye, center, rotation (up and direction vectors) independently.

Eye/Center interpolation is performed through defining an anchor point in-between Center and Eye. The anchor position is defined as point near to the camera point which has smaller translation part. The main idea is to keep the distance between Center and Eye (which will change if Center and Eye translation will be interpolated independently). E.g.:

• When both Center and Eye are moved at the same vector -> both will be just translated by straight line
• When Center is not moved -> camera Eye will move around Center through arc
• When Eye is not moved -> camera Center will move around Eye through arc
• When both Center and Eye are move by different vectors -> transformation will be something in between, and will try interpolate linearly the distance between Center and Eye.

This transformation might be not in line with user expectations. In this case, application might define intermediate camera positions for interpolation or implement own interpolation logic.

---

The documentation for this class was generated from the following file:

• NCollection_Lerp.hxx