wave_view.h

Go to the documentation of this file.

/*
 * Copyright (C) 2017 Paul Davis <paul@linuxaudiosystems.com>
 * Copyright (C) 2017 Robin Gareus <robin@gareus.org>
 * Copyright (C) 2017 Tim Mayberry <mojofunk@gmail.com>
 *
 * 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.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#ifndef _WAVEVIEW_WAVE_VIEW_H_
#define _WAVEVIEW_WAVE_VIEW_H_
 
#include <memory>
 
#include <glibmm/refptr.h>
 
#include "ardour/types.h"
#include "canvas/item.h"
#include "waveview/visibility.h"
 
namespace ARDOUR {
        class AudioRegion;
}
 
namespace Gdk {
        class Pixbuf;
}
 
namespace ArdourWaveView {
 
class WaveViewCacheGroup;
class WaveViewDrawRequest;
class WaveViewDrawRequestQueue;
class WaveViewImage;
class WaveViewProperties;
class WaveViewDrawingThread;
 
class LIBWAVEVIEW_API WaveView : public ArdourCanvas::Item, public sigc::trackable
{
public:
        enum Shape { Normal, Rectified };
 
        std::string debug_name () const;
 
        /* 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 (ArdourCanvas::Canvas*, std::shared_ptr<ARDOUR::AudioRegion>);
        WaveView (Item*, std::shared_ptr<ARDOUR::AudioRegion>);
        ~WaveView ();
 
        void prepare_for_render (ArdourCanvas::Rect const& window_area) const;
        bool needs_prepare_for_render () const { return true; }
 
        void render (ArdourCanvas::Rect const & area, Cairo::RefPtr<Cairo::Context>) const;
 
        void compute_bounding_box () const;
 
        void set_samples_per_pixel (double);
        void set_height (ArdourCanvas::Distance);
        void set_channel (int);
        void set_region_start (ARDOUR::sampleoffset_t);
 
        void set_start_shift (double pixels);
 
        void set_fill_color (Gtkmm2ext::Color);
        void set_outline_color (Gtkmm2ext::Color);
 
        void region_resized ();
        void gain_changed ();
 
        void set_show_zero_line (bool);
        bool show_zero_line () const;
 
        void set_zero_color (Gtkmm2ext::Color);
        void set_clip_color (Gtkmm2ext::Color);
        void set_logscaled (bool);
 
        void set_gradient_depth (double);
        double gradient_depth () const;
 
        void set_shape (Shape);
 
        void set_always_get_image_in_thread (bool yn);
 
        /* 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 void clear_cache ();
 
        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;
 
        static void set_clip_level (double dB);
        static PBD::Signal<void()> ClipLevelChanged;
 
        static void start_drawing_thread ();
        static void stop_drawing_thread ();
 
        static void set_image_cache_size (uint64_t);
 
private:
        friend class WaveViewThreadClient;
        friend class WaveViewThreads;
 
        std::shared_ptr<ARDOUR::AudioRegion> _region;
 
        const std::unique_ptr<WaveViewProperties> _props;
 
        mutable std::shared_ptr<WaveViewImage> _image;
 
        mutable std::shared_ptr<WaveViewCacheGroup> _cache_group;
 
        bool _shape_independent;
        bool _logscaled_independent;
        bool _gradient_depth_independent;
 
        ARDOUR::samplecnt_t region_length () const;
 
        ARDOUR::samplepos_t region_end () const;
 
        bool rendered () const { return _image.get(); }
 
        bool draw_image_in_gui_thread () const;
 
        mutable bool _draw_image_in_gui_thread;
 
        bool _always_draw_image_in_gui_thread;
 
        void init();
 
        mutable std::shared_ptr<WaveViewDrawRequest> current_request;
 
        PBD::ScopedConnectionList invalidation_connection;
 
        static double _global_gradient_depth;
        static bool _global_logscaled;
        static Shape _global_shape;
        static bool _global_show_waveform_clipping;
        static double _global_clip_level;
 
        static PBD::Signal<void()> VisualPropertiesChanged;
 
        void handle_visual_property_change ();
        void handle_clip_level_change ();
 
        struct LineTips {
                double top;
                double bot;
                double spread;
                bool clip_max;
                bool clip_min;
 
                LineTips () : top (0.0), bot (0.0), clip_max (false), clip_min (false) {}
        };
 
        static ArdourCanvas::Coord y_extent (double, Shape const, double const height);
 
        static void compute_tips (ARDOUR::PeakData const& peak, LineTips& tips, double const effective_height);
 
        static void draw_image (Cairo::RefPtr<Cairo::ImageSurface>&, ARDOUR::PeakData*, int n_peaks,
                                std::shared_ptr<WaveViewDrawRequest>);
        static void draw_absent_image (Cairo::RefPtr<Cairo::ImageSurface>&, ARDOUR::PeakData*, int);
 
        ARDOUR::samplecnt_t optimal_image_width_samples () const;
 
        void set_image (std::shared_ptr<WaveViewImage> img) const;
 
        // @return true if item area intersects with draw area
        bool get_item_and_draw_rect_in_window_coords (ArdourCanvas::Rect const& canvas_rect,
                                                      ArdourCanvas::Rect& item_area,
                                                      ArdourCanvas::Rect& draw_rect) const;
 
        std::shared_ptr<WaveViewDrawRequest> create_draw_request (WaveViewProperties const&) const;
 
        void queue_draw_request (std::shared_ptr<WaveViewDrawRequest> const&) const;
 
        static void process_draw_request (std::shared_ptr<WaveViewDrawRequest>);
 
        std::shared_ptr<WaveViewCacheGroup> get_cache_group () const;
 
        void reset_cache_group ();
};
 
} /* namespace */
 
#endif