/* Copyright (C) 2013-2021 Carl Hetherington This file is part of DCP-o-matic. DCP-o-matic 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. DCP-o-matic 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 DCP-o-matic. If not, see . */ /** @file src/wx/audio_mapping_view.cc * @brief AudioMappingView class and helpers. */ #include "audio_gain_dialog.h" #include "audio_mapping_view.h" #include "id.h" #include "wx_util.h" #include "lib/audio_mapping.h" #include "lib/maths_util.h" #include #include #include LIBDCP_DISABLE_WARNINGS #include #include #include #include LIBDCP_ENABLE_WARNINGS using std::list; using std::make_pair; using std::max; using std::min; using std::pair; using std::shared_ptr; using std::string; using std::vector; using boost::optional; #if BOOST_VERSION >= 106100 using namespace boost::placeholders; #endif using dcp::locale_convert; static constexpr auto INDICATOR_SIZE = 20; static constexpr auto ROW_HEIGHT = 32; static constexpr auto MINIMUM_COLUMN_WIDTH = 32; static constexpr auto TOP_HEIGHT = ROW_HEIGHT * 2; static constexpr auto COLUMN_PADDING = 16; enum { ID_off = DCPOMATIC_AUDIO_GAIN_MENU, ID_minus6dB, ID_0dB, ID_plus3dB, ID_edit, ID_all_off }; AudioMappingView::AudioMappingView(wxWindow* parent, wxString left_label, wxString from, wxString top_label, wxString to) : wxPanel(parent, wxID_ANY) , _menu_input(0) , _menu_output(1) , _left_label(left_label) , _from(from) , _top_label(top_label) , _to(to) { _menu = new wxMenu; _menu->Append(ID_off, _("Off")); _menu->Append(ID_minus6dB, _("-6dB")); _menu->Append(ID_0dB, _("0dB (unchanged)")); _menu->Append(ID_plus3dB, _("+3dB")); _menu->Append(ID_edit, _("Edit...")); _menu->AppendSeparator(); _menu->Append(ID_all_off, _("All off")); #ifndef __WXOSX__ SetDoubleBuffered(true); #endif Bind(wxEVT_MENU, boost::bind(&AudioMappingView::set_gain_from_menu, this, 0), ID_off); Bind(wxEVT_MENU, boost::bind(&AudioMappingView::set_gain_from_menu, this, db_to_linear(-6)), ID_minus6dB); Bind(wxEVT_MENU, boost::bind(&AudioMappingView::set_gain_from_menu, this, 1), ID_0dB); Bind(wxEVT_MENU, boost::bind(&AudioMappingView::set_gain_from_menu, this, db_to_linear(3)), ID_plus3dB); Bind(wxEVT_MENU, boost::bind(&AudioMappingView::all_off, this), ID_all_off); Bind(wxEVT_MENU, boost::bind(&AudioMappingView::edit, this), ID_edit); Bind(wxEVT_PAINT, boost::bind(&AudioMappingView::paint, this)); Bind(wxEVT_LEFT_DOWN, boost::bind(&AudioMappingView::left_down, this, _1)); Bind(wxEVT_RIGHT_DOWN, boost::bind(&AudioMappingView::right_down, this, _1)); Bind(wxEVT_MOTION, boost::bind(&AudioMappingView::motion, this, _1)); } void AudioMappingView::all_off() { _map.make_zero(); map_values_changed(); } void AudioMappingView::setup() { wxClientDC dc(GetParent()); dc.SetFont(wxSWISS_FONT->Bold()); _column_widths.clear(); _column_widths.reserve(_output_channels.size()); _column_widths_total = 0; for (auto const& i: _output_channels) { wxCoord width; wxCoord height; dc.GetTextExtent(std_to_wx(i.name), &width, &height); auto const this_width = max(width + COLUMN_PADDING, MINIMUM_COLUMN_WIDTH); _column_widths.push_back(this_width); _column_widths_total += this_width; } SetMinSize({8 + left_width() + _column_widths_total, static_cast(8 + TOP_HEIGHT + ROW_HEIGHT * _input_channels.size())}); } void AudioMappingView::paint_static(wxDC& dc) { dc.SetFont(wxSWISS_FONT->Bold()); wxCoord label_width; wxCoord label_height; dc.GetTextExtent(_top_label, &label_width, &label_height); dc.DrawText(_top_label, left_width() +(_column_widths_total - label_width) / 2,(ROW_HEIGHT - label_height) / 2); dc.GetTextExtent(_left_label, &label_width, &label_height); dc.DrawRotatedText( _left_label, (ROW_HEIGHT - label_height) / 2, TOP_HEIGHT +(_input_channels.size() * ROW_HEIGHT + label_width) / 2, 90 ); dc.SetFont(*wxSWISS_FONT); } void AudioMappingView::paint_column_labels(wxDC& dc) { wxCoord label_width; wxCoord label_height; int x = left_width(); for (auto i = 0U; i < _output_channels.size(); ++i) { auto const name = std_to_wx(_output_channels[i].name); dc.GetTextExtent(name, &label_width, &label_height); dc.DrawText(name, x +(_column_widths[i] - label_width) / 2, ROW_HEIGHT + (ROW_HEIGHT - label_height) / 2); x += _column_widths[i]; } dc.DrawLine(wxPoint(left_width(), ROW_HEIGHT), wxPoint(left_width() + _column_widths_total, ROW_HEIGHT)); dc.DrawLine(wxPoint(left_width(), ROW_HEIGHT * 2), wxPoint(left_width() + _column_widths_total, ROW_HEIGHT * 2)); } void AudioMappingView::paint_column_lines(wxDC& dc) { int x = left_width(); for (size_t i = 0; i < _output_channels.size(); ++i) { dc.DrawLine( wxPoint(x, ROW_HEIGHT), wxPoint(x, TOP_HEIGHT + _input_channels.size() * ROW_HEIGHT) ); x += _column_widths[i]; } dc.DrawLine( wxPoint(left_width() + _column_widths_total, ROW_HEIGHT), wxPoint(left_width() + _column_widths_total, TOP_HEIGHT + _input_channels.size() * ROW_HEIGHT) ); } void AudioMappingView::paint_row_labels(wxDC& dc) { wxCoord label_width; wxCoord label_height; /* Row channel labels */ for (auto i = 0U; i < _input_channels.size(); ++i) { auto const name = std_to_wx(_input_channels[i].name); dc.GetTextExtent(name, &label_width, &label_height); dc.DrawText(name, left_width() - MINIMUM_COLUMN_WIDTH + (MINIMUM_COLUMN_WIDTH - label_width) / 2, TOP_HEIGHT + ROW_HEIGHT * i + (ROW_HEIGHT - label_height) / 2); } /* Vertical lines on the left */ for (int i = 1; i < 3; ++i) { dc.DrawLine( wxPoint(MINIMUM_COLUMN_WIDTH * i, TOP_HEIGHT), wxPoint(MINIMUM_COLUMN_WIDTH * i, TOP_HEIGHT + _input_channels.size() * ROW_HEIGHT) ); } int y = TOP_HEIGHT; for (auto const& i: _input_groups) { dc.DrawLine(wxPoint(MINIMUM_COLUMN_WIDTH, y), wxPoint(MINIMUM_COLUMN_WIDTH * 2, y)); y += (i.to - i.from + 1) * ROW_HEIGHT; } dc.DrawLine(wxPoint(MINIMUM_COLUMN_WIDTH, y), wxPoint(MINIMUM_COLUMN_WIDTH * 2, y)); if (_input_groups.empty()) { auto const bottom = TOP_HEIGHT + _input_channels.size() * ROW_HEIGHT; dc.DrawLine(wxPoint(MINIMUM_COLUMN_WIDTH, bottom), wxPoint(MINIMUM_COLUMN_WIDTH * 2, bottom)); } /* Group labels and lines; be careful here as wxDCClipper does not restore the old * clipping rectangle after it is destroyed */ y = TOP_HEIGHT; for (auto const& i: _input_groups) { int const height = (i.to - i.from + 1) * ROW_HEIGHT; dc.GetTextExtent(std_to_wx(i.name), &label_width, &label_height); if (label_width > height) { label_width = height - 8; } { wxDCClipper clip(dc, wxRect(MINIMUM_COLUMN_WIDTH, y, ROW_HEIGHT, height)); int yp = y; if ((yp - 2 * ROW_HEIGHT) < dc.GetLogicalOrigin().y) { yp += dc.GetLogicalOrigin().y; } dc.DrawRotatedText( std_to_wx(i.name), ROW_HEIGHT + (ROW_HEIGHT - label_height) / 2, y + (height + label_width) / 2, 90 ); } y += height; } } void AudioMappingView::paint_row_lines(wxDC& dc) { for (size_t i = 0; i < _input_channels.size() + 1; ++i) { dc.DrawLine( wxPoint(MINIMUM_COLUMN_WIDTH * 2, TOP_HEIGHT + ROW_HEIGHT * i), wxPoint(left_width() + _column_widths_total, TOP_HEIGHT + ROW_HEIGHT * i) ); } } void AudioMappingView::paint_indicators(wxDC& dc) { /* _{input,output}_channels and _map may not always be in sync, be careful here */ size_t const output = min(_output_channels.size(), size_t(_map.output_channels())); size_t const input = min(_input_channels.size(), size_t(_map.input_channels())); int xp = left_width(); for (size_t x = 0; x < output; ++x) { for (size_t y = 0; y < input; ++y) { dc.SetBrush(*wxWHITE_BRUSH); dc.DrawRectangle( wxRect( xp + (_column_widths[x] - INDICATOR_SIZE) / 2, TOP_HEIGHT + y * ROW_HEIGHT + (ROW_HEIGHT - INDICATOR_SIZE) / 2, INDICATOR_SIZE, INDICATOR_SIZE ) ); float const value_dB = linear_to_db(_map.get(_input_channels[y].index, _output_channels[x].index)); auto const colour = value_dB <= 0 ? wxColour(0, 255, 0) : wxColour(255, 150, 0); int const range = 18; int height = 0; if (value_dB > -range) { height = min(INDICATOR_SIZE, static_cast(INDICATOR_SIZE * (1 + value_dB / range))); } dc.SetBrush(*wxTheBrushList->FindOrCreateBrush(colour, wxBRUSHSTYLE_SOLID)); dc.DrawRectangle( wxRect( xp + (_column_widths[x] - INDICATOR_SIZE) / 2, TOP_HEIGHT + y * ROW_HEIGHT + (ROW_HEIGHT - INDICATOR_SIZE) / 2 + INDICATOR_SIZE - height, INDICATOR_SIZE, height ) ); } xp += _column_widths[x]; } } static void restore(wxDC& dc) { dc.SetLogicalOrigin(0, 0); dc.DestroyClippingRegion(); } void AudioMappingView::paint() { wxPaintDC dc(this); paint_static(dc); dc.SetClippingRegion( left_width(), 0, _column_widths_total, ROW_HEIGHT * (2 + _input_channels.size()) ); paint_column_labels(dc); restore(dc); dc.SetClippingRegion( 0, TOP_HEIGHT, left_width(), min(int(ROW_HEIGHT * _input_channels.size()), GetSize().GetHeight() - TOP_HEIGHT) + 1 ); paint_row_labels(dc); restore(dc); dc.SetClippingRegion( MINIMUM_COLUMN_WIDTH * 2, TOP_HEIGHT, MINIMUM_COLUMN_WIDTH + _column_widths_total, min(int(ROW_HEIGHT * (2 + _input_channels.size())), GetSize().GetHeight() - TOP_HEIGHT) ); paint_row_lines(dc); restore(dc); dc.SetClippingRegion( left_width(), MINIMUM_COLUMN_WIDTH, MINIMUM_COLUMN_WIDTH + _column_widths_total, min(int(ROW_HEIGHT * (1 + _input_channels.size())), GetSize().GetHeight() - ROW_HEIGHT) ); paint_column_lines(dc); restore(dc); dc.SetClippingRegion( left_width(), TOP_HEIGHT, _column_widths_total, min(int(ROW_HEIGHT * _input_channels.size()), GetSize().GetHeight() - TOP_HEIGHT) ); paint_indicators(dc); restore(dc); } optional> AudioMappingView::mouse_event_to_channels(wxMouseEvent& ev) const { int x = ev.GetX(); int const y = ev.GetY(); if (x <= left_width() || y < TOP_HEIGHT) { return {}; } int const input = (y - TOP_HEIGHT) / ROW_HEIGHT; x -= left_width(); int output = 0; for (auto const i: _column_widths) { x -= i; if (x < 0) { break; } ++output; } if (input >= int(_input_channels.size()) || output >= int(_output_channels.size())) { return {}; } return make_pair(_input_channels[input], _output_channels[output]); } optional AudioMappingView::mouse_event_to_input_group_name(wxMouseEvent& ev) const { int const x = ev.GetX(); if (x < MINIMUM_COLUMN_WIDTH || x > (2 * MINIMUM_COLUMN_WIDTH)) { return {}; } int const y = (ev.GetY() - TOP_HEIGHT) / ROW_HEIGHT; for (auto i: _input_groups) { if (i.from <= y && y <= i.to) { return i.name; } } return {}; } void AudioMappingView::left_down(wxMouseEvent& ev) { auto channels = mouse_event_to_channels(ev); if (!channels) { return; } if (_map.get(channels->first.index, channels->second.index) > 0) { _map.set(channels->first.index, channels->second.index, 0); } else { _map.set(channels->first.index, channels->second.index, 1); } map_values_changed(); } void AudioMappingView::right_down(wxMouseEvent& ev) { auto channels = mouse_event_to_channels(ev); if (!channels) { return; } _menu_input = channels->first.index; _menu_output = channels->second.index; PopupMenu(_menu, ev.GetPosition()); } /** Called when any gain value has changed */ void AudioMappingView::map_values_changed() { Changed(_map); _last_tooltip_channels = boost::none; Refresh(); } void AudioMappingView::set_gain_from_menu(double linear) { _map.set(_menu_input, _menu_output, linear); map_values_changed(); } void AudioMappingView::edit() { AudioGainDialog dialog(this, _menu_input, _menu_output, _map.get(_menu_input, _menu_output)); if (dialog.ShowModal() == wxID_OK) { _map.set(_menu_input, _menu_output, dialog.value()); map_values_changed(); } } void AudioMappingView::set(AudioMapping map) { _map = map; Refresh(); } void AudioMappingView::set_input_channels(vector const& channels) { _input_channels = channels; setup(); Refresh(); } void AudioMappingView::set_output_channels(vector const & channels) { _output_channels = channels; setup(); Refresh(); } wxString AudioMappingView::input_channel_name_with_group(NamedChannel const& n) const { optional group; for (auto i: _input_groups) { if (i.from <= n.index && n.index <= i.to) { group = std_to_wx(i.name); } } if (group && !group->IsEmpty()) { return wxString::Format(char_to_wx("%s/%s"), group->data(), std_to_wx(n.name).data()); } return std_to_wx(n.name); } void AudioMappingView::motion(wxMouseEvent& ev) { auto channels = mouse_event_to_channels(ev); if (channels) { if (channels != _last_tooltip_channels) { wxString s; auto const gain = _map.get(channels->first.index, channels->second.index); if (gain == 0) { s = wxString::Format( _("No audio will be passed from %s channel '%s' to %s channel '%s'."), _from, input_channel_name_with_group(channels->first), _to, std_to_wx(channels->second.name) ); } else if (gain == 1) { s = wxString::Format( _("Audio will be passed from %s channel %s to %s channel %s unaltered."), _from, input_channel_name_with_group(channels->first), _to, std_to_wx(channels->second.name) ); } else { auto const dB = linear_to_db(gain); s = wxString::Format( _("Audio will be passed from %s channel %s to %s channel %s with gain %.1fdB."), _from, input_channel_name_with_group(channels->first), _to, std_to_wx(channels->second.name), dB ); } SetToolTip(s + char_to_wx(" ") + _("Right click to change gain.")); } } else { auto group = mouse_event_to_input_group_name(ev); if (group) { SetToolTip(std_to_wx(*group)); } else { SetToolTip({}); } } _last_tooltip_channels = channels; ev.Skip(); } void AudioMappingView::set_input_groups(vector const & groups) { _input_groups = groups; } int AudioMappingView::left_width() const { return _input_groups.empty() ? (MINIMUM_COLUMN_WIDTH * 2) : (MINIMUM_COLUMN_WIDTH * 3); } void AudioMappingView::set_top_label(wxString top_label) { _top_label = top_label; Refresh(); }