Method AddKey

trinity/Include/Tr2Curve.h:185–271

template <class Key, class KeyList, class KeyValue>
int Tr2CurveBase<Key, KeyList, KeyValue>::AddKey( float time, const KeyValue& value )
{
	// This function should return the index of the key where it was added to m_keys
	// If the time is already in a key and thus the key's value is updated for that time
	// return the index of the updated key.
	// Otherwise, if no key was added, it returns -1.
	int keyIndex = -1;

	// Key at zero is the start point
	if( time == 0.0f )
	{
		m_startValue = value;
		return keyIndex;
	}

	// time at the end point is the end key
	if( time == m_length )
	{
		m_endValue = value;
		return keyIndex;
	}

	// If there are no keys, the sorting will not fix the curve
	// Therefor, we have to create a new key at current endpoint and then move the endpoint
	// to the new value.
	if( m_keys.empty() )
	{
		if( time > m_length )
		{
			if( m_length > 0.0f )
			{
				// Need to create a new key here using the current endpoint value
				AddKey_( m_length, m_endValue );

				// We know that we have 1 and only 1 key in m_keys.
				keyIndex = 0;
			}

			// Update end value
			m_length = time;
			m_endValue = value;

			// If keyIndex == -1 =>
			// We got a time value > 0 for a curve of zero length
			// Thus, we have shifted the length to that time value
			// and updated the end value accordingly.
			if( keyIndex == -1 )
			{
				return keyIndex;
			}
		}
		else
		{
			// If we are between the begin and end.
			AddKey_( time, value );
			return 0;
		}
	}