BansheeEngine/Source/BansheeCore/Include/BsAnimationClip.h

//********************************** Banshee Engine (www.banshee3d.com) **************************************************//
//**************** Copyright (c) 2016 Marko Pintera ([email protected]). All rights reserved. **********************//
#pragma once

#include "BsCorePrerequisites.h"
#include "BsResource.h"
#include "BsVector3.h"
#include "BsQuaternion.h"
#include "BsAnimationCurve.h"

namespace BansheeEngine
{
	/** @addtogroup Animation
	 *  @{
	 */

	/** A set of animation curves representing translation/rotation/scale and generic animation. */
	struct AnimationCurves
	{
		Vector<TNamedAnimationCurve<Vector3>> position;
		Vector<TNamedAnimationCurve<Quaternion>> rotation;
		Vector<TNamedAnimationCurve<Vector3>> scale;
		Vector<TNamedAnimationCurve<float>> generic;
	};

	class BS_CORE_EXPORT AnimationClip : public Resource
	{
	public:
		virtual ~AnimationClip() { }

		/** 
		 * Registers a new curve used for animating position. 
		 *
		 * @param[in]	name		Unique name of the curve. This name will be used mapping the curve to the relevant bone
		 *							in a skeleton, if any.
		 * @param[in]	curve		Curve to add to the clip.
		 *
		 * @note Adding a new curve to a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void addPositionCurve(const String& name, const TAnimationCurve<Vector3>& curve);

		/** 
		 * Registers a new curve used for animating rotation. 
		 *
		 * @param[in]	name		Unique name of the curve. This name will be used mapping the curve to the relevant bone
		 *							in a skeleton, if any.
		 * @param[in]	curve		Curve to add to the clip.
		 *
		 * @note Adding a new curve to a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void addRotationCurve(const String& name, const TAnimationCurve<Quaternion>& curve);

		/** 
		 * Registers a new curve used for animating scale. 
		 *
		 * @param[in]	name		Unique name of the curve. This name will be used mapping the curve to the relevant bone
		 *							in a skeleton, if any.
		 * @param[in]	curve		Curve to add to the clip.
		 *
		 * @note Adding a new curve to a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void addScaleCurve(const String& name, const TAnimationCurve<Vector3>& curve);

		/** 
		 * Registers a new curve used for generic animation.
		 *
		 * @param[in]	name		Unique name of the curve. This can be used for retrieving the value of the curve
		 *							from animation.
		 * @param[in]	curve		Curve to add to the clip.
		 *
		 * @note Adding a new curve to a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void addGenericCurve(const String& name, const TAnimationCurve<float>& curve);

		/**
		 * Removes an existing curve from the clip.
		 *
		 * @param[in]	name	Name of the curve to remove.
		 *
		 * @note Removing curve from a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void removePositionCurve(const String& name);

		/**
		 * Removes an existing curve from the clip.
		 *
		 * @param[in]	name	Name of the curve to remove.
		 *
		 * @note Removing curve from a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void removeRotationCurve(const String& name);

		/**
		 * Removes an existing curve from the clip.
		 *
		 * @param[in]	name	Name of the curve to remove.
		 *
		 * @note Removing curve from a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void removeScaleCurve(const String& name);

		/**
		 * Removes an existing curve from the clip.
		 *
		 * @param[in]	name	Name of the curve to remove.
		 *
		 * @note Removing curve from a clip is a relatively slow operations and shouldn't be done at runtime.
		 */
		void removeGenericCurve(const String& name);

		/** 
		 * Creates an animation clip with no curves. After creation make sure to register some animation curves before
		 * using it. 
		 */
		static HAnimationClip create();

		/** 
		 * Creates an animation clip with specified curves.
		 *
		 * @param[in]	curves	Curves to initialize the animation with.
		 */
		static HAnimationClip create(const SPtr<AnimationCurves>& curves);

	public: // ***** INTERNAL ******
		/** @name Internal
		 *  @{
		 */

		/** Creates a new AnimationClip without initializing it. Use create() for normal use. */
		static SPtr<AnimationClip> _createPtr(const SPtr<AnimationCurves>& curves);

		/** @} */

	protected:
		AnimationClip();
		AnimationClip(const SPtr<AnimationCurves>& curves);

		/** 
		 * Contains all the animation curves in the clip. It's important this field is immutable so it may be used on other
		 * threads. This means any modifications to the field will require a brand new data structure to be generated and
		 * all existing data copied (plus the modification).
		 */
		SPtr<AnimationCurves> mCurves;

		/************************************************************************/
		/* 								SERIALIZATION                      		*/
		/************************************************************************/
	public:
		friend class AnimationClipRTTI;
		static RTTITypeBase* getRTTIStatic();
		RTTITypeBase* getRTTI() const override;

		/** 
		 * Creates an AnimationClip with no data. You must populate its data manually followed by a call to initialize().
		 *
		 * @note	For serialization use only.
		 */
		static SPtr<AnimationClip> createEmpty();
	};

	/** @} */
}