// Filename: nodeTransitions.h
// Created by:  drose (20Mar00)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) 2001, Disney Enterprises, Inc.  All rights reserved
//
// All use of this software is subject to the terms of the Panda 3d
// Software license.  You should have received a copy of this license
// along with this source code; you will also find a current copy of
// the license at http://www.panda3d.org/license.txt .
//
// To contact the maintainers of this program write to
// panda3d@yahoogroups.com .
//
////////////////////////////////////////////////////////////////////

#ifndef NODETRANSITIONS_H
#define NODETRANSITIONS_H

#include "pandabase.h"

#include "nodeTransition.h"

#include "pointerTo.h"
#include "dcast.h"

#include "pmap.h"

class NodeRelation;

////////////////////////////////////////////////////////////////////
//       Class : NodeTransitions
// Description : This represents a set of zero or more NodeTransition
//               pointers, organized by the transitions' get_handle()
//               value.
////////////////////////////////////////////////////////////////////
class EXPCL_PANDA NodeTransitions {
public:
  NodeTransitions();
  NodeTransitions(const NodeTransitions &copy);
  void operator = (const NodeTransitions &copy);
  ~NodeTransitions();

  bool is_empty() const;
  PT(NodeTransition) set_transition(TypeHandle handle, NodeTransition *trans);
  INLINE_GRAPH PT(NodeTransition) set_transition(NodeTransition *trans);
  PT(NodeTransition) clear_transition(TypeHandle handle);
  bool has_transition(TypeHandle handle) const;
  NodeTransition *get_transition(TypeHandle handle) const;
  void copy_transitions_from(const NodeTransitions &other);
  void copy_transitions_from(const NodeTransitions &other,
                             NodeRelation *to_arc);
  void compose_transitions_from(const NodeTransitions &other,
                                NodeRelation *to_arc);
  void adjust_all_priorities(int adjustment, NodeRelation *arc);

  void clear();

  int compare_to(const NodeTransitions &other) const;

  void remove_all_from_arc(NodeRelation *arc);

private:
  typedef pmap<TypeHandle, PT(NodeTransition) > Transitions;

public:
  // STL-like definitions to allow read-write traversal of the
  // individual transitions.  Beware!  These are not safe to use
  // outside of PANDA.DLL.
  typedef Transitions::iterator iterator;
  typedef Transitions::const_iterator const_iterator;
  typedef Transitions::key_type key_type;
  typedef Transitions::value_type value_type;
  typedef Transitions::size_type size_type;

  INLINE_GRAPH size_type size() const;
  INLINE_GRAPH iterator begin();
  INLINE_GRAPH iterator end();
  INLINE_GRAPH const_iterator begin() const;
  INLINE_GRAPH const_iterator end() const;
  INLINE_GRAPH iterator insert(iterator position, const value_type &x);
  INLINE_GRAPH iterator find(const key_type &k);
  INLINE_GRAPH void erase(iterator position);

public:
  void output(ostream &out) const;
  void write(ostream &out, int indent_level = 0) const;

private:
  Transitions _transitions;
  friend class NodeTransitionCache;
};

INLINE_GRAPH ostream &operator << (ostream &out, const NodeTransitions &nts);

template<class Transition>
INLINE_GRAPH bool
get_transition_into(Transition *&ptr, const NodeTransitions &trans,
                    TypeHandle transition_type);

template<class Transition>
INLINE_GRAPH bool
get_transition_into(Transition *&ptr, const NodeTransitions &trans);

#ifndef DONT_INLINE_GRAPH
#include "nodeTransitions.I"
#endif

#include "nodeTransitions.T"

#endif