gtk2_ardour/audio_region_view.h

   1 /*
   2     Copyright (C) 2001-2006 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 #ifndef __gtk_ardour_audio_region_view_h__
  20 #define __gtk_ardour_audio_region_view_h__
  21
  22 #include <vector>
  23
  24 #include <libgnomecanvasmm.h>
  25 #include <libgnomecanvasmm/polygon.h>
  26 #include <sigc++/signal.h>
  27 #include <ardour/audioregion.h>
  28
  29 #include "region_view.h"
  30 #include "route_time_axis.h"
  31 #include "time_axis_view_item.h"
  32 #include "automation_line.h"
  33 #include "enums.h"
  34 #include "waveview.h"
  35 #include "canvas.h"
  36
  37 namespace ARDOUR {
  38         class AudioRegion;
  39         class PeakData;
  40 };
  41
  42 class AudioTimeAxisView;
  43 class AudioRegionGainLine;
  44 class AudioRegionEditor;
  45 class GhostRegion;
  46 class AutomationTimeAxisView;
  47
  48 class AudioRegionView : public RegionView
  49 {
  50   public:
  51         AudioRegionView (ArdourCanvas::Group *,
  52                          RouteTimeAxisView&,
  53                          boost::shared_ptr<ARDOUR::AudioRegion>,
  54                          double initial_samples_per_unit,
  55                          Gdk::Color& basic_color);
  56
  57         AudioRegionView (const AudioRegionView& other);
  58
  59         ~AudioRegionView ();
  60
  61         virtual void init (Gdk::Color& base_color, bool wait_for_data);
  62
  63         boost::shared_ptr<ARDOUR::AudioRegion> audio_region() const;
  64
  65         void set_y_position_and_height (double, double);
  66         void create_waves ();
  67
  68         void set_samples_per_unit (double);
  69
  70         void set_amplitude_above_axis (gdouble spp);
  71
  72         void temporarily_hide_envelope (); ///< Dangerous!
  73         void unhide_envelope ();           ///< Dangerous!
  74
  75         void set_envelope_visible (bool);
  76         void set_waveform_visible (bool yn);
  77         void set_waveform_shape (Editing::WaveformShape);
  78         void set_waveform_scale (Editing::WaveformScale);
  79
  80         bool waveform_rectified() const { return _flags & WaveformRectified; }
  81         bool waveform_logscaled() const { return _flags & WaveformLogScaled; }
  82         bool waveform_visible()   const { return _flags & WaveformVisible; }
  83         bool envelope_visible()   const { return _flags & EnvelopeVisible; }
  84
  85         void show_region_editor ();
  86
  87         void add_gain_point_event (ArdourCanvas::Item *item, GdkEvent *event);
  88         void remove_gain_point_event (ArdourCanvas::Item *item, GdkEvent *event);
  89
  90         AudioRegionGainLine* get_gain_line() const { return gain_line; }
  91
  92         void region_changed (ARDOUR::Change);
  93         void envelope_active_changed ();
  94
  95         GhostRegion* add_ghost (TimeAxisView&);
  96
  97         void reset_fade_in_shape_width (nframes_t);
  98         void reset_fade_out_shape_width (nframes_t);
  99
 100         virtual void entered ();
 101         virtual void exited ();
 102
 103   protected:
 104
 105     /* this constructor allows derived types
 106        to specify their visibility requirements
 107        to the TimeAxisViewItem parent class
 108     */
 109
 110     AudioRegionView (ArdourCanvas::Group *,
 111                      RouteTimeAxisView&,
 112                      boost::shared_ptr<ARDOUR::AudioRegion>,
 113                      double      samples_per_unit,
 114                      Gdk::Color& basic_color,
 115                      TimeAxisViewItem::Visibility);
 116
 117     enum Flags {
 118             EnvelopeVisible = 0x1,
 119             WaveformVisible = 0x4,
 120             WaveformRectified = 0x8,
 121             WaveformLogScaled = 0x10,
 122     };
 123
 124     vector<ArdourCanvas::WaveView *> waves;
 125     vector<ArdourCanvas::WaveView *> tmp_waves; ///< see ::create_waves()
 126     ArdourCanvas::Polygon*           sync_mark; ///< polgyon for sync position
 127     ArdourCanvas::SimpleLine*        zero_line;
 128     ArdourCanvas::Polygon*           fade_in_shape;
 129     ArdourCanvas::Polygon*           fade_out_shape;
 130     ArdourCanvas::SimpleRect*        fade_in_handle;
 131     ArdourCanvas::SimpleRect*        fade_out_handle;
 132
 133     AudioRegionGainLine * gain_line;
 134
 135     double _amplitude_above_axis;
 136     double _y_position;
 137     double _height;
 138
 139     uint32_t _flags;
 140     uint32_t fade_color;
 141
 142     void reset_fade_shapes ();
 143     void reset_fade_in_shape ();
 144     void reset_fade_out_shape ();
 145     void fade_in_changed ();
 146     void fade_out_changed ();
 147     void fade_in_active_changed ();
 148     void fade_out_active_changed ();
 149
 150     void region_resized (ARDOUR::Change);
 151     void region_muted ();
 152     void region_scale_amplitude_changed ();
 153         void region_renamed ();
 154
 155     void create_one_wave (uint32_t, bool);
 156     void manage_zero_line ();
 157     void peaks_ready_handler (uint32_t);
 158     void set_flags (XMLNode *);
 159     void store_flags ();
 160
 161     void set_colors ();
 162     void compute_colors (Gdk::Color&);
 163     void reset_width_dependent_items (double pixel_width);
 164     void set_waveview_data_src();
 165     void set_frame_color ();
 166
 167     void color_handler ();
 168
 169     vector<GnomeCanvasWaveViewCache*> wave_caches;
 170
 171   private:
 172
 173     void setup_fade_handle_positions ();
 174 };
 175
 176 #endif /* __gtk_ardour_audio_region_view_h__ */