+/*
+ Copyright (C) 2011-2013 Paul Davis
+ Author: Carl Hetherington <cth@carlh.net>
+
+ 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.
+
+*/
+
#include <boost/shared_ptr.hpp>
+#include <boost/shared_array.hpp>
+#include <boost/scoped_array.hpp>
+
#include "pbd/properties.h"
+
#include "ardour/types.h"
+
+#include <glibmm/refptr.h>
+
#include "canvas/item.h"
#include "canvas/fill.h"
#include "canvas/outline.h"
class AudioRegion;
}
+namespace Gdk {
+ class Pixbuf;
+}
+
class WaveViewTest;
namespace ArdourCanvas {
class WaveView : virtual public Item, public Outline, public Fill
{
public:
+ enum Shape {
+ Normal,
+ Rectified,
+ };
+
+ /* Displays a single channel of waveform data for the given Region.
+
+ x = 0 in the waveview corresponds to the first waveform datum taken
+ from region->start() samples into the source data.
+
+ x = N in the waveview corresponds to the (N * spp)'th sample
+ measured from region->start() into the source data.
+
+ when drawing, we will map the zeroth-pixel of the waveview
+ into a window.
+
+ The waveview itself contains a set of pre-rendered Cairo::ImageSurfaces
+ that cache sections of the display. This is filled on-demand and
+ never cleared until something explicitly marks the cache invalid
+ (such as a change in samples_per_pixel, the log scaling, rectified or
+ other view parameters).
+ */
+
+
WaveView (Group *, boost::shared_ptr<ARDOUR::AudioRegion>);
+ ~WaveView ();
void render (Rect const & area, Cairo::RefPtr<Cairo::Context>) const;
void compute_bounding_box () const;
-
- XMLNode* get_state () const;
- void set_state (XMLNode const *);
-
- void set_frames_per_pixel (double);
+
+ void set_samples_per_pixel (double);
void set_height (Distance);
void set_channel (int);
void set_region_start (ARDOUR::frameoffset_t);
+
+ void set_fill_color (Color);
+ void set_outline_color (Color);
void region_resized ();
-
- /* XXX */
- void rebuild () {}
+ void gain_changed ();
+
+ void set_show_zero_line (bool);
+ bool show_zero_line() const { return _show_zero; }
+ void set_zero_color (Color);
+ void set_clip_color (Color);
+ void set_logscaled (bool);
+ void set_gradient_depth (double);
+ double gradient_depth() const { return _gradient_depth; }
+ void set_shape (Shape);
+
+ /* currently missing because we don't need them (yet):
+ set_shape_independent();
+ set_logscaled_independent()
+ */
+
+ static void set_global_gradient_depth (double);
+ static void set_global_logscaled (bool);
+ static void set_global_shape (Shape);
+ static void set_global_show_waveform_clipping (bool);
+
+ static double global_gradient_depth() { return _global_gradient_depth; }
+ static bool global_logscaled() { return _global_logscaled; }
+ static Shape global_shape() { return _global_shape; }
+
+ void set_amplitude_above_axis (double v);
+ double amplitude_above_axis () const { return _amplitude_above_axis; }
#ifdef CANVAS_COMPATIBILITY
void*& property_gain_src () {
void*& property_gain_function () {
return _foo_void;
}
- bool& property_rectified () {
- return _foo_bool;
- }
- bool& property_logscaled () {
- return _foo_bool;
- }
- double& property_amplitude_above_axis () {
- return _foo_double;
- }
- Color& property_clip_color () {
- return _foo_uint;
- }
- Color& property_zero_color () {
- return _foo_uint;
- }
-
private:
void* _foo_void;
- bool _foo_bool;
- int _foo_int;
- Color _foo_uint;
- double _foo_double;
+
#endif
- class CacheEntry
- {
- public:
- CacheEntry (WaveView const *, int, int);
- ~CacheEntry ();
+ friend class ::WaveViewTest;
- int start () const {
- return _start;
- }
+ void invalidate_image ();
- int end () const {
- return _end;
- }
+ boost::shared_ptr<ARDOUR::AudioRegion> _region;
+ int _channel;
+ double _samples_per_pixel;
+ Coord _height;
+ Color _wave_color;
+ bool _show_zero;
+ Color _zero_color;
+ Color _clip_color;
+ bool _logscaled;
+ Shape _shape;
+ double _gradient_depth;
+ bool _shape_independent;
+ bool _logscaled_independent;
+ bool _gradient_depth_independent;
+ double _amplitude_above_axis;
- ARDOUR::PeakData* peaks () const {
- return _peaks;
- }
+ /** The `start' value to use for the region; we can't use the region's
+ * value as the crossfade editor needs to alter it.
+ */
+ ARDOUR::frameoffset_t _region_start;
+
+
+ mutable ARDOUR::framepos_t _sample_start;
+ mutable ARDOUR::framepos_t _sample_end;
+ mutable Cairo::RefPtr<Cairo::ImageSurface> _image;
- Glib::RefPtr<Gdk::Pixbuf> pixbuf ();
- void clear_pixbuf ();
+ PBD::ScopedConnection invalidation_connection;
- private:
- Coord position (float) const;
-
- WaveView const * _wave_view;
- int _start;
- int _end;
- int _n_peaks;
- ARDOUR::PeakData* _peaks;
- Glib::RefPtr<Gdk::Pixbuf> _pixbuf;
- };
+ static double _global_gradient_depth;
+ static bool _global_logscaled;
+ static Shape _global_shape;
+ static bool _global_show_waveform_clipping;
- friend class CacheEntry;
- friend class ::WaveViewTest;
+ static PBD::Signal0<void> VisualPropertiesChanged;
- void invalidate_whole_cache ();
- void invalidate_pixbuf_cache ();
+ void handle_visual_property_change ();
- boost::shared_ptr<ARDOUR::AudioRegion> _region;
- int _channel;
- double _frames_per_pixel;
- Coord _height;
- Color _wave_color;
- /** The `start' value to use for the region; we can't use the region's
- * value as the crossfade editor needs to alter it.
- */
- ARDOUR::frameoffset_t _region_start;
-
- mutable std::list<CacheEntry*> _cache;
+ void ensure_cache (ARDOUR::framepos_t sample_start, ARDOUR::framepos_t sample_end) const;
+ ArdourCanvas::Coord position (double) const;
+ void draw_image (ARDOUR::PeakData*, int npeaks) const;
};
}