utils.h

Go to the documentation of this file.

 
/*
 * Copyright (c) 2011-2021 CESNET, z. s. p. o.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, is permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of CESNET nor the names of its contributors may be
 *    used to endorse or promote products derived from this software without
 *    specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING,
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
 * EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef _AUDIO_UTILS_H_
#define _AUDIO_UTILS_H_
 
#ifdef __cplusplus
#include <cstdint>
#include <cstddef>
#else
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#endif
 
#include "audio/types.h"
 
#ifdef __cplusplus
double calculate_rms(audio_frame2 *frame, int channel, double *peak);
double calculate_rms(audio_frame *frame, int channel, double *peak);
void audio_channel_demux(const audio_frame2 *, int, audio_channel*);
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
bool audio_desc_eq(struct audio_desc, struct audio_desc);
struct audio_desc audio_desc_from_audio_channel(const audio_channel *);
void audio_frame_write_desc(struct audio_frame *f, struct audio_desc desc);
 
void change_bps(char *out, int out_bps, const char *in, int in_bps, int in_len /* bytes */);
void change_bps2(char *out, int out_bps, const char *in, int in_bps, int in_len /* bytes */, bool dither);
 
int32_t downshift_with_dither(int32_t val, int shift);
 
void audio_frame_multiply_channel(struct audio_frame *frame, int new_channel_count);
 
/*
 * Extracts out_channel_count of channels from interleaved stream, starting with first_chan
 */
void copy_channel(char *out, const char *in, int bps, int in_len /* bytes */, int out_channel_count);
 
/*
 * Multiplexes channel into interleaved stream
 */
void mux_channel(char *out, const char *in, int bps, int in_len, int out_stream_channels, int chan_pos_stream, double scale);
void demux_channel(char *out, char *in, int bps, int in_len, int in_stream_channels, int pos_in_stream);
void remux_channel(char *out, const char *in, int bps, int in_len, int in_stream_channels, int out_stream_channels, int pos_in_stream, int pos_out_stream);
 
void interleaved2noninterleaved(char *out, const char *in, int bps, int in_len /* bytes */, int channel_count);
void interleaved2noninterleaved2(char **out, const char *in, int bps,
                                 int in_len /* bytes */, int channel_count);
void interleaved2noninterleaved_float(char **out, const char *in, int in_bps,
                                 int in_len /* bytes */, int channel_count);
 
/*
 * Additional function that allosw mixing channels
 *
 * @return avareage volume
 */
void mux_and_mix_channel(char *out, const char *in, int bps, int in_len, int out_stream_channels, int chan_pos_stream, double scale);
void remux_and_mix_channel(char *out, const char *in, int bps, int frames, int in_stream_channels, int out_stream_channels, int in_channel, int out_channel, double scale);
double get_avg_volume(char *data, int bps, int in_len, int stream_channels, int chan_pos_stream);
 
void float2int(char *out, const char *in, int len);
void int2float(char *out, const char *in, int len);
 
void signed2unsigned(char *out, const char *in, int in_len);
 
struct audio_desc audio_desc_from_frame(const struct audio_frame *frame);
const char *audio_desc_to_cstring(struct audio_desc desc);
 
#if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
#define STORE_I32_SAMPLE(ptr, val, out_bps) \
        memcpy((ptr), ((const char *) &(val)) + 4 - (out_bps), (out_bps))
#else
#define STORE_I32_SAMPLE(ptr, val, out_bps) memcpy((ptr), &(val), (out_bps))
#endif
 
bool append_audio_frame(struct audio_frame *frame, char *data, size_t data_len);
 
struct audio_frame *audio_frame_copy(const struct audio_frame *src, bool keep_size);
 
int parse_audio_format(const char *str, struct audio_desc *ret);
 
#ifdef __cplusplus
struct channel_map {
        ~channel_map();
 
        int **map = nullptr; // index is source channel, content is output channels
        int *sizes = nullptr;
        int *contributors = nullptr; // count of contributing channels to output
        int size = 0;
        int max_output = -1;
 
        bool validate();
        void compute_contributors();
};
 
bool parse_channel_map_cfg(struct channel_map *channel_map, const char *cfg);
 
void format_audio_channel_volume(int chan_idx, double rms, double peak,
                                 const char *format_color, char **volume_start,
                                 char *volume_end);
 
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif