git.sesse.net Git - casparcg/blob - core/mixer/audio/audio_mixer.cpp

   1 /*
   2 * Copyright (c) 2011 Sveriges Television AB <info@casparcg.com>
   3 *
   4 * This file is part of CasparCG (www.casparcg.com).
   5 *
   6 * CasparCG is free software: you can redistribute it and/or modify
   7 * it under the terms of the GNU General Public License as published by
   8 * the Free Software Foundation, either version 3 of the License, or
   9 * (at your option) any later version.
  10 *
  11 * CasparCG is distributed in the hope that it will be useful,
  12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 * GNU General Public License for more details.
  15 *
  16 * You should have received a copy of the GNU General Public License
  17 * along with CasparCG. If not, see <http://www.gnu.org/licenses/>.
  18 *
  19 * Author: Robert Nagy, ronag89@gmail.com
  20 */
  21
  22 #include "../../StdAfx.h"
  23
  24 #include "audio_mixer.h"
  25
  26 #include <core/frame/frame.h>
  27 #include <core/frame/frame_transform.h>
  28 #include <core/frame/audio_channel_layout.h>
  29 #include <core/monitor/monitor.h>
  30
  31 #include <common/diagnostics/graph.h>
  32 #include <common/linq.h>
  33
  34 #include <boost/range/adaptors.hpp>
  35 #include <boost/range/distance.hpp>
  36 #include <boost/lexical_cast.hpp>
  37
  38 #include <map>
  39 #include <stack>
  40 #include <vector>
  41
  42 namespace caspar { namespace core {
  43
  44 struct audio_item
  45 {
  46         const void*                             tag                             = nullptr;
  47         audio_transform                 transform;
  48         audio_buffer                    audio_data;
  49         audio_channel_layout    channel_layout  = audio_channel_layout::invalid();
  50
  51         audio_item()
  52         {
  53         }
  54
  55         audio_item(audio_item&& other)
  56                 : tag(std::move(other.tag))
  57                 , transform(std::move(other.transform))
  58                 , audio_data(std::move(other.audio_data))
  59                 , channel_layout(std::move(other.channel_layout))
  60         {
  61         }
  62 };
  63
  64 typedef cache_aligned_vector<double> audio_buffer_ps;
  65
  66 struct audio_stream
  67 {
  68         audio_transform                                                 prev_transform;
  69         audio_buffer_ps                                                 audio_data;
  70         std::unique_ptr<audio_channel_remapper> channel_remapper;
  71         bool                                                                    remapping_failed        = false;
  72         bool                                                                    is_still                        = false;
  73 };
  74
  75 struct audio_mixer::impl : boost::noncopyable
  76 {
  77         monitor::subject                                        monitor_subject_                { "/audio" };
  78         std::stack<core::audio_transform>       transform_stack_;
  79         std::map<const void*, audio_stream>     audio_streams_;
  80         std::vector<audio_item>                         items_;
  81         std::vector<int>                                        audio_cadence_;
  82         video_format_desc                                       format_desc_;
  83         audio_channel_layout                            channel_layout_                 = audio_channel_layout::invalid();
  84         float                                                           master_volume_                  = 1.0f;
  85         float                                                           previous_master_volume_ = master_volume_;
  86         spl::shared_ptr<diagnostics::graph>     graph_;
  87 public:
  88         impl(spl::shared_ptr<diagnostics::graph> graph)
  89                 : graph_(std::move(graph))
  90         {
  91                 graph_->set_color("volume", diagnostics::color(1.0f, 0.8f, 0.1f));
  92                 graph_->set_color("audio-clipping", diagnostics::color(0.3f, 0.6f, 0.3f));
  93                 transform_stack_.push(core::audio_transform());
  94         }
  95
  96         void push(const frame_transform& transform)
  97         {
  98                 transform_stack_.push(transform_stack_.top()*transform.audio_transform);
  99         }
 100
 101         void visit(const const_frame& frame)
 102         {
 103                 if(transform_stack_.top().volume < 0.002 || frame.audio_data().empty())
 104                         return;
 105
 106                 audio_item item;
 107                 item.tag                        = frame.stream_tag();
 108                 item.transform          = transform_stack_.top();
 109                 item.audio_data         = frame.audio_data();
 110                 item.channel_layout = frame.audio_channel_layout();
 111
 112                 if(item.transform.is_still)
 113                         item.transform.volume = 0.0;
 114
 115                 items_.push_back(std::move(item));
 116         }
 117
 118         void begin(const core::audio_transform& transform)
 119         {
 120                 transform_stack_.push(transform_stack_.top()*transform);
 121         }
 122
 123         void pop()
 124         {
 125                 transform_stack_.pop();
 126         }
 127
 128         void set_master_volume(float volume)
 129         {
 130                 master_volume_ = volume;
 131         }
 132
 133         float get_master_volume()
 134         {
 135                 return master_volume_;
 136         }
 137
 138         audio_buffer mix(const video_format_desc& format_desc, const audio_channel_layout& channel_layout)
 139         {
 140                 if(format_desc_ != format_desc || channel_layout_ != channel_layout)
 141                 {
 142                         audio_streams_.clear();
 143                         audio_cadence_ = format_desc.audio_cadence;
 144                         format_desc_ = format_desc;
 145                         channel_layout_ = channel_layout;
 146                 }
 147
 148                 std::map<const void*, audio_stream>     next_audio_streams;
 149                 std::vector<const void*> used_tags;
 150
 151                 for (auto& item : items_)
 152                 {
 153                         audio_buffer_ps next_audio;
 154                         std::unique_ptr<audio_channel_remapper> channel_remapper;
 155                         bool remapping_failed = false;
 156
 157                         auto next_transform = item.transform;
 158                         auto prev_transform = next_transform;
 159
 160                         auto tag = item.tag;
 161
 162                         if(boost::range::find(used_tags, tag) != used_tags.end())
 163                                 continue;
 164
 165                         used_tags.push_back(tag);
 166
 167                         const auto it = audio_streams_.find(tag);
 168                         if (it != audio_streams_.end())
 169                         {
 170                                 prev_transform = it->second.prev_transform;
 171                                 next_audio = std::move(it->second.audio_data);
 172                                 channel_remapper = std::move(it->second.channel_remapper);
 173                                 remapping_failed = it->second.remapping_failed;
 174                         }
 175
 176                         if (remapping_failed)
 177                         {
 178                                 CASPAR_LOG(trace) << "[audio_mixer] audio channel remapping already failed for stream.";
 179                                 next_audio_streams[tag].remapping_failed = true;
 180                                 continue;
 181                         }
 182
 183                         // Skip it if there is no existing audio stream and item has no audio-data.
 184                         if(it == audio_streams_.end() && item.audio_data.empty())
 185                                 continue;
 186
 187                         if (item.channel_layout == audio_channel_layout::invalid())
 188                         {
 189                                 CASPAR_LOG(warning) << "[audio_mixer] invalid audio channel layout for item";
 190                                 next_audio_streams[tag].remapping_failed = true;
 191                                 continue;
 192                         }
 193
 194                         if (!channel_remapper)
 195                         {
 196                                 try
 197                                 {
 198                                         channel_remapper.reset(new audio_channel_remapper(item.channel_layout, channel_layout_));
 199                                 }
 200                                 catch (...)
 201                                 {
 202                                         CASPAR_LOG_CURRENT_EXCEPTION();
 203                                         CASPAR_LOG(error) << "[audio_mixer] audio channel remapping failed for stream.";
 204                                         next_audio_streams[tag].remapping_failed = true;
 205                                         continue;
 206                                 }
 207                         }
 208
 209                         item.audio_data = channel_remapper->mix_and_rearrange(item.audio_data);
 210
 211                         const double prev_volume = prev_transform.volume * previous_master_volume_;
 212                         const double next_volume = next_transform.volume * master_volume_;
 213
 214                         // TODO: Move volume mixing into code below, in order to support audio sample counts not corresponding to frame audio samples.
 215                         auto alpha = (next_volume-prev_volume)/static_cast<double>(item.audio_data.size()/channel_layout_.num_channels);
 216
 217                         for(size_t n = 0; n < item.audio_data.size(); ++n)
 218                         {
 219                                 auto sample_multiplier = (prev_volume + (n / channel_layout_.num_channels) * alpha);
 220                                 next_audio.push_back(item.audio_data.data()[n] * sample_multiplier);
 221                         }
 222
 223                         next_audio_streams[tag].prev_transform          = std::move(next_transform); // Store all active tags, inactive tags will be removed at the end.
 224                         next_audio_streams[tag].audio_data                      = std::move(next_audio);
 225                         next_audio_streams[tag].channel_remapper        = std::move(channel_remapper);
 226                         next_audio_streams[tag].remapping_failed        = remapping_failed;
 227                         next_audio_streams[tag].is_still                        = item.transform.is_still;
 228                 }
 229
 230                 previous_master_volume_ = master_volume_;
 231                 items_.clear();
 232
 233                 audio_streams_ = std::move(next_audio_streams);
 234
 235                 if(audio_streams_.empty())
 236                         audio_streams_[nullptr].audio_data = audio_buffer_ps(audio_size(audio_cadence_.front()), 0.0);
 237
 238                 { // sanity check
 239
 240                         auto nb_invalid_streams = cpplinq::from(audio_streams_)
 241                                 .select(values())
 242                                 .where([&](const audio_stream& x)
 243                                 {
 244                                         return !x.remapping_failed && x.audio_data.size() < audio_size(audio_cadence_.front());
 245                                 })
 246                                 .count();
 247
 248                         if(nb_invalid_streams > 0)
 249                                 CASPAR_LOG(trace) << "[audio_mixer] Incorrect frame audio cadence detected.";
 250                 }
 251
 252                 audio_buffer_ps result_ps(audio_size(audio_cadence_.front()), 0.0);
 253                 for (auto& stream : audio_streams_ | boost::adaptors::map_values)
 254                 {
 255                         if (stream.audio_data.size() < result_ps.size())
 256                         {
 257                                 auto samples = (result_ps.size() - stream.audio_data.size()) / channel_layout_.num_channels;
 258                                 CASPAR_LOG(trace) << L"[audio_mixer] Appended " << samples << L" zero samples";
 259                                 CASPAR_LOG(trace) << L"[audio_mixer] Actual number of samples " << stream.audio_data.size() / channel_layout_.num_channels;
 260                                 CASPAR_LOG(trace) << L"[audio_mixer] Wanted number of samples " << result_ps.size() / channel_layout_.num_channels;
 261                                 stream.audio_data.resize(result_ps.size(), 0.0);
 262                         }
 263
 264                         auto out = boost::range::transform(result_ps, stream.audio_data, std::begin(result_ps), std::plus<double>());
 265                         stream.audio_data.erase(std::begin(stream.audio_data), std::begin(stream.audio_data) + std::distance(std::begin(result_ps), out));
 266                 }
 267
 268                 boost::range::rotate(audio_cadence_, std::begin(audio_cadence_)+1);
 269
 270                 auto result_owner = spl::make_shared<mutable_audio_buffer>();
 271                 auto& result = *result_owner;
 272                 result.reserve(result_ps.size());
 273                 const int32_t min_amplitude = std::numeric_limits<int32_t>::min();
 274                 const int32_t max_amplitude = std::numeric_limits<int32_t>::max();
 275                 bool clipping = false;
 276                 boost::range::transform(result_ps, std::back_inserter(result), [&](double sample)
 277                 {
 278                         if (sample > max_amplitude)
 279                         {
 280                                 clipping = true;
 281                                 return max_amplitude;
 282                         }
 283                         else if (sample < min_amplitude)
 284                         {
 285                                 clipping = true;
 286                                 return min_amplitude;
 287                         }
 288                         else
 289                                 return static_cast<int32_t>(sample);
 290                 });
 291
 292                 if (clipping)
 293                         graph_->set_tag(diagnostics::tag_severity::WARNING, "audio-clipping");
 294
 295                 const int num_channels = channel_layout_.num_channels;
 296                 monitor_subject_ << monitor::message("/nb_channels") % num_channels;
 297
 298                 auto max = std::vector<int32_t>(num_channels, std::numeric_limits<int32_t>::min());
 299
 300                 for (size_t n = 0; n < result.size(); n += num_channels)
 301                         for (int ch = 0; ch < num_channels; ++ch)
 302                                 max[ch] = std::max(max[ch], std::abs(result[n + ch]));
 303
 304                 // Makes the dBFS of silence => -dynamic range of 32bit LPCM => about -192 dBFS
 305                 // Otherwise it would be -infinity
 306                 static const auto MIN_PFS = 0.5f / static_cast<float>(std::numeric_limits<int32_t>::max());
 307
 308                 for (int i = 0; i < num_channels; ++i)
 309                 {
 310                         const auto pFS = max[i] / static_cast<float>(std::numeric_limits<int32_t>::max());
 311                         const auto dBFS = 20.0f * std::log10(std::max(MIN_PFS, pFS));
 312
 313                         auto chan_str = boost::lexical_cast<std::string>(i + 1);
 314
 315                         monitor_subject_ << monitor::message("/" + chan_str + "/pFS") % pFS;
 316                         monitor_subject_ << monitor::message("/" + chan_str + "/dBFS") % dBFS;
 317                 }
 318
 319                 graph_->set_value("volume", static_cast<double>(*boost::max_element(max)) / std::numeric_limits<int32_t>::max());
 320
 321                 return caspar::array<int32_t>(result.data(), result.size(), true, std::move(result_owner));
 322         }
 323
 324         size_t audio_size(size_t num_samples) const
 325         {
 326                 return num_samples * channel_layout_.num_channels;
 327         }
 328 };
 329
 330 audio_mixer::audio_mixer(spl::shared_ptr<diagnostics::graph> graph) : impl_(new impl(std::move(graph))){}
 331 void audio_mixer::push(const frame_transform& transform){impl_->push(transform);}
 332 void audio_mixer::visit(const const_frame& frame){impl_->visit(frame);}
 333 void audio_mixer::pop(){impl_->pop();}
 334 void audio_mixer::set_master_volume(float volume) { impl_->set_master_volume(volume); }
 335 float audio_mixer::get_master_volume() { return impl_->get_master_volume(); }
 336 audio_buffer audio_mixer::operator()(const video_format_desc& format_desc, const audio_channel_layout& channel_layout){ return impl_->mix(format_desc, channel_layout); }
 337 monitor::subject& audio_mixer::monitor_output(){ return impl_->monitor_subject_; }
 338
 339 }}