use of int16_t/uint16_t. This is the upshot of a recommendation by henrik.lundin and kwiberg on an original small change ( https://webrtc-codereview.appspot.com/42569004/#ps1 ) to stop using int16_t just because values could fit in it, and is similar in nature to a previous "mass change to use size_t more" ( https://webrtc-codereview.appspot.com/23129004/ ) which also needed to be split up for review but to land all at once, since, like adding "const", such changes tend to cause a lot of transitive effects. This was be reviewed and approved in pieces: https://codereview.webrtc.org/1224093003 https://codereview.webrtc.org/1224123002 https://codereview.webrtc.org/1224163002 https://codereview.webrtc.org/1225133003 https://codereview.webrtc.org/1225173002 https://codereview.webrtc.org/1227163003 https://codereview.webrtc.org/1227203003 https://codereview.webrtc.org/1227213002 https://codereview.webrtc.org/1227893002 https://codereview.webrtc.org/1228793004 https://codereview.webrtc.org/1228803003 https://codereview.webrtc.org/1228823002 https://codereview.webrtc.org/1228823003 https://codereview.webrtc.org/1228843002 https://codereview.webrtc.org/1230693002 https://codereview.webrtc.org/1231713002 The change is being landed as TBR to all the folks who reviewed the above. BUG=chromium:81439 TEST=none R=andrew@webrtc.org, pbos@webrtc.org TBR=aluebs, andrew, asapersson, henrika, hlundin, jan.skoglund, kwiberg, minyue, pbos, pthatcher Review URL: https://codereview.webrtc.org/1230503003 . Cr-Commit-Position: refs/heads/master@{#9768}
59 lines
2.2 KiB
C++
59 lines
2.2 KiB
C++
/*
|
|
* Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef WEBRTC_VOICE_ENGINE_AUDIO_FRAME_OPERATIONS_H_
|
|
#define WEBRTC_VOICE_ENGINE_AUDIO_FRAME_OPERATIONS_H_
|
|
|
|
#include "webrtc/typedefs.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class AudioFrame;
|
|
|
|
// TODO(andrew): consolidate this with utility.h and audio_frame_manipulator.h.
|
|
// Change reference parameters to pointers. Consider using a namespace rather
|
|
// than a class.
|
|
class AudioFrameOperations {
|
|
public:
|
|
// Upmixes mono |src_audio| to stereo |dst_audio|. This is an out-of-place
|
|
// operation, meaning src_audio and dst_audio must point to different
|
|
// buffers. It is the caller's responsibility to ensure that |dst_audio| is
|
|
// sufficiently large.
|
|
static void MonoToStereo(const int16_t* src_audio, size_t samples_per_channel,
|
|
int16_t* dst_audio);
|
|
// |frame.num_channels_| will be updated. This version checks for sufficient
|
|
// buffer size and that |num_channels_| is mono.
|
|
static int MonoToStereo(AudioFrame* frame);
|
|
|
|
// Downmixes stereo |src_audio| to mono |dst_audio|. This is an in-place
|
|
// operation, meaning |src_audio| and |dst_audio| may point to the same
|
|
// buffer.
|
|
static void StereoToMono(const int16_t* src_audio, size_t samples_per_channel,
|
|
int16_t* dst_audio);
|
|
// |frame.num_channels_| will be updated. This version checks that
|
|
// |num_channels_| is stereo.
|
|
static int StereoToMono(AudioFrame* frame);
|
|
|
|
// Swap the left and right channels of |frame|. Fails silently if |frame| is
|
|
// not stereo.
|
|
static void SwapStereoChannels(AudioFrame* frame);
|
|
|
|
// Zeros out the audio and sets |frame.energy| to zero.
|
|
static void Mute(AudioFrame& frame);
|
|
|
|
static int Scale(float left, float right, AudioFrame& frame);
|
|
|
|
static int ScaleWithSat(float scale, AudioFrame& frame);
|
|
};
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // #ifndef WEBRTC_VOICE_ENGINE_AUDIO_FRAME_OPERATIONS_H_
|