gtk2_ardour/selection.h

   1 /*
   2     Copyright (C) 2000-2003 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 #ifndef __ardour_gtk_selection_h__
  21 #define __ardour_gtk_selection_h__
  22
  23 #include <vector>
  24 #include <boost/shared_ptr.hpp>
  25 #include <boost/noncopyable.hpp>
  26
  27 #include <sigc++/signal.h>
  28
  29 #include "pbd/signals.h"
  30
  31 #include "time_selection.h"
  32 #include "region_selection.h"
  33 #include "track_selection.h"
  34 #include "automation_selection.h"
  35 #include "playlist_selection.h"
  36 #include "processor_selection.h"
  37 #include "point_selection.h"
  38 #include "marker_selection.h"
  39 #include "midi_selection.h"
  40
  41 class TimeAxisView;
  42 class RegionView;
  43 class Selectable;
  44 class PublicEditor;
  45 class MidiRegionView;
  46 class AutomationLine;
  47 class ControlPoint;
  48
  49
  50 namespace ARDOUR {
  51         class Region;
  52         class AudioRegion;
  53         class Playlist;
  54         class Processor;
  55         class AutomationList;
  56 }
  57
  58 namespace Evoral {
  59         class ControlList;
  60 }
  61
  62 /// Lists of selected things
  63
  64 /** The Selection class holds lists of selected items (tracks, regions, etc. etc.). */
  65
  66 class Selection : public sigc::trackable, public PBD::ScopedConnectionList
  67 {
  68 public:
  69         enum SelectionType {
  70                 Object = 0x1,
  71                 Range = 0x2
  72         };
  73
  74         enum Operation {
  75                 Set,
  76                 Add,
  77                 Toggle,
  78                 Extend
  79         };
  80
  81         TrackSelection       tracks;
  82         RegionSelection      regions;
  83         TimeSelection        time;
  84         AutomationSelection  lines;
  85         PlaylistSelection    playlists;
  86         PointSelection       points;
  87         MarkerSelection      markers;
  88         MidiRegionSelection  midi_regions;
  89
  90         /** only used when this class is used as a cut buffer */
  91         MidiNoteSelection    midi_notes;
  92
  93         Selection (PublicEditor const * e, bool manage_libardour_selection);
  94
  95         // Selection& operator= (const Selection& other);
  96
  97         sigc::signal<void> TracksChanged;
  98         sigc::signal<void> RegionsChanged;
  99         sigc::signal<void> TimeChanged;
 100         sigc::signal<void> LinesChanged;
 101         sigc::signal<void> PlaylistsChanged;
 102         sigc::signal<void> PointsChanged;
 103         sigc::signal<void> MarkersChanged;
 104         sigc::signal<void> MidiNotesChanged;
 105         sigc::signal<void> MidiRegionsChanged;
 106
 107         void clear ();
 108
 109         /** check if all selections are empty
 110          * @param internal_selection also check object internals (e.g midi notes, automation points), when false only check objects.
 111          * @return true if nothing is selected.
 112          */
 113         bool empty (bool internal_selection = false);
 114
 115         void dump_region_layers();
 116
 117         bool selected (TimeAxisView*) const;
 118         bool selected (RegionView*) const;
 119         bool selected (ArdourMarker*) const;
 120         bool selected (ControlPoint*) const;
 121
 122         void set (std::list<Selectable*> const &);
 123         void add (std::list<Selectable*> const &);
 124         void toggle (std::list<Selectable*> const &);
 125
 126         void set (TimeAxisView*);
 127         void set (const TrackViewList&);
 128         void set (const MidiNoteSelection&);
 129         void set (RegionView*, bool also_clear_tracks = true);
 130         void set (MidiRegionView*);
 131         void set (std::vector<RegionView*>&);
 132         long set (samplepos_t, samplepos_t);
 133         void set_preserving_all_ranges (samplepos_t, samplepos_t);
 134         void set (boost::shared_ptr<Evoral::ControlList>);
 135         void set (boost::shared_ptr<ARDOUR::Playlist>);
 136         void set (const std::list<boost::shared_ptr<ARDOUR::Playlist> >&);
 137         void set (ControlPoint *);
 138         void set (ArdourMarker*);
 139         void set (const RegionSelection&);
 140
 141         void toggle (TimeAxisView*);
 142         void toggle (const TrackViewList&);
 143         void toggle (const MidiNoteSelection&);
 144         void toggle (RegionView*);
 145         void toggle (MidiRegionView*);
 146         void toggle (MidiCutBuffer*);
 147         void toggle (std::vector<RegionView*>&);
 148         long toggle (samplepos_t, samplepos_t);
 149         void toggle (ARDOUR::AutomationList*);
 150         void toggle (boost::shared_ptr<ARDOUR::Playlist>);
 151         void toggle (const std::list<boost::shared_ptr<ARDOUR::Playlist> >&);
 152         void toggle (ControlPoint *);
 153         void toggle (std::vector<ControlPoint*> const &);
 154         void toggle (ArdourMarker*);
 155
 156         void add (TimeAxisView*);
 157         void add (const TrackViewList&);
 158         void add (const MidiNoteSelection&);
 159         void add (RegionView*);
 160         void add (MidiRegionView*);
 161         void add (MidiCutBuffer*);
 162         void add (std::vector<RegionView*>&);
 163         long add (samplepos_t, samplepos_t);
 164         void add (boost::shared_ptr<Evoral::ControlList>);
 165         void add (boost::shared_ptr<ARDOUR::Playlist>);
 166         void add (const std::list<boost::shared_ptr<ARDOUR::Playlist> >&);
 167         void add (ControlPoint *);
 168         void add (std::vector<ControlPoint*> const &);
 169         void add (ArdourMarker*);
 170         void add (const std::list<ArdourMarker*>&);
 171         void add (const RegionSelection&);
 172         void add (const PointSelection&);
 173         void remove (TimeAxisView*);
 174         void remove (const TrackViewList&);
 175         void remove (const MidiNoteSelection&);
 176         void remove (RegionView*);
 177         void remove (MidiRegionView*);
 178         void remove (MidiCutBuffer*);
 179         void remove (uint32_t selection_id);
 180         void remove (samplepos_t, samplepos_t);
 181         void remove (boost::shared_ptr<ARDOUR::AutomationList>);
 182         void remove (boost::shared_ptr<ARDOUR::Playlist>);
 183         void remove (const std::list<boost::shared_ptr<ARDOUR::Playlist> >&);
 184         void remove (const std::list<Selectable*>&);
 185         void remove (ArdourMarker*);
 186         void remove (ControlPoint *);
 187
 188         void remove_regions (TimeAxisView *);
 189
 190         void move_time (samplecnt_t);
 191
 192         void replace (uint32_t time_index, samplepos_t start, samplepos_t end);
 193
 194         /*
 195          * A note about items in an editing Selection:
 196          * At a high level, selections can include Tracks, Objects, or Time Ranges
 197          * Range and Object selections are mutually exclusive.
 198          * Selecting a Range will deselect all Objects, and vice versa.
 199          * This is done to avoid confusion over what will happen in an operation such as Delete
 200          * Tracks are somewhat orthogonal b/c editing operations don't apply to tracks.
 201          * The Track selection isn't affected when ranges or objects are added.
 202          */
 203
 204         void clear_all() { clear_time(); clear_tracks(); clear_objects(); }
 205
 206         void clear_time(bool with_signal = true);  //clears any time selection  ( i.e. Range )
 207         void clear_tracks (bool with_signal = true);  //clears the track header selections
 208         void clear_objects(bool with_signal = true);  //clears the items listed below
 209
 210         // these items get cleared wholesale in clear_objects
 211         void clear_regions(bool with_signal = true);
 212         void clear_lines (bool with_signal = true);
 213         void clear_playlists (bool with_signal = true);
 214         void clear_points (bool with_signal = true);
 215         void clear_markers (bool with_signal = true);
 216         void clear_midi_notes (bool with_signal = true);
 217         void clear_midi_regions (bool with_signal = true);
 218
 219         void foreach_region (void (ARDOUR::Region::*method)(void));
 220         void foreach_regionview (void (RegionView::*method)(void));
 221         void foreach_midi_regionview (void (MidiRegionView::*method)(void));
 222         template<class A> void foreach_region (void (ARDOUR::Region::*method)(A), A arg);
 223
 224         XMLNode& get_state () const;
 225         int set_state (XMLNode const &, int);
 226
 227         std::list<std::pair<PBD::ID const, std::list<Evoral::event_id_t> > > pending_midi_note_selection;
 228
 229         void core_selection_changed (PBD::PropertyChange const & pc);
 230
 231 private:
 232         PublicEditor const * editor;
 233         uint32_t next_time_id;
 234         bool     manage_libardour_selection;
 235
 236         TrackViewList add_grouped_tracks (TrackViewList const & t);
 237 };
 238
 239 bool operator==(const Selection& a, const Selection& b);
 240
 241 #endif /* __ardour_gtk_selection_h__ */