goat3d

annotate src/xform_node.h @ 47:498ca7ac7047

- placed all the implementation stuff in the g3dimpl namespace - added animation stuff to the public API - started writing animation saving/loading
author John Tsiombikas <nuclear@member.fsf.org>
date Sat, 28 Dec 2013 06:47:39 +0200
parents 0fe02696fb1e
children 9ef9de80649c
rev   line source
nuclear@1 1 #ifndef XFORM_NODE_H_
nuclear@1 2 #define XFORM_NODE_H_
nuclear@1 3
nuclear@1 4 #include <vector>
nuclear@1 5 #include "vmath/vector.h"
nuclear@1 6 #include "vmath/quat.h"
nuclear@1 7 #include "vmath/matrix.h"
nuclear@1 8
nuclear@1 9
nuclear@1 10 struct anm_node;
nuclear@1 11 struct anm_track;
nuclear@1 12
nuclear@47 13 namespace g3dimpl {
nuclear@47 14
nuclear@47 15 enum Interp { INTERP_STEP, INTERP_LINEAR, INTERP_CUBIC };
nuclear@47 16 enum Extrap { EXTRAP_EXTEND, EXTRAP_CLAMP, EXTRAP_REPEAT };
nuclear@47 17
nuclear@47 18 // NOTE: all time arguments are milliseconds
nuclear@1 19
nuclear@1 20 class XFormNode {
nuclear@1 21 private:
nuclear@1 22 struct anm_node *anm;
nuclear@1 23 std::vector<XFormNode*> children;
nuclear@30 24 XFormNode *parent;
nuclear@1 25
nuclear@1 26 Interp interp;
nuclear@1 27 Extrap extrap;
nuclear@1 28
nuclear@1 29 Matrix4x4 local_matrix;
nuclear@1 30 Matrix4x4 bone_matrix;
nuclear@1 31
nuclear@1 32 XFormNode(const XFormNode &node) {}
nuclear@1 33 XFormNode &operator =(const XFormNode &node) { return *this; }
nuclear@1 34
nuclear@1 35 public:
nuclear@1 36 XFormNode();
nuclear@1 37 virtual ~XFormNode();
nuclear@1 38
nuclear@47 39 // retrieve the pointer to the underlying libanim data structure
nuclear@47 40 virtual struct anm_node *get_libanim_node() const;
nuclear@47 41
nuclear@8 42 virtual void set_name(const char *name);
nuclear@8 43 virtual const char *get_name() const;
nuclear@1 44
nuclear@8 45 virtual void set_interpolator(Interp in);
nuclear@8 46 virtual Interp get_interpolator() const;
nuclear@8 47 virtual void set_extrapolator(Extrap ex);
nuclear@8 48 virtual Extrap get_extrapolator() const;
nuclear@1 49
nuclear@47 50 virtual XFormNode *get_parent();
nuclear@47 51 virtual const XFormNode *get_parent() const;
nuclear@47 52
nuclear@1 53 // children management
nuclear@8 54 virtual void add_child(XFormNode *child);
nuclear@8 55 virtual void remove_child(XFormNode *child);
nuclear@1 56
nuclear@8 57 virtual int get_children_count() const;
nuclear@8 58 virtual XFormNode *get_child(int idx);
nuclear@8 59 virtual const XFormNode *get_child(int idx) const;
nuclear@1 60
nuclear@47 61
nuclear@47 62 virtual void use_animation(int idx);
nuclear@47 63 virtual void use_animation(const char *name);
nuclear@47 64 virtual void use_animation(int aidx, int bidx, float t);
nuclear@47 65 virtual void use_animation(const char *aname, const char *bname, float t);
nuclear@47 66
nuclear@47 67 virtual int get_active_animation_index(int which = 0) const;
nuclear@47 68 virtual float get_active_animation_mix() const;
nuclear@47 69
nuclear@47 70 virtual int get_animation_count() const;
nuclear@47 71
nuclear@47 72 // add a new empty animation slot (recursive)
nuclear@47 73 virtual void add_animation(const char *name = 0);
nuclear@47 74
nuclear@47 75 // set/get the current animation name (set is recursive)
nuclear@47 76 virtual void set_animation_name(const char *name);
nuclear@47 77 virtual const char *get_animation_name() const;
nuclear@47 78
nuclear@1 79
nuclear@8 80 virtual void set_position(const Vector3 &pos, long tmsec = 0);
nuclear@8 81 virtual Vector3 get_node_position(long tmsec = 0) const;
nuclear@1 82
nuclear@8 83 virtual void set_rotation(const Quaternion &quat, long tmsec = 0);
nuclear@8 84 virtual Quaternion get_node_rotation(long tmsec = 0) const;
nuclear@1 85
nuclear@8 86 virtual void set_scaling(const Vector3 &pos, long tmsec = 0);
nuclear@8 87 virtual Vector3 get_node_scaling(long tmsec = 0) const;
nuclear@1 88
nuclear@1 89 // these take hierarchy into account
nuclear@8 90 virtual Vector3 get_position(long tmsec = 0) const;
nuclear@8 91 virtual Quaternion get_rotation(long tmsec = 0) const;
nuclear@8 92 virtual Vector3 get_scaling(long tmsec = 0) const;
nuclear@1 93
nuclear@8 94 virtual void set_pivot(const Vector3 &pivot);
nuclear@8 95 virtual Vector3 get_pivot() const;
nuclear@1 96
nuclear@1 97 // the local matrix is concatenated with the regular node/anim matrix
nuclear@8 98 virtual void set_local_matrix(const Matrix4x4 &mat);
nuclear@8 99 virtual const Matrix4x4 &get_local_matrix() const;
nuclear@1 100
nuclear@1 101 // for bone nodes, the transformation of the bone in bind position
nuclear@8 102 virtual void set_bone_matrix(const Matrix4x4 &bmat);
nuclear@8 103 virtual const Matrix4x4 &get_bone_matrix() const;
nuclear@1 104
nuclear@1 105 // node transformation alone
nuclear@8 106 virtual void get_node_xform(long tmsec, Matrix4x4 *mat, Matrix4x4 *inv_mat = 0) const;
nuclear@1 107
nuclear@1 108 // node transformation taking hierarchy into account
nuclear@8 109 virtual void get_xform(long tmsec, Matrix4x4 *mat, Matrix4x4 *inv_mat = 0) const;
nuclear@1 110 };
nuclear@1 111
nuclear@1 112
nuclear@1 113 class Track {
nuclear@1 114 private:
nuclear@1 115 struct anm_track *trk;
nuclear@1 116 Interp interp;
nuclear@1 117 Extrap extrap;
nuclear@1 118
nuclear@1 119 public:
nuclear@1 120 Track();
nuclear@1 121 ~Track();
nuclear@1 122
nuclear@1 123 Track(const Track &trk);
nuclear@1 124 Track &operator =(const Track &trk);
nuclear@1 125
nuclear@1 126 void set_interpolator(Interp in);
nuclear@1 127 Interp get_interpolator() const;
nuclear@1 128 void set_extrapolator(Extrap ex);
nuclear@1 129 Extrap get_extrapolator() const;
nuclear@1 130
nuclear@1 131 void set_default(double def);
nuclear@1 132
nuclear@1 133 void set_value(float val, long tmsec = 0);
nuclear@1 134 float get_value(long tmsec = 0) const;
nuclear@1 135
nuclear@1 136 // the same as get_value
nuclear@1 137 float operator ()(long tmsec = 0) const;
nuclear@1 138 };
nuclear@1 139
nuclear@1 140 class Track3 {
nuclear@1 141 private:
nuclear@1 142 Track track[3];
nuclear@1 143
nuclear@1 144 public:
nuclear@1 145 void set_interpolator(Interp in);
nuclear@1 146 Interp get_interpolator() const;
nuclear@1 147 void set_extrapolator(Extrap ex);
nuclear@1 148 Extrap get_extrapolator() const;
nuclear@1 149
nuclear@1 150 void set_default(const Vector3 &def);
nuclear@1 151
nuclear@1 152 void set_value(const Vector3 &val, long tmsec = 0);
nuclear@1 153 Vector3 get_value(long tmsec = 0) const;
nuclear@1 154
nuclear@1 155 // the same as get_value
nuclear@1 156 Vector3 operator ()(long tmsec = 0) const;
nuclear@1 157 };
nuclear@1 158
nuclear@47 159 } // namespace g3dimpl
nuclear@47 160
nuclear@1 161 #endif /* XFORM_NODE_H_ */