mirror of
https://github.com/obsproject/obs-studio.git
synced 2026-03-27 10:52:16 -04:00
14004cec96
Phase 1 of the plugin manager provides the the ability to toggle off/on plugins loading when OBS starts. Additionally, it implements loading of a manifest file for plugins that allows plugin authors to provide more detailed information about the plugin including authors, support site, name, description. In order to accomplish this, this change updates libobs to provide more detailed tracking of modules- specifically tracking both enabled and disabled modules, alone with a module load state which indicates why a module is not loaded. Additionally, changes were made to establish a links between a module and any features (inputs, outputs, encoders, and services) it provides (and thus the ability to determine why a feature might not be enabled). Along with these changes to modules, this commit also provides an indicator and lookup for core modules which can not be disabled by the plugin manager. Finally, this change provides functions to properly load and retrieve a standardized plugin metadata file.
188 lines
8.2 KiB
C
188 lines
8.2 KiB
C
/******************************************************************************
|
|
Copyright (C) 2023 by Lain Bailey <lain@obsproject.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 "obs.h"
|
|
|
|
#ifdef __cplusplus
|
|
#define MODULE_EXPORT extern "C" EXPORT
|
|
#define MODULE_EXTERN extern "C"
|
|
#else
|
|
#define MODULE_EXPORT EXPORT
|
|
#define MODULE_EXTERN extern
|
|
#endif
|
|
|
|
/**
|
|
* @file
|
|
* @brief This file is used by modules for module declaration and module
|
|
* exports.
|
|
*
|
|
* @page modules_page Modules
|
|
* @brief Modules or plugins are libraries that can be loaded by libobs and
|
|
* subsequently interact with it.
|
|
*
|
|
* @section modules_overview_sec Overview
|
|
*
|
|
* Modules can provide a wide range of functionality to libobs, they for example
|
|
* can feed captured audio or video to libobs, or interface with an encoder to
|
|
* provide some codec to libobs.
|
|
*
|
|
* @section modules_basic_sec Creating a basic module
|
|
*
|
|
* In order to create a module for libobs you will need to build a shared
|
|
* library that implements a basic interface for libobs to interact with.
|
|
* The following code would create a simple source plugin without localization:
|
|
*
|
|
@code
|
|
#include <obs-module.h>
|
|
|
|
OBS_DECLARE_MODULE()
|
|
|
|
extern struct obs_source_info my_source;
|
|
|
|
bool obs_module_load(void)
|
|
{
|
|
obs_register_source(&my_source);
|
|
return true;
|
|
}
|
|
@endcode
|
|
*
|
|
* If you want to enable localization, you will need to also use the
|
|
* @ref OBS_MODULE_USE_DEFAULT_LOCALE() macro.
|
|
*
|
|
* Other module types:
|
|
* - @ref obs_register_encoder()
|
|
* - @ref obs_register_service()
|
|
* - @ref obs_register_output()
|
|
*
|
|
*/
|
|
|
|
/** Required: Declares a libobs module. */
|
|
#define OBS_DECLARE_MODULE() \
|
|
static obs_module_t *obs_module_pointer; \
|
|
MODULE_EXPORT void obs_module_set_pointer(obs_module_t *module); \
|
|
void obs_module_set_pointer(obs_module_t *module) \
|
|
{ \
|
|
obs_module_pointer = module; \
|
|
} \
|
|
obs_module_t *obs_current_module(void) \
|
|
{ \
|
|
return obs_module_pointer; \
|
|
} \
|
|
MODULE_EXPORT uint32_t obs_module_ver(void); \
|
|
uint32_t obs_module_ver(void) \
|
|
{ \
|
|
return LIBOBS_API_VER; \
|
|
}
|
|
|
|
/**
|
|
* Required: Called when the module is loaded. Use this function to load all
|
|
* the sources/encoders/outputs/services for your module, or anything else that
|
|
* may need loading.
|
|
*
|
|
* @return Return true to continue loading the module, otherwise
|
|
* false to indicate failure and unload the module
|
|
*/
|
|
MODULE_EXPORT bool obs_module_load(void);
|
|
|
|
/** Optional: Called when the module is unloaded. */
|
|
MODULE_EXPORT void obs_module_unload(void);
|
|
|
|
/** Optional: Called when all modules have finished loading */
|
|
MODULE_EXPORT void obs_module_post_load(void);
|
|
|
|
/** Called to set the current locale data for the module. */
|
|
MODULE_EXPORT void obs_module_set_locale(const char *locale);
|
|
|
|
/** Called to free the current locale data for the module. */
|
|
MODULE_EXPORT void obs_module_free_locale(void);
|
|
|
|
/** Optional: Use this macro in a module to use default locale handling. */
|
|
#define OBS_MODULE_USE_DEFAULT_LOCALE(module_name, default_locale) \
|
|
lookup_t *obs_module_lookup = NULL; \
|
|
const char *obs_module_text(const char *val) \
|
|
{ \
|
|
const char *out = val; \
|
|
text_lookup_getstr(obs_module_lookup, val, &out); \
|
|
return out; \
|
|
} \
|
|
bool obs_module_get_string(const char *val, const char **out) \
|
|
{ \
|
|
return text_lookup_getstr(obs_module_lookup, val, out); \
|
|
} \
|
|
void obs_module_set_locale(const char *locale) \
|
|
{ \
|
|
if (obs_module_lookup) \
|
|
text_lookup_destroy(obs_module_lookup); \
|
|
obs_module_lookup = obs_module_load_locale(obs_current_module(), default_locale, locale); \
|
|
} \
|
|
void obs_module_free_locale(void) \
|
|
{ \
|
|
text_lookup_destroy(obs_module_lookup); \
|
|
obs_module_lookup = NULL; \
|
|
}
|
|
|
|
/** Helper function for looking up locale if default locale handler was used */
|
|
MODULE_EXTERN const char *obs_module_text(const char *lookup_string);
|
|
|
|
/** Helper function for looking up locale if default locale handler was used,
|
|
* returns true if text found, otherwise false */
|
|
MODULE_EXPORT bool obs_module_get_string(const char *lookup_string, const char **translated_string);
|
|
|
|
/** Helper function that returns the current module */
|
|
MODULE_EXTERN obs_module_t *obs_current_module(void);
|
|
|
|
/**
|
|
* Returns the location to a module data file associated with the current
|
|
* module. Free with bfree when complete. Equivalent to:
|
|
* obs_find_module_file(obs_current_module(), file);
|
|
*/
|
|
#define obs_module_file(file) obs_find_module_file(obs_current_module(), file)
|
|
|
|
/**
|
|
* Returns the location to a module config file associated with the current
|
|
* module. Free with bfree when complete. Will return NULL if configuration
|
|
* directory is not set. Equivalent to:
|
|
* obs_module_get_config_path(obs_current_module(), file);
|
|
*/
|
|
#define obs_module_config_path(file) obs_module_get_config_path(obs_current_module(), file)
|
|
|
|
/**
|
|
* Optional: Declares the author(s) of the module
|
|
*
|
|
* @param name Author name(s)
|
|
*/
|
|
#define OBS_MODULE_AUTHOR(name) \
|
|
MODULE_EXPORT const char *obs_module_author(void); \
|
|
const char *obs_module_author(void) \
|
|
{ \
|
|
return name; \
|
|
}
|
|
|
|
/** Optional: Returns the full name of the module */
|
|
MODULE_EXPORT const char *obs_module_name(void);
|
|
|
|
/** Optional: Returns a description of the module */
|
|
MODULE_EXPORT const char *obs_module_description(void);
|
|
|
|
/** Returns the module's unique ID, or null if it doesn't have one */
|
|
MODULE_EXPORT const char *obs_get_module_id(obs_module_t *module);
|
|
|
|
/** Returns the module's semver verison number or null if it doesn't have one */
|
|
MODULE_EXPORT const char *obs_get_module_version(obs_module_t *module);
|