Logo Search packages:      
Sourcecode: ardour version File versions  Download package

automation_event.h

/*
    Copyright (C) 2002 Paul Davis 

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

    $Id: automation_event.h,v 1.27 2005/05/05 16:17:12 pauld Exp $
*/

#ifndef __ardour_automation_event_h__
#define __ardour_automation_event_h__

#include <stdint.h>
#include <list>
#include <cmath>

#include <sigc++/signal_system.h>
#include <pbd/lockmonitor.h>
#include <pbd/undo.h>
#include <pbd/xml++.h>
#include <ardour/ardour.h>
#include <ardour/state_manager.h>

namespace ARDOUR {
      
struct ControlEvent {
    double when;
    double value;
    
    ControlEvent (double w, double v)
          : when (w), value (v) { }
    ControlEvent (const ControlEvent& other) 
          : when (other.when), value (other.value) {}

    virtual ~ControlEvent() {}
    
//    bool operator==(const ControlEvent& other) {
//        return value == other.value && when == other.when;
//    }

};

class AutomationList : public StateManager
{
  public:
      typedef std::list<ControlEvent*> AutomationEventList;
      typedef AutomationEventList::iterator iterator;
      typedef AutomationEventList::const_iterator const_iterator;

      AutomationList(double default_value, bool no_state = false);
      ~AutomationList();

      AutomationList (const AutomationList&);
      AutomationList (const AutomationList&, double start, double end);
      AutomationList& operator= (const AutomationList&);
      bool operator== (const AutomationList&);

      void freeze();
      void thaw ();

      AutomationEventList::size_type size() const { return events.size(); }
      bool empty() const { return events.empty(); }

      void reset_default (double val) {
            default_value = val;
      }

      void clear ();
      void x_scale (double factor);
      bool extend_to (double);

      void reposition_for_rt_add (double when);
      void rt_add (double when, double value);
      iterator add (double when, double value, iterator, bool ignore_mode = false);
      void add (double when, double value, bool for_loading = false);

      void erase_range (double start, double end);
      void erase (iterator);
      void erase (iterator, iterator);
      void move_range (iterator start, iterator end, double, double);
      void modify (iterator, double, double);

      AutomationList* cut (double, double);
      AutomationList* copy (double, double);
      void clear (double, double);

      AutomationList* cut (iterator, iterator);
      AutomationList* copy (iterator, iterator);
      void clear (iterator, iterator);

      bool paste (AutomationList&, double position, float times);

      void set_automation_state (AutoState);
      AutoState automation_state() const { return _state; }
      SigC::Signal0<void> automation_style_changed;

      void set_automation_style (AutoStyle m);
        AutoStyle automation_style() const { return _style; }
      SigC::Signal0<void> automation_state_changed;

      bool automation_playback() {
            return (_state & Play) || ((_state & Touch) && !_touching);
      }
      bool automation_write () {
            return (_state & Write) || ((_state & Touch) && _touching);
      }

      void start_touch ();
      void stop_touch ();
      bool touching() const { return _touching; }

      void set_yrange (double min, double max) {
            min_yval = min;
            max_yval = max;
      }

      double get_max_y() const { return max_yval; }
      double get_min_y() const { return min_yval; }

      void truncate_end (double length);
      void truncate_start (double length);
      
      iterator begin() { return events.begin(); }
      iterator end() { return events.end(); }

      ControlEvent* back() { return events.back(); }
      ControlEvent* front() { return events.front(); }

      const_iterator const_begin() const { return events.begin(); }
      const_iterator const_end() const { return events.end(); }

      std::pair<AutomationList::iterator,AutomationList::iterator> control_points_adjacent (double when);

      template<class T> void apply_to_points (T& obj, void (T::*method)(const AutomationList&)) {
            LockMonitor lm (lock, __LINE__, __FILE__);
            (obj.*method)(*this);
      }

      UndoAction get_memento () const;
      
      virtual void store_state (XMLNode& node) const;
      virtual void load_state (const XMLNode&);

      void set_max_xval (double);
      double get_max_xval() const { return max_xval; }

      double eval (double where) {
            LockMonitor lm (lock, __LINE__, __FILE__);
            return unlocked_eval (where);
      }

      double rt_safe_eval (double where, bool& ok) {

            TentativeLockMonitor lm (lock, __LINE__, __FILE__);

            if ((ok = lm.locked())) {
                  return unlocked_eval (where);
            } else {
                  return 0.0;
            }
      }

      struct TimeComparator {
            bool operator() (const ControlEvent* a, const ControlEvent* b) { 
                  return a->when < b->when;
            }
      };

  protected:
      struct State : public ARDOUR::StateManager::State {
          AutomationEventList events;

          State (std::string why) : ARDOUR::StateManager::State (why) {}
      };

      AutomationEventList events;
      mutable PBD::NonBlockingLock lock;
      bool   _frozen;
      bool    changed_when_thawed;
      bool   _dirty;

      struct LookupCache {
          double left;  /* leftmost x coordinate used when finding "range" */
          std::pair<AutomationList::iterator,AutomationList::iterator> range;
      };

      LookupCache lookup_cache;

      AutoState  _state;
      AutoStyle  _style;
      bool  _touching;
      bool  _new_touch;
      double max_xval;
      double min_yval;
      double max_yval;
      double default_value;
      bool   no_state;

      iterator rt_insertion_point;
      double   rt_pos;

      void maybe_signal_changed ();
      void mark_dirty ();
      void _x_scale (double factor);

      /* called by type-specific unlocked_eval() to handle
         common case of 0, 1 or 2 control points.
      */

      double shared_eval (double x);

      /* called by shared_eval() to handle any case of
         3 or more control points.
      */

      virtual double multipoint_eval (double x); 

      /* called by locked entry point and various private
         locations where we already hold the lock.
      */

      virtual double unlocked_eval (double where);

      Change   restore_state (StateManager::State&);
      StateManager::State* state_factory (std::string why) const;

      virtual ControlEvent* point_factory (double,double) const;
      virtual ControlEvent* point_factory (const ControlEvent&) const;


      AutomationList* cut_copy_clear (double, double, int op);
};

} // namespace

#endif /* __ardour_automation_event_h__ */

Generated by  Doxygen 1.6.0   Back to index