|
HDK
|
Specifies the value of an TsSpline object at a particular point in time. More...
#include <keyFrame.h>
Public Member Functions | |
| TS_API | TsKeyFrame () |
| Constructs a default double keyframe. More... | |
| TS_API | ~TsKeyFrame () |
| Non-virtual destructor; this class should not be subclassed. More... | |
Constructors | |
There are four variations on the constructor, to support single-valued or dual-valued keyframes, with values supplied as either VtValues or a template parameter. | |
| template<typename T > | |
| TsKeyFrame (const TsTime &time, const T &val, TsKnotType knotType=TsKnotLinear, const T &leftTangentSlope=TsTraits< T >::zero, const T &rightTangentSlope=TsTraits< T >::zero, TsTime leftTangentLength=0, TsTime rightTangentLength=0) | |
| Constructs a single-valued keyframe. More... | |
| TS_API | TsKeyFrame (const TsTime &time, const VtValue &val, TsKnotType knotType=TsKnotLinear, const VtValue &leftTangentSlope=VtValue(), const VtValue &rightTangentSlope=VtValue(), TsTime leftTangentLength=0, TsTime rightTangentLength=0) |
| Constructs a single-valued keyframe with VtValues. More... | |
| template<typename T > | |
| TsKeyFrame (const TsTime &time, const T &lhv, const T &rhv, TsKnotType knotType=TsKnotLinear, const T &leftTangentSlope=TsTraits< T >::zero, const T &rightTangentSlope=TsTraits< T >::zero, TsTime leftTangentLength=0, TsTime rightTangentLength=0) | |
| Constructs a dual-valued keyframe. More... | |
| TS_API | TsKeyFrame (const TsTime &time, const VtValue &lhv, const VtValue &rhv, TsKnotType knotType=TsKnotLinear, const VtValue &leftTangentSlope=VtValue(), const VtValue &rightTangentSlope=VtValue(), TsTime leftTangentLength=0, TsTime rightTangentLength=0) |
| Constructs a dual-valued keyframe with VtValues. More... | |
| TS_API | TsKeyFrame (const TsKeyFrame &kf) |
| Constructs a keyframe by duplicating an existing TsKeyFrame. More... | |
Primary API | |
| TS_API TsKeyFrame & | operator= (const TsKeyFrame &rhs) |
| Assignment operator. More... | |
| TS_API bool | operator== (const TsKeyFrame &) const |
| Compare this keyframe with another. More... | |
| TS_API bool | operator!= (const TsKeyFrame &) const |
| Assignment operator. More... | |
| TS_API bool | IsEquivalentAtSide (const TsKeyFrame &keyFrame, TsSide side) const |
| TS_API TsTime | GetTime () const |
| Gets the time of this keyframe. More... | |
| TS_API void | SetTime (const TsTime &newTime) |
| Sets the time of this keyframe. More... | |
| TS_API VtValue | GetValue () const |
| Gets the value at this keyframe. More... | |
| TS_API void | SetValue (VtValue val) |
| Sets the value at this keyframe. More... | |
| TS_API VtValue | GetValue (TsSide side) const |
| Gets the value at this keyframe on the given side. More... | |
| TS_API void | SetValue (VtValue val, TsSide side) |
| Sets the value at this keyframe on the given side. More... | |
| TS_API VtValue | GetValueDerivative () const |
| Gets the value of the derivative at this keyframe. More... | |
| TS_API VtValue | GetZero () const |
| Gets a zero for this keyframe's value type. More... | |
| TS_API TsKnotType | GetKnotType () const |
| Gets the knot type. More... | |
| TS_API void | SetKnotType (TsKnotType knotType) |
| Sets the knot type. More... | |
| TS_API bool | CanSetKnotType (TsKnotType, std::string *reason=NULL) const |
Dual-value API | |
Keyframes have a "left side" and a "right side". The right side is conceptually later than the left, even though they occur at the same time. The two sides most often have the same value, but it is also possible for the two sides to have different values. The purpose of having different values on the two sides is to allow instantaneous value discontinuities. This is useful, for example, when a constraint changes, and the meaning of another property (like an IkTx) instantaneously changes because of the constraint switch. Most spline evaluation takes place on the right side. Calling GetValue returns the sole value for a single-valued keyframe, and the right value for a double-valued keyframe. Note the difference between, on the one hand, asking a keyframe for its left value; and on the other hand, evaluating a spline at the left side of that keyframe's time. Usually these two methods agree. But when a keyframe is preceded by a held segment, spline evaluation at the keyframe's left side will yield the held value from the prior segment, but the keyframe itself knows nothing about the prior segment, so GetLeftValue returns the left value stored in the keyframe (which is the right value for a single-valued knot). Another way to look at this situation is that, when a keyframe B is preceded by a held keyframe A, the left value of B is never consulted in spline evaluation. This arrangement ensures that the instantaneous value change at the end of a held segment occurs exactly at the time of the keyframe that ends the segment. Note also the difference between GetIsDualValued and TsSpline::DoSidesDiffer. Usually these two methods agree. But in the after-held-knot case described above, they do not. They also do not agree when SetIsDualValued(true) has been called, but the keyframe has the same value on both sides. | |
| TS_API bool | GetIsDualValued () const |
| TS_API void | SetIsDualValued (bool isDual) |
| TS_API VtValue | GetLeftValue () const |
| TS_API void | SetLeftValue (VtValue val) |
| TS_API VtValue | GetLeftValueDerivative () const |
Specifies the value of an TsSpline object at a particular point in time.
Keyframes also specify the shape of a spline as it passes through each keyframe: the knot type specifies what interpolation technique to use (TsKnotHeld, TsKnotLinear, or TsKnotBezier), and tangent handles specify the shape of the spline as it passes through the keyframe.
It is also possible for keyframes to be "dual-valued." This means that a separate keyframe value – the left-side value – is used when approaching the keyframe from lower time values. The regular value is then used starting at the keyframe's time and when approaching that time from higher times to the right. Dual-value knots are necessary to compensate for instantaneous shifts in coordinate frames, such as the shift that occurs when there is a constraint switch. The spline can snap to the new value required to maintain the same position in worldspace.
Note: TsKeyFrame is a value, not a formal object.
Definition at line 66 of file keyFrame.h.
| TS_API TsKeyFrame::TsKeyFrame | ( | ) |
Constructs a default double keyframe.
| TsKeyFrame::TsKeyFrame | ( | const TsTime & | time, |
| const T & | val, | ||
| TsKnotType | knotType = TsKnotLinear, |
||
| const T & | leftTangentSlope = TsTraits<T>::zero, |
||
| const T & | rightTangentSlope = TsTraits<T>::zero, |
||
| TsTime | leftTangentLength = 0, |
||
| TsTime | rightTangentLength = 0 |
||
| ) |
Constructs a single-valued keyframe.
Definition at line 402 of file keyFrame.h.
| TS_API TsKeyFrame::TsKeyFrame | ( | const TsTime & | time, |
| const VtValue & | val, | ||
| TsKnotType | knotType = TsKnotLinear, |
||
| const VtValue & | leftTangentSlope = VtValue(), |
||
| const VtValue & | rightTangentSlope = VtValue(), |
||
| TsTime | leftTangentLength = 0, |
||
| TsTime | rightTangentLength = 0 |
||
| ) |
Constructs a single-valued keyframe with VtValues.
| TsKeyFrame::TsKeyFrame | ( | const TsTime & | time, |
| const T & | lhv, | ||
| const T & | rhv, | ||
| TsKnotType | knotType = TsKnotLinear, |
||
| const T & | leftTangentSlope = TsTraits<T>::zero, |
||
| const T & | rightTangentSlope = TsTraits<T>::zero, |
||
| TsTime | leftTangentLength = 0, |
||
| TsTime | rightTangentLength = 0 |
||
| ) |
Constructs a dual-valued keyframe.
Definition at line 420 of file keyFrame.h.
| TS_API TsKeyFrame::TsKeyFrame | ( | const TsTime & | time, |
| const VtValue & | lhv, | ||
| const VtValue & | rhv, | ||
| TsKnotType | knotType = TsKnotLinear, |
||
| const VtValue & | leftTangentSlope = VtValue(), |
||
| const VtValue & | rightTangentSlope = VtValue(), |
||
| TsTime | leftTangentLength = 0, |
||
| TsTime | rightTangentLength = 0 |
||
| ) |
Constructs a dual-valued keyframe with VtValues.
| TS_API TsKeyFrame::TsKeyFrame | ( | const TsKeyFrame & | kf | ) |
Constructs a keyframe by duplicating an existing TsKeyFrame.
| TS_API TsKeyFrame::~TsKeyFrame | ( | ) |
Non-virtual destructor; this class should not be subclassed.
| TS_API bool TsKeyFrame::CanSetKnotType | ( | TsKnotType | , |
| std::string * | reason = NULL |
||
| ) | const |
Checks whether the key frame's value type supports the given knot type.
| TS_API bool TsKeyFrame::GetIsDualValued | ( | ) | const |
Gets whether this knot is dual-valued. See the note above about TsSpline::DoSidesDiffer.
| TS_API TsKnotType TsKeyFrame::GetKnotType | ( | ) | const |
Gets the knot type.
Gets the length of the projection of the knot's left tangent onto the time axis.
Gets the left-side tangent slope (in units per frame) of this knot.
Gets the left value of this dual-valued knot. Returns the right value if this is not a dual-valued knot.
Gets the value of the derivative on the left side. This is a synonym for GetLeftTangentSlope for knot types that support tangents; for other types, this method returns zero.
Gets the length of the projection of the knot's right tangent onto the time axis.
Gets the right-side tangent slope (in units per frame) of this knot.
| TS_API bool TsKeyFrame::GetTangentSymmetryBroken | ( | ) | const |
Gets whether tangent symmetry has been broken. In this context, "symmetric" refers to the tangents having equal slope but not necessarily equal length.
If tangent symmetry is broken, tangent handles will not automatically stay symmetric as they are changed.
Gets the time of this keyframe.
Definition at line 156 of file keyFrame.h.
Gets the value at this keyframe on the given side.
Gets the value of the derivative at this keyframe.
| TS_API bool TsKeyFrame::HasTangents | ( | ) | const |
Gets whether the knot of this keyframe has tangents. This is true when the value type supports tangents, and the knot is a Bezier.
| TS_API bool TsKeyFrame::IsEquivalentAtSide | ( | const TsKeyFrame & | keyFrame, |
| TsSide | side | ||
| ) | const |
Gets whether this key frame is at the same time and is equivalent to keyFrame on the given side. In other words, replacing this key frame with keyFrame in a spline will have no effect on how the spline evaluates for any time on the given side of this key frame.
| TS_API bool TsKeyFrame::IsExtrapolatable | ( | ) | const |
Gets whether the value type of this keyframe is extrapolatable. This means that a slope can be computed from the line between two knots of this knot's value type.
| TS_API bool TsKeyFrame::IsInterpolatable | ( | ) | const |
Gets whether the value type of this keyframe is interpolatable.
| TS_API bool TsKeyFrame::operator!= | ( | const TsKeyFrame & | ) | const |
Assignment operator.
| TS_API TsKeyFrame& TsKeyFrame::operator= | ( | const TsKeyFrame & | rhs | ) |
Assignment operator.
| TS_API bool TsKeyFrame::operator== | ( | const TsKeyFrame & | ) | const |
Compare this keyframe with another.
Sets the flag that enforces tangent symmetry based on whether the tangets are already symmetric. If they are symmetric, the 'broken' flag will be cleared so that future edits maintain symmetry. If they are not symmetric, they will be marked as 'broken'.
The intent is to help provide policy for newly received tangent data: if the tangents happen to be symmetric, keep them so; but if they are asymmetric, don't bother. Issues a coding error if this knot does not support tangents.
Sets whether this knot is dual-valued. When a knot is first made dual-valued, the left value is copied from the right value.
| TS_API void TsKeyFrame::SetKnotType | ( | TsKnotType | knotType | ) |
Sets the knot type.
Sets the left-side tangent length (in time) of this knot. Issues a coding error if this knot does not support tangents
Sets the left-side tangent slope (in units per frame) of this knot. Issues a coding error if this knot does not support tangents
Sets the left value of this dual-valued knot. It is an error to call this method on single-valued knots.
Sets the right-side tangent length (in time) of this knot. Issues a coding error if this knot does not support tangents
Sets the right-side tangent slope (in units per frame) of this knot. Issues a coding error if this knot does not support tangents
Sets whether tangent symmetry is broken. Setting this to false will make the tangents symmetric if they are not already by reflecting the right tangent to the left side. Issues a coding error if this knot does not support tangents
Sets the time of this keyframe.
Definition at line 162 of file keyFrame.h.
Sets the value at this keyframe on the given side.
| TS_API bool TsKeyFrame::SupportsTangents | ( | ) | const |
Gets whether the value type of this keyframe supports tangents. This will return true not only for Bezier, but also for Linear and Held, because when authors switch from Bezier to Linear/Held and back to Bezier, we want to preserve the original tangents, and thus we track tangent data for Linear and Held knots. If you really want to write just to Beziers, call HasTangents().
|
friend |
Gets whether the value type of this keyframe is interpolatable.
|
friend |
Gets whether the value type of this keyframe is interpolatable.
1.8.6 
