text: /**
   * 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 parametricCurveCollection.h
   * @author drose
   * @date 2001-03-04
   */
  
  #ifndef PARAMETRICCURVECOLLECTION_H
  #define PARAMETRICCURVECOLLECTION_H
  
  #include "pandabase.h"
  
  #include "parametricCurve.h"
  
  #include "referenceCount.h"
  #include "pointerTo.h"
  #include "luse.h"
  
  #include "pvector.h"
  #include "plist.h"
  
  class ParametricCurveDrawer;
  
  /**
   * This is a set of zero or more ParametricCurves, which may or may not be
   * related.  If they are related, the set should contain no more than one XYZ
   * curve, no more than one HPR curve, and zero or more Timewarp curves, which
   * can then be evaluated as a unit to return a single transformation matrix
   * for a given unit of time.
   */
  class EXPCL_PANDA_PARAMETRICS ParametricCurveCollection : public ReferenceCount {
  PUBLISHED:
    ParametricCurveCollection();
    INLINE ~ParametricCurveCollection();
  
    void add_curve(ParametricCurve *curve);
    void add_curve(ParametricCurve *curve, int index);
    void insert_curve(size_t index, ParametricCurve *curve);
    int add_curves(PandaNode *node);
    bool remove_curve(ParametricCurve *curve);
    void remove_curve(size_t index);
    void set_curve(size_t index, ParametricCurve *curve);
    bool has_curve(ParametricCurve *curve) const;
    void clear();
    void clear_timewarps();
  
    INLINE int get_num_curves() const;
    INLINE ParametricCurve *get_curve(int index) const;
    MAKE_SEQ(get_curves, get_num_curves, get_curve);
  
    ParametricCurve *get_xyz_curve() const;
    ParametricCurve *get_hpr_curve() const;
    ParametricCurve *get_default_curve() const;
    int get_num_timewarps() const;
    ParametricCurve *get_timewarp_curve(int n) const;
    MAKE_SEQ(get_timewarp_curves, get_num_timewarps, get_timewarp_curve);
  
    INLINE PN_stdfloat get_max_t() const;
  
    MAKE_SEQ_PROPERTY(curves, get_num_curves, get_curve, set_curve, remove_curve);
    MAKE_PROPERTY(xyz_curve, get_xyz_curve);
    MAKE_PROPERTY(hpr_curve, get_hpr_curve);
    MAKE_PROPERTY(default_curve, get_default_curve);
    MAKE_SEQ_PROPERTY(timewarp_curves, get_num_timewarps, get_timewarp_curve);
    MAKE_PROPERTY(max_t, get_max_t);
  
    void make_even(PN_stdfloat max_t, PN_stdfloat segments_per_unit);
    void face_forward(PN_stdfloat segments_per_unit);
    void reset_max_t(PN_stdfloat max_t);
  
    bool evaluate(PN_stdfloat t, LVecBase3 &xyz, LVecBase3 &hpr) const;
    bool evaluate(PN_stdfloat t, LMatrix4 &result, CoordinateSystem cs = CS_default) const;
  
    PN_stdfloat evaluate_t(PN_stdfloat t) const;
    INLINE bool evaluate_xyz(PN_stdfloat t, LVecBase3 &xyz) const;
    INLINE bool evaluate_hpr(PN_stdfloat t, LVecBase3 &hpr) const;
  
    INLINE bool adjust_xyz(PN_stdfloat t, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z);
    bool adjust_xyz(PN_stdfloat t, const LVecBase3 &xyz);
    INLINE bool adjust_hpr(PN_stdfloat t, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r);
    bool adjust_hpr(PN_stdfloat t, const LVecBase3 &xyz);
  
    bool recompute();
  
    bool stitch(const ParametricCurveCollection *a,
                const ParametricCurveCollection *b);
  
    void output(ostream &out) const;
    void write(ostream &out, int indent_level = 0) const;
  
    bool write_egg(Filename filename, CoordinateSystem cs = CS_default);
    bool write_egg(ostream &out, const Filename &filename, CoordinateSystem cs);
  
  public:
    int r_add_curves(PandaNode *node);
    void register_drawer(ParametricCurveDrawer *drawer);
    void unregister_drawer(ParametricCurveDrawer *drawer);
  
  private:
    bool determine_hpr(PN_stdfloat t, ParametricCurve *xyz_curve, LVecBase3 &hpr) const;
    void prepare_add_curve(ParametricCurve *curve);
    void prepare_remove_curve(ParametricCurve *curve);
    void redraw();
  
  private:
    typedef pvector< PT(ParametricCurve) > ParametricCurves;
    ParametricCurves _curves;
    typedef plist<ParametricCurveDrawer *> DrawerList;
    DrawerList _drawers;
  };
  
  INLINE ostream &
  operator << (ostream &out, const ParametricCurveCollection &col) {
    col.output(out);
    return out;
  }
  
  #include "parametricCurveCollection.I"
  
  #endif
  