Blob Blame Raw


#ifndef PLASTICSKELETONDEFORMATION_H
#define PLASTICSKELETONDEFORMATION_H

// TnzCore includes
#include "tsmartpointer.h"
#include "tdoubleparam.h"
#include "tdoublekeyframe.h"

// TnzExt includes
#include "ext/plastichandle.h"
#include "ext/plasticskeleton.h"

// tcg includes
#include "tcg/tcg_any_iterator.h"

// Qt includes
#include <QString>

#undef DVAPI
#undef DVVAR
#ifdef TNZEXT_EXPORTS
#define DVAPI DV_EXPORT_API
#define DVVAR DV_EXPORT_VAR
#else
#define DVAPI DV_IMPORT_API
#define DVVAR DV_IMPORT_VAR
#endif

//====================================================

//    Forward declarations

class ParamsObserver;
class ParamChange;

//====================================================

//**************************************************************************************
//    PlasticSkeletonVertexDeformation  declaration
//**************************************************************************************

//! The deformation of a plastic skeleton vertex.
typedef struct DVAPI PlasticSkeletonVertexDeformation : public TPersist {
	PERSIST_DECLARATION(PlasticSkeletonVertexDeformation)

public:
	enum Params {
		ANGLE = 0, //!< Distance from parent vertex (delta)
		DISTANCE,  //!< Angle with parent edge (delta)
		SO,		   //!< Vertex's stacking order
		PARAMS_COUNT
	};

	struct Keyframe {
		TDoubleKeyframe m_keyframes[PARAMS_COUNT];
	};

public:
	TDoubleParamP m_params[PARAMS_COUNT];

public:
	Keyframe getKeyframe(double frame) const;

	void setKeyframe(double frame);
	bool setKeyframe(const Keyframe &values);
	bool setKeyframe(const Keyframe &values, double frame,
					 double easeIn = -1.0, double easeOut = -1.0);

	bool isKeyframe(double frame) const;
	bool isFullKeyframe(double frame) const;
	void deleteKeyframe(double frame);

	void saveData(TOStream &os);
	void loadData(TIStream &is);

} SkVD;

//**************************************************************************************
//    PlasticSkeletonDeformationKeyframe  declaration
//**************************************************************************************

//! The keyframe of a plastic skeleton vertex deformation.
/*!
  \note A deformation keyframe stores vertex deformation keyframes by vertex \a names.
  This is the approach we use to deal with keyframe pasting to different skeletons.
*/
typedef struct PlasticSkeletonDeformationKeyframe {
	std::map<QString, SkVD::Keyframe> m_vertexKeyframes; //!< Keyframes by vertex \a name
	TDoubleKeyframe m_skelIdKeyframe;					 //!< Skeleton id keyframe

} SkDKey;

//**************************************************************************************
//    PlasticSkeletonDeformation  declaration
//**************************************************************************************

/*!
  PlasticSkeletonDeformation models the deformation of a group of PlasticSkeleton instances.

\par Description

  A PlasticSkeleton instance is typically used to act as a deformable object - in other
  words, it defines the 'original' form of a hierarchy of vertices that can be manipulated
  interactively to obtain a 'deformed' configuration.
  \n\n
  PlasticSkeletonDeformation represents a deformation of PlasticSkeleton objects,
  therefore acting primarily as a collection of PlasticSkeletonVertexDeformation
  instances - one per skeleton vertex. The collection is an associative container mapping a
  <I> vertex name <\I> to its deformation; using names as keys is a useful abstraction
  that allows vertex deformations data (eg keyframes) to be copied to skeleton deformations
  whose skeletons have a different internal configuration (ie vertex indices and such).
  \n\n
  Each vertex deformation also stores a unique <I> hook number <\I> that can be used during
  xsheet animation to link stage objects to a skeleton vertex.

\par The Skeletons group

  The PlasticSkeletonDeformation implementation has been extended to work on multiple
  skeletons for one class instance. This class stores a map associating skeleton indices
  to the skeleton instances, that can be used to select a skeleton to be deformed with
  the deformation's data.
  \n\n
  Vertices in different skeleton instances share the same animation if their name is the same.
  \n\n
  This class provides an animatable parameter that is intended to choose the \a active
  skeleton along an xsheet timeline. It is retrievable through the skeletonIdsParam() method.

\par Notable implementation details

  In current implementation, a PlasticSkeletonDeformation keeps shared ownership of the
  skeletons it is attached to. It is therefore intended to be a \a container of said skeletons.
*/
class DVAPI PlasticSkeletonDeformation : public TSmartObject, public TPersist
{
	DECLARE_CLASS_CODE
	PERSIST_DECLARATION(PlasticSkeletonDeformation)

private:
	class Imp;
	Imp *m_imp;

public:
	typedef tcg::any_it<int, int, void *>::bidirectional skelId_iterator;
	typedef tcg::any_it<std::pair<const QString *, SkVD *>,
						std::pair<const QString *, SkVD *>, void *>::bidirectional vd_iterator;
	typedef tcg::any_it<std::pair<int, int>,
						std::pair<int, int>, void *>::bidirectional vx_iterator;

public:
	PlasticSkeletonDeformation();										 //!< Constructs an empty deformation
	PlasticSkeletonDeformation(const PlasticSkeletonDeformation &other); //!< Constructs a deformation \a cloning other's skeletons
	~PlasticSkeletonDeformation();

