X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fcanvas%2Fwave_view.cc;h=3467672b88accf5d04700b432cf4c47dd8ccfcd8;hb=fa22520fd257f166c00615e7e40ec10c9e29b948;hp=6e190ee71aac0de2b657f0f6c1767aa26488b80a;hpb=27c943f1ddca0890ac2e5547b249334e0266c0a5;p=ardour.git diff --git a/libs/canvas/wave_view.cc b/libs/canvas/wave_view.cc index 6e190ee71a..3467672b88 100644 --- a/libs/canvas/wave_view.cc +++ b/libs/canvas/wave_view.cc @@ -44,6 +44,7 @@ using namespace ArdourCanvas; double WaveView::_global_gradient_depth = 0.6; bool WaveView::_global_logscaled = false; WaveView::Shape WaveView::_global_shape = WaveView::Normal; +bool WaveView::_global_show_waveform_clipping = true; PBD::Signal0 WaveView::VisualPropertiesChanged; @@ -67,15 +68,14 @@ WaveView::WaveView (Group* parent, boost::shared_ptr region , _gradient_depth_independent (false) , _amplitude_above_axis (1.0) , _region_start (region->start()) - , _cache (0) + , _sample_start (-1) + , _sample_end (-1) { VisualPropertiesChanged.connect_same_thread (invalidation_connection, boost::bind (&WaveView::handle_visual_property_change, this)); } WaveView::~WaveView () { - delete _cache; - _cache = 0; } void @@ -99,7 +99,7 @@ WaveView::handle_visual_property_change () } if (changed) { - invalidate_image_cache (); + invalidate_image (); } } @@ -107,7 +107,7 @@ void WaveView::set_fill_color (Color c) { if (c != _fill_color) { - invalidate_image_cache (); + invalidate_image (); Fill::set_fill_color (c); } } @@ -116,7 +116,7 @@ void WaveView::set_outline_color (Color c) { if (c != _outline_color) { - invalidate_image_cache (); + invalidate_image (); Outline::set_outline_color (c); } } @@ -133,7 +133,7 @@ WaveView::set_samples_per_pixel (double samples_per_pixel) end_change (); - invalidate_whole_cache (); + invalidate_image (); } } @@ -149,51 +149,278 @@ window_to_image (double wave_origin, double image_start) return image_start - wave_origin; } +static inline float +_log_meter (float power, double lower_db, double upper_db, double non_linearity) +{ + return (power < lower_db ? 0.0 : pow((power-lower_db)/(upper_db-lower_db), non_linearity)); +} + +static inline float +alt_log_meter (float power) +{ + return _log_meter (power, -192.0, 0.0, 8.0); +} + +struct LineTips { + double top; + double bot; + bool clip_max; + bool clip_min; + + LineTips() : top (0.0), bot (0.0), clip_max (false), clip_min (false) {} +}; + void -WaveView::ensure_cache (framecnt_t start, framecnt_t end, - framepos_t sample_start, framepos_t sample_end) const +WaveView::draw_image (PeakData* _peaks, int n_peaks) const { - if (_cache && _cache->sample_start() <= sample_start && _cache->sample_end() >= sample_end) { - /* cache already covers required range, do nothing */ - return; + _image = Cairo::ImageSurface::create (Cairo::FORMAT_ARGB32, n_peaks, _height); + + Cairo::RefPtr context = Cairo::Context::create (_image); + + boost::scoped_array tips (new LineTips[n_peaks]); + + /* Clip level nominally set to -0.9dBFS to account for inter-sample + interpolation possibly clipping (value may be too low). + + We adjust by the region's own gain (but note: not by any gain + automation or its gain envelope) so that clip indicators are closer + to providing data about on-disk data. This multiplication is + needed because the data we get from AudioRegion::read_peaks() + has been scaled by scale_amplitude() already. + */ + + const double clip_level = 0.98853 * _region->scale_amplitude(); + + if (_shape == WaveView::Rectified) { + + /* each peak is a line from the bottom of the waveview + * to a point determined by max (_peaks[i].max, + * _peaks[i].min) + */ + + if (_logscaled) { + for (int i = 0; i < n_peaks; ++i) { + tips[i].bot = height(); + tips[i].top = position (alt_log_meter (fast_coefficient_to_dB (max (fabs (_peaks[i].max), fabs (_peaks[i].min))))); + + if (fabs (_peaks[i].max) >= clip_level) { + tips[i].clip_max = true; + } + + if (fabs (_peaks[i].min) >= clip_level) { + tips[i].clip_min = true; + } + } + } else {for (int i = 0; i < n_peaks; ++i) { + tips[i].bot = height(); + tips[i].top = position (max (fabs (_peaks[i].max), fabs (_peaks[i].min))); + + if (fabs (_peaks[i].max) >= clip_level) { + tips[i].clip_max = true; + } + + if (fabs (_peaks[i].min) >= clip_level) { + tips[i].clip_min = true; + } + } + } + + } else { + + if (_logscaled) { + for (int i = 0; i < n_peaks; ++i) { + Coord top = _peaks[i].min; + Coord bot = _peaks[i].max; + + if (fabs (top) >= clip_level) { + tips[i].clip_max = true; + } + + if (fabs (bot) >= clip_level) { + tips[i].clip_min = true; + } + + if (top > 0.0) { + top = position (alt_log_meter (fast_coefficient_to_dB (top))); + } else if (top < 0.0) { + top = position (-alt_log_meter (fast_coefficient_to_dB (-top))); + } else { + top = position (0.0); + } + + if (bot > 0.0) { + bot = position (alt_log_meter (fast_coefficient_to_dB (bot))); + } else if (bot < 0.0) { + bot = position (-alt_log_meter (fast_coefficient_to_dB (-bot))); + } else { + bot = position (0.0); + } + + tips[i].top = top; + tips[i].bot = bot; + } + + } else { + for (int i = 0; i < n_peaks; ++i) { + + if (fabs (_peaks[i].max) >= clip_level) { + tips[i].clip_max = true; + } + + if (fabs (_peaks[i].min) >= clip_level) { + tips[i].clip_min = true; + } + + tips[i].top = position (_peaks[i].min); + tips[i].bot = position (_peaks[i].max); + + + } + } + } + + if (gradient_depth() != 0.0) { + + Cairo::RefPtr gradient (Cairo::LinearGradient::create (0, 0, 0, _height)); + + double stops[3]; + + double r, g, b, a; + + if (_shape == Rectified) { + stops[0] = 0.1; + stops[0] = 0.3; + stops[0] = 0.9; + } else { + stops[0] = 0.1; + stops[1] = 0.5; + stops[2] = 0.9; + } + + color_to_rgba (_fill_color, r, g, b, a); + gradient->add_color_stop_rgba (stops[0], r, g, b, a); + gradient->add_color_stop_rgba (stops[2], r, g, b, a); + + /* generate a new color for the middle of the gradient */ + double h, s, v; + color_to_hsv (_fill_color, h, s, v); + /* change v towards white */ + v *= 1.0 - gradient_depth(); + Color center = hsv_to_color (h, s, v, a); + color_to_rgba (center, r, g, b, a); + gradient->add_color_stop_rgba (stops[1], r, g, b, a); + + context->set_source (gradient); + } else { + set_source_rgba (context, _fill_color); + } + + /* ensure single-pixel lines */ + + context->set_line_width (0.5); + context->translate (0.5, 0.0); + + /* draw the lines */ + + if (_shape == WaveView::Rectified) { + for (int i = 0; i < n_peaks; ++i) { + context->move_to (i, tips[i].top); /* down 1 pixel */ + context->line_to (i, tips[i].bot); + context->stroke (); + } + } else { + for (int i = 0; i < n_peaks; ++i) { + context->move_to (i, tips[i].top); + context->line_to (i, tips[i].bot); + context->stroke (); + } + } + + /* now add dots to the top and bottom of each line (this is + * modelled on pyramix, except that we add clipping indicators. + */ + + if (_global_show_waveform_clipping) { + + context->set_source_rgba (0, 0, 0, 1.0); + + /* the height of the clip-indicator should be at most 7 pixels, + or 5% of the height of the waveview item. + */ + const double clip_height = min (7.0, ceil (_height * 0.05)); + + for (int i = 0; i < n_peaks; ++i) { + context->move_to (i, tips[i].top); + + bool show_top_clip = (_shape == WaveView::Rectified && (tips[i].clip_max || tips[i].clip_min)) || + tips[i].clip_max; + + if (show_top_clip) { + context->set_source_rgba (1.0, 0, 0, 1.0); + context->rel_line_to (0, clip_height); + context->stroke (); + context->set_source_rgba (0.0, 0, 0, 1.0); + } else { + context->rel_line_to (0, 1.0); + context->stroke (); + } + + if (_shape != WaveView::Rectified) { + context->move_to (i, tips[i].bot); + if (tips[i].clip_min) { + context->set_source_rgba (1.0, 0, 0, 1.0); + context->rel_line_to (0, -clip_height); + context->stroke (); + context->set_source_rgba (0.0, 0, 0, 1.0); + } else { + context->rel_line_to (0, -1.0); + context->stroke (); + } + } + } + } + + if (show_zero_line()) { + set_source_rgba (context, _zero_color); + context->move_to (0, position (0.0)); + context->line_to (n_peaks, position (0.0)); + context->stroke (); } +} - if (_cache) { - delete _cache; - _cache = 0; +void +WaveView::ensure_cache (framepos_t start, framepos_t end) const +{ + if (_image && _sample_start <= start && _sample_end >= end) { + /* cache already covers required range, do nothing */ + return; } /* sample position is canonical here, and we want to generate * an image that spans about twice the canvas width */ - const framepos_t center = sample_start + ((sample_end - sample_start) / 2); + const framepos_t center = start + ((end - start) / 2); const framecnt_t canvas_samples = 2 * (_canvas->visible_area().width() * _samples_per_pixel); /* we can request data from anywhere in the Source, between 0 and its length */ - sample_start = max ((framepos_t) 0, (center - canvas_samples)); - sample_end = min (center + canvas_samples, _region->source_length (0)); - - if (sample_end <= sample_start) { - cerr << "sample start = " << sample_start << endl; - cerr << "center+ = " << center<< endl; - cerr << "CS = " << canvas_samples << endl; - cerr << "pui = " << center + canvas_samples << endl; - cerr << "sl = " << _region->source_length (0) << endl; - cerr << "st = " << _region->start () << endl; - cerr << "END: " << sample_end << endl; - assert (false); - } - - start = floor (sample_start / (double) _samples_per_pixel); - end = ceil (sample_end / (double) _samples_per_pixel); - - assert (end > start); + _sample_start = max ((framepos_t) 0, (center - canvas_samples)); + _sample_end = min (center + canvas_samples, _region->source_length (0)); + + double pixel_start = floor (_sample_start / (double) _samples_per_pixel); + double pixel_end = ceil (_sample_end / (double) _samples_per_pixel); + int n_peaks = llrintf (pixel_end - pixel_start); + + boost::scoped_array peaks (new PeakData[n_peaks]); - cerr << name << " cache miss - new CE, span " << start << " .. " << end << " (" << sample_start << " .. " << sample_end << ")\n"; - _cache = new CacheEntry (this, start, end, sample_start, sample_end); + _region->read_peaks (peaks.get(), n_peaks, + _sample_start, _sample_end - _sample_start, + _channel, + _samples_per_pixel); + + draw_image (peaks.get(), n_peaks); } void @@ -214,20 +441,57 @@ WaveView::render (Rect const & area, Cairo::RefPtr context) cons Rect draw = d.get(); - /* pixel coordinates - we round up and down in case we were asked to - * draw "between" pixels at the start and/or end + /* window coordinates - pixels where x=0 is the left edge of the canvas + * window. We round up and down in case we were asked to + * draw "between" pixels at the start and/or end. */ - double draw_start = floor (draw.x0); - double draw_end = ceil (draw.x1); + + const double draw_start = floor (draw.x0); + const double draw_end = ceil (draw.x1); + + // cerr << "Need to draw " << draw_start << " .. " << draw_end << endl; + + /* image coordnates: pixels where x=0 is the start of this waveview, + * wherever it may be positioned. thus image_start=N means "an image + * that beings N pixels after the start of region that this waveview is + * representing. + */ + + const framepos_t image_start = window_to_image (self.x0, draw_start); + const framepos_t image_end = window_to_image (self.x0, draw_end); + + // cerr << "Image/WV space: " << image_start << " .. " << image_end << endl; /* sample coordinates - note, these are not subject to rounding error */ - framepos_t sample_start = _region_start + (draw_start * _samples_per_pixel); - framepos_t sample_end = _region_start + (draw_end * _samples_per_pixel); + framepos_t sample_start = _region_start + (image_start * _samples_per_pixel); + framepos_t sample_end = _region_start + (image_end * _samples_per_pixel); + + // cerr << "Sample space: " << sample_start << " .. " << sample_end << endl; + + ensure_cache (sample_start, sample_end); + + // cerr << "Cache contains " << _cache->pixel_start() << " .. " << _cache->pixel_end() << " / " + // << _cache->sample_start() << " .. " << _cache->sample_end() + // << endl; - ensure_cache (draw_start, draw_end, sample_start, sample_end); + double image_offset = (_sample_start - _region->start()) / _samples_per_pixel; + + // cerr << "Offset into image to place at zero: " << image_offset << endl; context->rectangle (draw_start, draw.y0, draw_end - draw_start, draw.height()); - context->set_source (_cache->image(), self.x0 + _cache->pixel_start(), self.y0); + + /* round image origin position to an exact pixel in device space to + * avoid blurring + */ + + double x = self.x0 + image_offset; + double y = self.y0; + context->user_to_device (x, y); + x = round (x); + y = round (y); + context->device_to_user (x, y); + + context->set_source (_image, x, y); context->fill (); } @@ -254,7 +518,7 @@ WaveView::set_height (Distance height) _bounding_box_dirty = true; end_change (); - invalidate_image_cache (); + invalidate_image (); } } @@ -269,38 +533,36 @@ WaveView::set_channel (int channel) _bounding_box_dirty = true; end_change (); - invalidate_whole_cache (); + invalidate_image (); } } void -WaveView::invalidate_whole_cache () +WaveView::invalidate_image () { begin_visual_change (); - delete _cache; - _cache = 0; + + _image.clear (); + _sample_start = -1; + _sample_end = -1; + end_visual_change (); } -void -WaveView::invalidate_image_cache () -{ - invalidate_whole_cache (); -} void WaveView::set_logscaled (bool yn) { if (_logscaled != yn) { _logscaled = yn; - invalidate_image_cache (); + invalidate_image (); } } void WaveView::gain_changed () { - invalidate_whole_cache (); + invalidate_image (); } void @@ -308,7 +570,7 @@ WaveView::set_zero_color (Color c) { if (_zero_color != c) { _zero_color = c; - invalidate_image_cache (); + invalidate_image (); } } @@ -317,7 +579,7 @@ WaveView::set_clip_color (Color c) { if (_clip_color != c) { _clip_color = c; - invalidate_image_cache (); + invalidate_image (); } } @@ -326,7 +588,7 @@ WaveView::set_show_zero_line (bool yn) { if (_show_zero != yn) { _show_zero = yn; - invalidate_image_cache (); + invalidate_image (); } } @@ -335,7 +597,7 @@ WaveView::set_shape (Shape s) { if (_shape != s) { _shape = s; - invalidate_image_cache (); + invalidate_image (); } } @@ -344,7 +606,7 @@ WaveView::set_amplitude_above_axis (double a) { if (_amplitude_above_axis != a) { _amplitude_above_axis = a; - invalidate_image_cache (); + invalidate_image (); } } @@ -363,7 +625,6 @@ WaveView::set_global_logscaled (bool yn) if (_global_logscaled != yn) { _global_logscaled = yn; VisualPropertiesChanged (); /* EMIT SIGNAL */ - } } @@ -382,219 +643,32 @@ WaveView::region_resized () _pre_change_bounding_box = _bounding_box; - frameoffset_t s = _region->start(); - - if (s != _region_start) { - /* if the region start changes, the information we have - in the image cache is out of date and not useful - since it will fragmented into little pieces. invalidate - the cache. - */ - _region_start = _region->start(); - invalidate_whole_cache (); - } - _bounding_box_dirty = true; compute_bounding_box (); end_change (); } -WaveView::CacheEntry::CacheEntry (WaveView const * wave_view, double pixel_start, double pixel_end, - framepos_t sample_start,framepos_t sample_end) - : _wave_view (wave_view) - , _pixel_start (pixel_start) - , _pixel_end (pixel_end) - , _sample_start (sample_start) - , _sample_end (sample_end) - , _n_peaks (_pixel_end - _pixel_start) -{ - _peaks.reset (new PeakData[_n_peaks]); - - _wave_view->_region->read_peaks (_peaks.get(), _n_peaks, - _sample_start, _sample_end - _sample_start, - _wave_view->_channel, - _wave_view->_samples_per_pixel); -} - -WaveView::CacheEntry::~CacheEntry () -{ -} - -static inline float -_log_meter (float power, double lower_db, double upper_db, double non_linearity) -{ - return (power < lower_db ? 0.0 : pow((power-lower_db)/(upper_db-lower_db), non_linearity)); -} - -static inline float -alt_log_meter (float power) -{ - return _log_meter (power, -192.0, 0.0, 8.0); -} - -Cairo::RefPtr -WaveView::CacheEntry::image () +Coord +WaveView::position (double s) const { - if (!_image) { - - _image = Cairo::ImageSurface::create (Cairo::FORMAT_ARGB32, _n_peaks, _wave_view->_height); - Cairo::RefPtr context = Cairo::Context::create (_image); - - /* Draw the edge of the waveform, top half first, the loop back - * for the bottom half to create a clockwise path - */ - - context->begin_new_path(); - - if (_wave_view->_shape == WaveView::Rectified) { - - /* top edge of waveform is based on max (fabs (peak_min, peak_max)) - */ - - if (_wave_view->_logscaled) { - for (int i = 0; i < _n_peaks; ++i) { - context->line_to (i + 0.5, position (alt_log_meter (fast_coefficient_to_dB ( - max (fabs (_peaks[i].max), fabs (_peaks[i].min)))))); - } - } else { - for (int i = 0; i < _n_peaks; ++i) { - context->line_to (i + 0.5, position (max (fabs (_peaks[i].max), fabs (_peaks[i].min)))); - } - } - - } else { - if (_wave_view->_logscaled) { - for (int i = 0; i < _n_peaks; ++i) { - Coord y = _peaks[i].max; - - if (y > 0.0) { - y = position (alt_log_meter (fast_coefficient_to_dB (y))); - } else if (y < 0.0) { - y = position (-alt_log_meter (fast_coefficient_to_dB (-y))); - } else { - y = position (0.0); - } - context->line_to (i + 0.5, y); - } - } else { - for (int i = 0; i < _n_peaks; ++i) { - context->line_to (i + 0.5, position (_peaks[i].max)); - } - } - } - - /* from final top point, move out of the clip zone */ - - context->line_to (_n_peaks + 10, position (0.0)); - - /* bottom half, in reverse */ - - if (_wave_view->_shape == WaveView::Rectified) { - - /* lower half: drop to the bottom, then a line back to - * beyond the left edge of the clip region - */ - - context->line_to (_n_peaks + 10, _wave_view->_height); - context->line_to (-10.0, _wave_view->_height); - - } else { - - if (_wave_view->_logscaled) { - for (int i = _n_peaks-1; i >= 0; --i) { - Coord y = _peaks[i].min; - if (y > 0.0) { - context->line_to (i + 0.5, position (alt_log_meter (fast_coefficient_to_dB (y)))); - } else if (y < 0.0) { - context->line_to (i + 0.5, position (-alt_log_meter (fast_coefficient_to_dB (-y)))); - } else { - context->line_to (i + 0.5, position (0.0)); - } - } - } else { - for (int i = _n_peaks-1; i >= 0; --i) { - context->line_to (i + 0.5, position (_peaks[i].min)); - } - } - - /* from final bottom point, move out of the clip zone */ - - context->line_to (-10.0, position (0.0)); - } - - context->close_path (); - - if (_wave_view->gradient_depth() != 0.0) { - - Cairo::RefPtr gradient (Cairo::LinearGradient::create (0, 0, 0, _wave_view->_height)); - - double stops[3]; - - double r, g, b, a; - - if (_wave_view->_shape == Rectified) { - stops[0] = 0.1; - stops[0] = 0.3; - stops[0] = 0.9; - } else { - stops[0] = 0.1; - stops[1] = 0.5; - stops[2] = 0.9; - } - - color_to_rgba (_wave_view->_fill_color, r, g, b, a); - gradient->add_color_stop_rgba (stops[0], r, g, b, a); - gradient->add_color_stop_rgba (stops[2], r, g, b, a); - - /* generate a new color for the middle of the gradient */ - double h, s, v; - color_to_hsv (_wave_view->_fill_color, h, s, v); - /* tone down the saturation */ - s *= 1.0 - _wave_view->gradient_depth(); - Color center = hsv_to_color (h, s, v, a); - color_to_rgba (center, r, g, b, a); - gradient->add_color_stop_rgba (stops[1], r, g, b, a); - - context->set_source (gradient); - } else { - set_source_rgba (context, _wave_view->_fill_color); - } - - context->fill_preserve (); - _wave_view->setup_outline_context (context); - context->stroke (); - - if (_wave_view->show_zero_line()) { - set_source_rgba (context, _wave_view->_zero_color); - context->move_to (0, position (0.0)); - context->line_to (_n_peaks, position (0.0)); - context->stroke (); - } - } - - return _image; -} + /* it is important that this returns an integral value, so that we + can ensure correct single pixel behaviour. + */ + Coord pos; -Coord -WaveView::CacheEntry::position (double s) const -{ - switch (_wave_view->_shape) { + switch (_shape) { case Rectified: - return _wave_view->_height - (s * _wave_view->_height); + pos = floor (_height - (s * _height)); default: + pos = floor ((1.0-s) * (_height / 2.0)); break; } - return (1.0-s) * (_wave_view->_height / 2.0); -} -void -WaveView::CacheEntry::clear_image () -{ - _image.clear (); + return min (_height, (max (0.0, pos))); } - + void WaveView::set_global_gradient_depth (double depth) { @@ -603,3 +677,13 @@ WaveView::set_global_gradient_depth (double depth) VisualPropertiesChanged (); /* EMIT SIGNAL */ } } + +void +WaveView::set_global_show_waveform_clipping (bool yn) +{ + if (_global_show_waveform_clipping != yn) { + _global_show_waveform_clipping = yn; + VisualPropertiesChanged (); /* EMIT SIGNAL */ + } +} +