characterJoint.h

Go to the documentation of this file.

/**
 * PANDA 3D SOFTWARE
 * Copyright (c) Carnegie Mellon University.  All rights reserved.
 *
 * All use of this software is subject to the terms of the revised BSD
 * license.  You should have received a copy of this license along
 * with this source code in a file named "LICENSE."
 *
 * @file characterJoint.h
 * @author drose
 * @date 1999-02-23
 */

#ifndef CHARACTERJOINT_H
#define CHARACTERJOINT_H

#include "pandabase.h"
#include "transformState.h"

#include "movingPartMatrix.h"
#include "pandaNode.h"
#include "nodePathCollection.h"
#include "ordered_vector.h"

class JointVertexTransform;
class Character;

/**
 * This represents one joint of the character's animation, containing an
 * animating transform matrix.
 */
class EXPCL_PANDA_CHAR CharacterJoint : public MovingPartMatrix {
protected:
  CharacterJoint();
  CharacterJoint(const CharacterJoint &copy);

PUBLISHED:
  explicit CharacterJoint(Character *character, PartBundle *root,
                          PartGroup *parent, const std::string &name,
                          const LMatrix4 &default_value);
  virtual ~CharacterJoint();

public:
  virtual bool is_character_joint() const;
  virtual PartGroup *make_copy() const;

  virtual bool update_internals(PartBundle *root, PartGroup *parent,
                                bool self_changed, bool parent_changed,
                                Thread *current_thread);
  virtual void do_xform(const LMatrix4 &mat, const LMatrix4 &inv_mat);

PUBLISHED:
  bool add_net_transform(PandaNode *node);
  bool remove_net_transform(PandaNode *node);
  bool has_net_transform(PandaNode *node) const;
  void clear_net_transforms();
  NodePathCollection get_net_transforms();

  bool add_local_transform(PandaNode *node);
  bool remove_local_transform(PandaNode *node);
  bool has_local_transform(PandaNode *node) const;
  void clear_local_transforms();
  NodePathCollection get_local_transforms();

  void get_transform(LMatrix4 &transform) const;
  INLINE const LMatrix4 &get_transform() const;
  CPT(TransformState) get_transform_state() const;

  void get_net_transform(LMatrix4 &transform) const;

  Character *get_character() const;

private:
  void set_character(Character *character);

private:
  // Not a reference-counted pointer.
  Character *_character;

  typedef ov_set< PT(PandaNode) > NodeList;
  NodeList _net_transform_nodes;
  NodeList _local_transform_nodes;

  typedef ov_set<JointVertexTransform *> VertexTransforms;
  VertexTransforms _vertex_transforms;

public:
  static void register_with_read_factory();
  virtual void write_datagram(BamWriter* manager, Datagram &me);
  virtual int complete_pointers(TypedWritable **p_list,
                                BamReader *manager);

  static TypedWritable *make_CharacterJoint(const FactoryParams &params);

protected:
  void fillin(DatagramIterator& scan, BamReader* manager);

private:
  int _num_net_nodes, _num_local_nodes;

public:
  // The _geom_node member just holds a temporary pointer to a node for the
  // CharacterMaker's convenenience while creating the character.  It does not
  // store any meaningful value after creation is complete.
  PT(PandaNode) _geom_node;

  // These are filled in as the joint animates.
  LMatrix4 _net_transform;
  LMatrix4 _initial_net_transform_inverse;

  // This is the product of the above; the matrix that gets applied to a
  // vertex (whose coordinates are in the coordinate space of the character
  // in its neutral pose) to transform it from its neutral position to its
  // animated position.
  LMatrix4 _skinning_matrix;

public:
  virtual TypeHandle get_type() const {
    return get_class_type();
  }
  virtual TypeHandle force_init_type() {init_type(); return get_class_type();}
  static TypeHandle get_class_type() {
    return _type_handle;
  }
  static void init_type() {
    MovingPartMatrix::init_type();
    register_type(_type_handle, "CharacterJoint",
                  MovingPartMatrix::get_class_type());
  }

private:
  static TypeHandle _type_handle;

  friend class Character;
  friend class CharacterJointBundle;
  friend class JointVertexTransform;
};

#include "characterJoint.I"

#endif