X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fcanvas%2Fcanvas%2Fwave_view.h;h=05bd00f5adea8944fb96a76efdbedd20867d0931;hb=88732abd0177f9ee9f4be780e3ffe724ef798c64;hp=b8c96cb6729006b671a62e8a8d47085a3b83024a;hpb=9a8ee11f6532c73320f76b10aabec68081c9ebf4;p=ardour.git diff --git a/libs/canvas/canvas/wave_view.h b/libs/canvas/canvas/wave_view.h index b8c96cb672..05bd00f5ad 100644 --- a/libs/canvas/canvas/wave_view.h +++ b/libs/canvas/canvas/wave_view.h @@ -1,4 +1,26 @@ +/* + Copyright (C) 2011-2013 Paul Davis + Author: Carl Hetherington + + 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 +#include +#include #include "pbd/properties.h" @@ -25,23 +47,72 @@ 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); + ~WaveView (); void render (Rect const & area, Cairo::RefPtr) 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 () { @@ -50,79 +121,55 @@ public: 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 _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 _image; - Glib::RefPtr 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 _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 VisualPropertiesChanged; - void invalidate_whole_cache (); - void invalidate_pixbuf_cache (); + void handle_visual_property_change (); - boost::shared_ptr _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 _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; }; }