mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-07-15 07:44:10 +00:00
6da26a3a1c
- Make it so that encoders can be assigned to outputs. If an encoder is destroyed, it will automatically remove itself from that output. I specifically didn't want to do reference counting because it leaves too much potential for unchecked references and it just felt like it would be more trouble than it's worth. - Add a 'flags' value to the output definition structure. This lets the output specify if it uses video/audio, and whether the output is meant to be used with OBS encoders or not. - Remove boilerplate code for outputs. This makes it easier to program outputs. The boilerplate code involved before was mostly just involving connecting to the audio/video data streams directly in each output plugin. Instead of doing that, simply add plugin callback functions for receiving video/audio (either encoded or non-encoded, whichever it's set to use), and then call obs_output_begin_data_capture and obs_output_end_data_capture to automatically handle setting up connections to raw or encoded video/audio streams for the plugin. - Remove 'active' function from output callbacks, as it's no longer really needed now that the libobs output context automatically knows when the output is active or not. - Make it so that an encoder cannot be destroyed until all data connections to the encoder have been removed. - Change the 'start' and 'stop' functions in the encoder interface to just an 'initialize' callback, which initializes the encoder. - Make it so that the encoder must be initialized first before the data stream can be started. The reason why initialization was separated from starting the encoder stream was because we need to be able to check that the settings used with the encoder *can* be used first. This problem was especially annoying if you had both video/audio encoding. Before, you'd have to check the return value from obs_encoder_start, and if that second encoder fails, then you basically had to stop the first encoder again, making for unnecessary boilerplate code whenever starting up two encoders.
261 lines
8.4 KiB
C
261 lines
8.4 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/>.
|
|
******************************************************************************/
|
|
|
|
#include "util/platform.h"
|
|
#include "util/dstr.h"
|
|
|
|
#include "obs-defs.h"
|
|
#include "obs-internal.h"
|
|
#include "obs-module.h"
|
|
|
|
extern char *find_plugin(const char *plugin);
|
|
|
|
/* These variables get the current size of the info structures. Used to
|
|
* automatically prevent API breakage in case functions have to be added */
|
|
static size_t cur_source_info_size = 0;
|
|
static size_t cur_output_info_size = 0;
|
|
static size_t cur_encoder_info_size = 0;
|
|
static size_t cur_service_info_size = 0;
|
|
static size_t cur_modal_ui_size = 0;
|
|
static size_t cur_modeless_ui_size = 0;
|
|
|
|
static inline int req_func_not_found(const char *name, const char *path)
|
|
{
|
|
blog(LOG_ERROR, "Required module function '%s' in module '%s' not "
|
|
"found, loading of module failed",
|
|
name, path);
|
|
return MODULE_FUNCTION_NOT_FOUND;
|
|
}
|
|
|
|
#define LOAD_REQ_SIZE_FUNC(func, module, path) \
|
|
func = os_dlsym(module, #func); \
|
|
if (!func) \
|
|
return req_func_not_found(#func, path)
|
|
|
|
static int call_module_load(void *module, const char *path)
|
|
{
|
|
bool (*obs_module_load)(uint32_t obs_ver) = NULL;
|
|
size_t (*obs_module_source_info_size)(void) = NULL;
|
|
size_t (*obs_module_output_info_size)(void) = NULL;
|
|
size_t (*obs_module_encoder_info_size)(void) = NULL;
|
|
size_t (*obs_module_service_info_size)(void) = NULL;
|
|
size_t (*obs_module_modal_ui_size)(void) = NULL;
|
|
size_t (*obs_module_modeless_ui_size)(void) = NULL;
|
|
|
|
obs_module_load = os_dlsym(module, "obs_module_load");
|
|
if (!obs_module_load)
|
|
return req_func_not_found("obs_module_load", path);
|
|
|
|
LOAD_REQ_SIZE_FUNC(obs_module_source_info_size, module, path);
|
|
LOAD_REQ_SIZE_FUNC(obs_module_output_info_size, module, path);
|
|
LOAD_REQ_SIZE_FUNC(obs_module_encoder_info_size, module, path);
|
|
LOAD_REQ_SIZE_FUNC(obs_module_service_info_size, module, path);
|
|
LOAD_REQ_SIZE_FUNC(obs_module_modal_ui_size, module, path);
|
|
LOAD_REQ_SIZE_FUNC(obs_module_modeless_ui_size, module, path);
|
|
|
|
cur_source_info_size = obs_module_source_info_size();
|
|
cur_output_info_size = obs_module_output_info_size();
|
|
cur_encoder_info_size = obs_module_encoder_info_size();
|
|
cur_service_info_size = obs_module_service_info_size();
|
|
cur_modal_ui_size = obs_module_modal_ui_size();
|
|
cur_modeless_ui_size = obs_module_modeless_ui_size();
|
|
|
|
if (!obs_module_load(LIBOBS_API_VER)) {
|
|
blog(LOG_ERROR, "Module '%s' failed to load: "
|
|
"obs_module_load failed", path);
|
|
return MODULE_ERROR;
|
|
}
|
|
|
|
cur_source_info_size = 0;
|
|
cur_output_info_size = 0;
|
|
cur_encoder_info_size = 0;
|
|
cur_service_info_size = 0;
|
|
cur_modal_ui_size = 0;
|
|
cur_modeless_ui_size = 0;
|
|
|
|
return MODULE_SUCCESS;
|
|
}
|
|
|
|
int obs_load_module(const char *path)
|
|
{
|
|
struct obs_module mod;
|
|
char *plugin_path = find_plugin(path);
|
|
int errorcode;
|
|
|
|
mod.module = os_dlopen(plugin_path);
|
|
bfree(plugin_path);
|
|
if (!mod.module)
|
|
return MODULE_FILE_NOT_FOUND;
|
|
|
|
errorcode = call_module_load(mod.module, path);
|
|
if (errorcode != MODULE_SUCCESS) {
|
|
os_dlclose(mod.module);
|
|
return errorcode;
|
|
}
|
|
|
|
mod.name = bstrdup(path);
|
|
da_push_back(obs->modules, &mod);
|
|
return MODULE_SUCCESS;
|
|
}
|
|
|
|
void free_module(struct obs_module *mod)
|
|
{
|
|
if (!mod)
|
|
return;
|
|
|
|
if (mod->module) {
|
|
void (*module_unload)(void);
|
|
|
|
module_unload = os_dlsym(mod->module, "module_unload");
|
|
if (module_unload)
|
|
module_unload();
|
|
|
|
os_dlclose(mod->module);
|
|
}
|
|
|
|
bfree(mod->name);
|
|
}
|
|
|
|
#define REGISTER_OBS_DEF(size_var, structure, dest, info) \
|
|
do { \
|
|
struct structure data = {0}; \
|
|
if (!size_var) { \
|
|
blog(LOG_ERROR, "Tried to register " #structure \
|
|
" outside of obs_module_load"); \
|
|
return; \
|
|
} \
|
|
\
|
|
memcpy(&data, info, size_var); \
|
|
da_push_back(dest, &data); \
|
|
} while (false)
|
|
|
|
#define CHECK_REQUIRED_VAL(info, val, func) \
|
|
do { \
|
|
if (!info->val) {\
|
|
blog(LOG_ERROR, "Required value '" #val " for" \
|
|
"'%s' not found. " #func \
|
|
" failed.", info->id); \
|
|
return; \
|
|
} \
|
|
} while (false)
|
|
|
|
void obs_register_source(const struct obs_source_info *info)
|
|
{
|
|
struct obs_source_info data = {0};
|
|
struct darray *array;
|
|
|
|
CHECK_REQUIRED_VAL(info, getname, obs_register_source);
|
|
CHECK_REQUIRED_VAL(info, create, obs_register_source);
|
|
CHECK_REQUIRED_VAL(info, destroy, obs_register_source);
|
|
|
|
if (info->type == OBS_SOURCE_TYPE_INPUT &&
|
|
info->output_flags & OBS_SOURCE_VIDEO) {
|
|
CHECK_REQUIRED_VAL(info, getwidth, obs_register_source);
|
|
CHECK_REQUIRED_VAL(info, getheight, obs_register_source);
|
|
}
|
|
|
|
if (!cur_source_info_size) {
|
|
blog(LOG_ERROR, "Tried to register obs_source_info"
|
|
" outside of obs_module_load");
|
|
return;
|
|
}
|
|
|
|
memcpy(&data, info, cur_source_info_size);
|
|
|
|
if (info->type == OBS_SOURCE_TYPE_INPUT) {
|
|
array = &obs->input_types.da;
|
|
} else if (info->type == OBS_SOURCE_TYPE_FILTER) {
|
|
array = &obs->filter_types.da;
|
|
} else if (info->type == OBS_SOURCE_TYPE_TRANSITION) {
|
|
array = &obs->transition_types.da;
|
|
} else {
|
|
blog(LOG_ERROR, "Tried to register unknown source type: %u",
|
|
info->type);
|
|
return;
|
|
}
|
|
|
|
darray_push_back(sizeof(struct obs_source_info), array, &data);
|
|
}
|
|
|
|
void obs_register_output(const struct obs_output_info *info)
|
|
{
|
|
CHECK_REQUIRED_VAL(info, getname, obs_register_output);
|
|
CHECK_REQUIRED_VAL(info, create, obs_register_output);
|
|
CHECK_REQUIRED_VAL(info, destroy, obs_register_output);
|
|
CHECK_REQUIRED_VAL(info, start, obs_register_output);
|
|
CHECK_REQUIRED_VAL(info, stop, obs_register_output);
|
|
|
|
if (info->flags & OBS_OUTPUT_ENCODED) {
|
|
if (info->flags & OBS_OUTPUT_VIDEO)
|
|
CHECK_REQUIRED_VAL(info, encoded_video,
|
|
obs_register_output);
|
|
|
|
if (info->flags & OBS_OUTPUT_AUDIO)
|
|
CHECK_REQUIRED_VAL(info, encoded_audio,
|
|
obs_register_output);
|
|
} else {
|
|
if (info->flags & OBS_OUTPUT_VIDEO)
|
|
CHECK_REQUIRED_VAL(info, raw_video,
|
|
obs_register_output);
|
|
|
|
if (info->flags & OBS_OUTPUT_AUDIO)
|
|
CHECK_REQUIRED_VAL(info, raw_audio,
|
|
obs_register_output);
|
|
}
|
|
|
|
REGISTER_OBS_DEF(cur_output_info_size, obs_output_info,
|
|
obs->output_types, info);
|
|
}
|
|
|
|
void obs_register_encoder(const struct obs_encoder_info *info)
|
|
{
|
|
CHECK_REQUIRED_VAL(info, getname, obs_register_encoder);
|
|
CHECK_REQUIRED_VAL(info, create, obs_register_encoder);
|
|
CHECK_REQUIRED_VAL(info, destroy, obs_register_encoder);
|
|
CHECK_REQUIRED_VAL(info, initialize, obs_register_encoder);
|
|
CHECK_REQUIRED_VAL(info, encode, obs_register_encoder);
|
|
|
|
REGISTER_OBS_DEF(cur_encoder_info_size, obs_encoder_info,
|
|
obs->encoder_types, info);
|
|
}
|
|
|
|
void obs_register_service(const struct obs_service_info *info)
|
|
{
|
|
/* TODO */
|
|
UNUSED_PARAMETER(info);
|
|
}
|
|
|
|
void obs_regsiter_modal_ui(const struct obs_modal_ui *info)
|
|
{
|
|
CHECK_REQUIRED_VAL(info, task, obs_regsiter_modal_ui);
|
|
CHECK_REQUIRED_VAL(info, target, obs_regsiter_modal_ui);
|
|
CHECK_REQUIRED_VAL(info, exec, obs_regsiter_modal_ui);
|
|
|
|
REGISTER_OBS_DEF(cur_modal_ui_size, obs_modal_ui,
|
|
obs->modal_ui_callbacks, info);
|
|
}
|
|
|
|
void obs_regsiter_modeless_ui(const struct obs_modeless_ui *info)
|
|
{
|
|
CHECK_REQUIRED_VAL(info, task, obs_regsiter_modeless_ui);
|
|
CHECK_REQUIRED_VAL(info, target, obs_regsiter_modeless_ui);
|
|
CHECK_REQUIRED_VAL(info, create, obs_regsiter_modeless_ui);
|
|
|
|
REGISTER_OBS_DEF(cur_modeless_ui_size, obs_modeless_ui,
|
|
obs->modeless_ui_callbacks, info);
|
|
}
|