	PlasticSkeletonDeformation &operator=(const PlasticSkeletonDeformation &other);

	// Skeleton-related methods

	bool empty() const;
	int skeletonsCount() const;

	//! Acquires <I> shared ownership <\I> of the specified skeleton, under given skeletonId
	void attach(int skeletonId, PlasticSkeleton *skeleton);

	//! Releases the skeleton associated to specified skeletonId
	void detach(int skeletonId);

	PlasticSkeletonP skeleton(int skeletonId) const;
	int skeletonId(PlasticSkeleton *skeleton) const;

	//! Returns the ordered range containing the skeleton ids
	void skeletonIds(skelId_iterator &begin, skelId_iterator &end) const;

	TDoubleParamP skeletonIdsParam() const; //!< Returns the skeleton id by frame animatable parameter

	PlasticSkeletonP skeleton(double frame) const; //!< Returns the \a active skeleton by xsheet frame
	int skeletonId(double frame) const;			   //!< Returns the \a active skeleton id by xsheet frame

	// Vertex deformations-related methods

	int vertexDeformationsCount() const;

	SkVD *vertexDeformation(const QString &vertexName) const; //!< Returns the vertex deformation associated to given
															  //!< vertex name. The returned pointer is <I> owned by
															  //!< the deformation - it must \b not be deleted <\I>
	SkVD *vertexDeformation(int skelId, int v) const;

	void vertexDeformations(vd_iterator &begin, vd_iterator &end) const; //!< Returns the ordered range of vertex deformations

	void vdSkeletonVertices(const QString &vertexName,
							vx_iterator &begin, vx_iterator &end) const; //!< Returns the ordered range of skeleton vertices
																		 //!< (at max one per skeleton id) associated to a
																		 //!< vertex name
	// Hook number-related methods

	int hookNumber(const QString &name) const;
	int hookNumber(int skelId, int v) const;

	QString vertexName(int hookNumber) const;
	int vertexIndex(int hookNumber, int skelId) const;

	// Parameters-related methods

	void addObserver(TParamObserver *observer);
	void removeObserver(TParamObserver *observer);

	void setGrammar(TSyntax::Grammar *grammar);

	// Keyframes-related methods

	void getKeyframeAt(double frame, SkDKey &keysMap) const; //!< \note keysMap returned by argument to avoid map
															 //!< copies in case move semantics is not available
	void setKeyframe(double frame);
	bool setKeyframe(const SkDKey &keyframe);
	bool setKeyframe(const SkDKey &keyframe, double frame,
					 double easeIn = -1.0, double easeOut = -1.0);

	bool isKeyframe(double frame) const;
	bool isFullKeyframe(double frame) const;
	void deleteKeyframe(double frame);

	// Interface methods using a deformed copy of the original skeleton (which is owned by this class)

	void storeDeformedSkeleton(int skeletonId, double frame, PlasticSkeleton &skeleton) const;

	void updatePosition(const PlasticSkeleton &originalSkeleton, PlasticSkeleton &deformedSkeleton,
						double frame, int v, const TPointD &pos);
	void updateAngle(const PlasticSkeleton &originalSkeleton, PlasticSkeleton &deformedSkeleton,
					 double frame, int v, const TPointD &pos);

protected:
	void saveData(TOStream &os);
	void loadData(TIStream &is);

private:
	friend class PlasticSkeleton;

	void addVertex(PlasticSkeleton *sk, int v);	//!< Deals with vertex deformations when v has been added
	void insertVertex(PlasticSkeleton *sk, int v); //!< Deals with vertex deformations when v has been inserted in an edge
	void deleteVertex(PlasticSkeleton *sk, int v); //!< Removes vertex deformation for v, \a before it is deleted
	void vertexNameChange(PlasticSkeleton *sk, int v,
						  const QString &newName); //!< Rebinds a vertex deformation name
	void clear(PlasticSkeleton *sk);			   //!< Clears all vertex deformations

	void loadData_prerelease(TIStream &is); // Toonz 7.0 pre-release loading function. Will be deleted
											// in the next minor release.
};

typedef PlasticSkeletonDeformation SkD;

//===============================================================================

#ifdef WIN32
template class DVAPI TSmartPointerT<PlasticSkeletonDeformation>;
#endif

typedef TSmartPointerT<PlasticSkeletonDeformation> PlasticSkeletonDeformationP;
typedef PlasticSkeletonDeformationP SkDP;

#endif // PLASTICSKELETONDEFORMATION_H