HBhvInterpolatorVertexMorph

Functions

HBhvInterpolatorVertexMorph

~HBhvInterpolatorVertexMorph

char const *

GetType

HBhvInterpolator *

CreateInstance

void

Insert

void

InsertDiscrete

void

Replace

void

Serialize

void

Interpolate

void

AddMorphData

VArray< void * >

GetMorphData

int

GetMorphDataLength

void *

XMLCallback

Detailed Description

class HBhvInterpolatorVertexMorph : public HBhvInterpolator

The HBhvInterpolatorVertexMorph class performs interpolation by interpolating the individual vertex parameters of an object. The result of the animation is that object changes shape but retains the same set of vertices.

Public Functions

HBhvInterpolatorVertexMorph(HBhvAnimation *animation = 0, char const *name = 0)

Constructs an HBhvInterpolatorVertexMorph object.

Parameters

  • animation – The animation that this interpolator belongs to.

  • name – The name of the interpolator.

~HBhvInterpolatorVertexMorph()
virtual char const *GetType()
Returns

The type of the interpolator ‘VertexMorph’.

virtual HBhvInterpolator *CreateInstance(HBhvAnimation *ainst)

In special cases, you may want an interpolator that references this interpolator without changing it. Use this method to create the new interpolator passing a pointer to the animation that you want it to be associated with.

Parameters

ainst – The animation instance that this interpolator is associated with.

Returns

The newly created interpolator that references this interpolator.

inline void Insert(char *mident, int l = 0)

This method creates a new keyframe with the passed Morph Data position index and then inserts it after the passed position l into the keyframe array. To use this method, you must first add your vertex position information to the Morph Data using AddMorphData(). Once you have done that, note the position index that your vertex information was added to the Morph Data array. This will be the value of the parameter mident.

Parameters

  • mident – The Morph Data position index to your vertex array to use for the new keyframe. Note that although the index is an int, you can use itoa() to convert the index position.

  • l – The array position to insert item after.

inline void InsertDiscrete(char *mident, int l = 0)
inline void Replace(char *t, int l)

Replaces the item at the given position in the keyframe array with a new keyframe that was created with the passed morph identifier. To use this method, you must first add your vertex position information to the Morph Data using AddMorphData(). Once you have done that, note the position index that your vertex information was added to the Morph Data array. This will be the value of the parameter t.

Parameters

  • t – The Morph Data position index to your vertex array to use for the replace keyframe. Note that although the index is an int, you can use itoa() to convert the index position.

  • l – The array position to replace.

virtual void Serialize(HUtilityXMLGenerator *xmlgen)

Writes XML data to a buffer using the passed XML generator.

virtual void Interpolate(int keyframe, float fraction)

Performs an interpolation on the animation target.

Parameters

  • keyframe – The reference keyframe for this interpolation.

  • fraction – The fraction value from the specified keyframe to the next keyframe. The value is from 0 to 1.

virtual void AddMorphData(HPoint *md, int pnum, HBaseModel *model, int pos = -1)

This method adds a point array to morph data array. Use this method to morph your data so that it can be added to the keyframe array for this interpolator. Note Insert() and Replace() take the morph data in the form of its indexed position in the Morph Data array.

Parameters

  • md – Array of Points

  • pnum – Number of points in array

  • model – A pointer to the base model. The Point array is stored as a shell in a special MorphData segment underneath the model segment

  • pos – Optional index into the Morph Data array which indicates where to put the point array

inline VArray<void*> GetMorphData()
Returns

A pointer to the morph data array.

inline int GetMorphDataLength()
Returns

The number of entries in the morph data array.

Public Static Functions

static void *XMLCallback(HUtilityXMLTag *xt, bool open, void *m_pExtraData)

This is XML read callback which parses XML data and then populates the member variables with the associated values.