mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-09-20 21:13:04 +02:00
3d6d43225f
- Add planar audio support. FFmpeg and libav use planar audio for many encoders, so it was somewhat necessary to add support in libobs itself. - Improve/adjust FFmpeg test output plugin. The exports were somewhat messed up (making me rethink how exports should be done). Not yet functional; it handles video properly, but it still does not handle audio properly. - Improve planar video code. The planar video code was not properly accounting for row sizes for each plane. Specifying row sizes for each plane has now been added. This will also make it more compatible with FFmpeg/libav. - Fixed a bug where callbacks wouldn't create properly in audio-io and video-io code. - Implement 'blogva' function to allow for va_list usage with libobs logging.
188 lines
4.7 KiB
C
188 lines
4.7 KiB
C
/******************************************************************************
|
|
Copyright (C) 2013 by Hugh Bailey <obs.jim@gmail.com>
|
|
|
|
This program 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.
|
|
|
|
This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
******************************************************************************/
|
|
|
|
#pragma once
|
|
|
|
#include "../util/c99defs.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*
|
|
* Base audio output component. Use this to create an audio output track
|
|
* for the media.
|
|
*/
|
|
|
|
#define MAX_AUDIO_PLANES 8
|
|
|
|
struct audio_output;
|
|
struct audio_line;
|
|
typedef struct audio_output *audio_t;
|
|
typedef struct audio_line *audio_line_t;
|
|
|
|
enum audio_format {
|
|
AUDIO_FORMAT_UNKNOWN,
|
|
|
|
AUDIO_FORMAT_U8BIT,
|
|
AUDIO_FORMAT_16BIT,
|
|
AUDIO_FORMAT_32BIT,
|
|
AUDIO_FORMAT_FLOAT,
|
|
|
|
AUDIO_FORMAT_U8BIT_PLANAR,
|
|
AUDIO_FORMAT_16BIT_PLANAR,
|
|
AUDIO_FORMAT_32BIT_PLANAR,
|
|
AUDIO_FORMAT_FLOAT_PLANAR,
|
|
};
|
|
|
|
enum speaker_layout {
|
|
SPEAKERS_UNKNOWN,
|
|
SPEAKERS_MONO,
|
|
SPEAKERS_STEREO,
|
|
SPEAKERS_2POINT1,
|
|
SPEAKERS_QUAD,
|
|
SPEAKERS_4POINT1,
|
|
SPEAKERS_5POINT1,
|
|
SPEAKERS_5POINT1_SURROUND,
|
|
SPEAKERS_7POINT1,
|
|
SPEAKERS_7POINT1_SURROUND,
|
|
SPEAKERS_SURROUND,
|
|
};
|
|
|
|
struct audio_data {
|
|
const uint8_t *data[MAX_AUDIO_PLANES];
|
|
uint32_t frames;
|
|
uint64_t timestamp;
|
|
float volume;
|
|
};
|
|
|
|
struct audio_output_info {
|
|
const char *name;
|
|
|
|
uint32_t samples_per_sec;
|
|
enum audio_format format;
|
|
enum speaker_layout speakers;
|
|
uint64_t buffer_ms;
|
|
};
|
|
|
|
struct audio_convert_info {
|
|
uint32_t samples_per_sec;
|
|
enum audio_format format;
|
|
enum speaker_layout speakers;
|
|
};
|
|
|
|
static inline uint32_t get_audio_channels(enum speaker_layout speakers)
|
|
{
|
|
switch (speakers) {
|
|
case SPEAKERS_MONO: return 1;
|
|
case SPEAKERS_STEREO: return 2;
|
|
case SPEAKERS_2POINT1: return 3;
|
|
case SPEAKERS_SURROUND:
|
|
case SPEAKERS_QUAD: return 4;
|
|
case SPEAKERS_4POINT1: return 5;
|
|
case SPEAKERS_5POINT1:
|
|
case SPEAKERS_5POINT1_SURROUND: return 6;
|
|
case SPEAKERS_7POINT1: return 8;
|
|
case SPEAKERS_7POINT1_SURROUND: return 8;
|
|
case SPEAKERS_UNKNOWN: return 0;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
static inline size_t get_audio_bytes_per_channel(enum audio_format type)
|
|
{
|
|
switch (type) {
|
|
case AUDIO_FORMAT_U8BIT:
|
|
case AUDIO_FORMAT_U8BIT_PLANAR:
|
|
return 1;
|
|
|
|
case AUDIO_FORMAT_16BIT:
|
|
case AUDIO_FORMAT_16BIT_PLANAR:
|
|
return 2;
|
|
|
|
case AUDIO_FORMAT_FLOAT:
|
|
case AUDIO_FORMAT_FLOAT_PLANAR:
|
|
case AUDIO_FORMAT_32BIT:
|
|
case AUDIO_FORMAT_32BIT_PLANAR:
|
|
return 4;
|
|
|
|
case AUDIO_FORMAT_UNKNOWN:
|
|
return 0;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
static inline size_t is_audio_planar(enum audio_format type)
|
|
{
|
|
switch (type) {
|
|
case AUDIO_FORMAT_U8BIT:
|
|
case AUDIO_FORMAT_16BIT:
|
|
case AUDIO_FORMAT_32BIT:
|
|
case AUDIO_FORMAT_FLOAT:
|
|
return false;
|
|
|
|
case AUDIO_FORMAT_U8BIT_PLANAR:
|
|
case AUDIO_FORMAT_FLOAT_PLANAR:
|
|
case AUDIO_FORMAT_16BIT_PLANAR:
|
|
case AUDIO_FORMAT_32BIT_PLANAR:
|
|
return true;
|
|
|
|
case AUDIO_FORMAT_UNKNOWN:
|
|
return false;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
static inline size_t get_audio_size(enum audio_format type,
|
|
enum speaker_layout speakers, uint32_t frames)
|
|
{
|
|
return get_audio_channels(speakers) *
|
|
get_audio_bytes_per_channel(type) *
|
|
frames;
|
|
}
|
|
|
|
#define AUDIO_OUTPUT_SUCCESS 0
|
|
#define AUDIO_OUTPUT_INVALIDPARAM -1
|
|
#define AUDIO_OUTPUT_FAIL -2
|
|
|
|
EXPORT int audio_output_open(audio_t *audio, struct audio_output_info *info);
|
|
EXPORT void audio_output_close(audio_t audio);
|
|
|
|
EXPORT void audio_output_connect(audio_t video,
|
|
struct audio_convert_info *conversion,
|
|
void (*callback)(void *param, const struct audio_data *data),
|
|
void *param);
|
|
EXPORT void audio_output_disconnect(audio_t video,
|
|
void (*callback)(void *param, const struct audio_data *data),
|
|
void *param);
|
|
|
|
EXPORT size_t audio_output_blocksize(audio_t audio);
|
|
EXPORT size_t audio_output_planes(audio_t audio);
|
|
EXPORT size_t audio_output_channels(audio_t audio);
|
|
EXPORT const struct audio_output_info *audio_output_getinfo(audio_t audio);
|
|
|
|
EXPORT audio_line_t audio_output_createline(audio_t audio, const char *name);
|
|
EXPORT void audio_line_destroy(audio_line_t line);
|
|
EXPORT void audio_line_output(audio_line_t line, const struct audio_data *data);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|